1. 项目概述：用树莓派和Wiimote打造一台真正的复古光枪

如果你和我一样，是个对《打鸭子》（Duck Hunt）这类老式光枪游戏有执念的玩家，同时又是个喜欢折腾树莓派的极客，那你肯定也遇到过那个让人头疼的问题：用Wii Remote（Wiimote）当光枪，瞄准起来总是飘忽不定，感觉差那么点意思。这其实不能怪Wiimote，它的设计初衷就不是让你像真枪一样三点一线去瞄准的。它前面那个红外摄像头，是用来捕捉感应条（Sensor Bar）上那两个红外LED的，本质上只能判断一个大概的方向，根本不知道你的电视有多大、离你有多远。所以模拟器通常的做法是给你显示一个准星，你移动遥控器，准星跟着动，这感觉就像在用鼠标，完全失去了光枪“指哪打哪”的灵魂。

这个项目的目标，就是彻底解决这个问题。我们要让Wiimote变成一台真正意义上的、可以“瞄准”的光枪。核心思路很简单：既然Wiimote的摄像头能看到红外点，那我们就给它布置一个更精确的“靶场”。我们在电视屏幕的四个角，各固定一个红外LED，形成一个已知尺寸的矩形。当Wiimote指向屏幕时，它的摄像头会同时捕捉到这四个点。通过计算机视觉中的 单应性计算 ，我们就能精确地算出摄像头中心点（也就是你“瞄准”的方向）在电视屏幕这个二维平面上的具体坐标。这样一来，你扣下扳机（B键）时，系统就能知道你瞄准的精确像素位置，而不是一个模糊的相对方向。

整个系统分为硬件和软件两部分。硬件极其简单：四个红外LED、一个USB充电头、一点电线，再加上一个3D打印的枪托和准星（非必需，但能极大提升体验）。真正的挑战在软件：我们需要在树莓派上写一个程序，通过蓝牙连接Wiimote，实时处理摄像头图像，解算坐标，并模拟成一个绝对定位的鼠标，让Retroarch这类模拟器能够识别。下面，我就带你一步步从零开始，复现这个能让你的复古游戏体验脱胎换骨的项目。

2. 核心原理拆解：单应性计算如何实现像素级瞄准

在深入动手之前，我们有必要搞清楚背后的数学魔法是怎么工作的。这能帮你理解每一步校准的意义，以及在出现问题时该如何排查。

2.1 从摄像头图像到屏幕坐标的映射

Wiimote的摄像头分辨率是1024x768，但它只会报告它“看到”的最亮几个红外光点的坐标。当我们把四个LED贴在电视四角时，摄像头每次捕捉到的，是这四个三维空间中的点在摄像头二维成像平面上的投影。

单应性 ，简单理解，就是描述两个平面之间透视变换关系的3x3矩阵。在这里，这两个平面分别是：

1. 屏幕平面 ：我们电视的物理屏幕，我们知道四个LED在这个平面上的精确物理坐标（比如，左上角LED在屏幕坐标系中是(0,0)，右下角是(1920,1080)）。
2. 图像平面 ：Wiimote摄像头拍到的图像，我们知道四个光点在摄像头像素坐标系中的坐标。

单应性矩阵 H 的作用，就是建立这两个平面坐标的映射关系。对于摄像头图像上的任意一点 (u, v) ，我们都能通过 H 找到它在屏幕平面上对应的点 (x, y) 。计算这个矩阵，至少需要四组不共线的对应点，这正是我们布置四个LED的原因。

注意 ：为什么是四个，且不能共线？三点只能确定一个仿射变换（保持平行线平行），但无法处理透视变形（比如近大远小）。四个不共线的点才能唯一确定一个透视变换矩阵，这正是我们处理Wiimote在不同角度和距离下拍摄时产生的透视效果所必需的。

2.2 算法流程与容错处理

在实际使用中，Wiimote的视野可能被遮挡，或者距离太近，导致无法同时看到全部四个LED。我们的软件算法必须足够健壮。其核心流程是一个典型的状态机：

1. 数据获取与预处理 ：程序持续读取Wiimote的摄像头数据和加速度计数据。加速度计数据用于粗略判断遥控器的朝向，帮助在部分LED被遮挡时进行推理。
2. LED识别与匹配 ：这是关键一步。摄像头返回的只是几个亮点的坐标，我们需要知道哪个亮点对应屏幕上哪个物理LED。当四个点都可见时，可以通过它们的相对位置关系（比如，最左边的点对应屏幕左下方的LED）来匹配。当只有三个点可见时，就需要结合上一帧的信息和加速度计数据来推断缺失的是哪一个。
3. 坐标解算 ：
   • 理想情况（四灯可见） ：直接使用四组完美的对应点，通过OpenCV的 findHomography 函数计算单应性矩阵 H 。然后将摄像头图像的中心点坐标（经过校准偏移修正后的“光心”）代入变换，得到屏幕坐标。这是最精确的模式。
   • 降级情况（三灯可见） ：这时问题变成了经典的 P3P问题 （Perspective-3-Point）。已知三个点在空间中的位置和它们在图像中的投影，求解摄像头的姿态（位置和旋转）。OpenCV的 solvePnP 函数可以解决这个问题，但它可能给出最多4个数学解。程序会利用加速度计数据或上一帧的稳定位置，从这些解中选出最合理的一个，然后推算出第四个LED的估计位置，再退回到四灯模式进行计算。
   • 失效情况（少于三灯） ：无法进行可靠计算。程序会保持上一次有效的鼠标位置不变，避免光标乱跳。
4. 视觉偏移补偿 ：这是实现“瞄准”而非“摄像头指向”的精髓。Wiimote的摄像头位于机身中部黑色区域，但你瞄准时是沿着遥控器上表面（或加装的准星）的视线。这两条线是平行的，但有大约8毫米的垂直偏移。如果不补偿，你瞄准的目标总会比光标位置低一点。软件通过一个可调节的“Y轴偏移”参数（校准时那个第五个箭头）来动态修正这个误差，确保准星、视线和目标三点一线。

2.3 为什么比原装Wii方案更精准？

原装Wii的感应条只有两个LED，且位于同一水平线上。Wiimote只能计算出相对于这两个点连线的“线”方向，无法得知距离信息。它需要游戏软件根据你的“光标”在屏幕上的移动速度来猜测你的指向，这是一种“相对定位”。而我们的四灯方案，通过单应性变换实现了“绝对定位”。只要摄像头能看到至少三个LED，它就能唯一确定自己在屏幕空间中的指向，与你的移动速度、历史位置完全无关，从而实现了真正“指哪打哪”的体验。

3. 硬件准备与制作：从零搭建红外定位阵列

硬件部分的花费极低，大部分材料都可以从旧设备中拆解获得。关键在于确保红外LED的安装位置精确且稳固。

3.1 物料清单与选型考量

• 树莓派 ：推荐使用树莓派3B+或更新型号，它们内置蓝牙，省去一个外设。树莓派4或5当然更好。系统使用官方的Raspberry Pi OS（原Raspbian）即可。
• Wii Remote ：一个原装或副厂的Wiimote均可。务必确保其红外摄像头功能正常（可以对着电视原来的感应条测试，手机摄像头能看到感应条的红外光，Wiimote应该也能识别）。
• 红外LED ：需要4个。 关键参数是波长940nm，直径5mm 。940nm是人眼不可见但大部分摄像头（包括Wiimote和手机摄像头）敏感的红外光，避免可见光干扰。电压降约1.2V-1.3V。
• USB线缆与充电头 ：一根废弃的USB-A to Micro-USB/Type-C线，只要电源线（红+5V，黑GND）是好的就行，数据线可以剪断不用。一个普通的5V/1A或以上的USB充电头。
• 连接线材 ：一小段导线（如网线中的单股铜线），用于焊接LED。
• 焊接工具 ：电烙铁、焊锡丝、助焊剂。
• 固定材料 ：电工胶带（临时固定）、热熔胶或3D打印的固定夹（永久固定）。
• 可选：3D打印机与耗材 ：用于打印LED固定夹、枪托和准星。如果没有，可以用轻木、亚克力板等材料手工制作替代。

3.2 红外LED阵列的电路设计与焊接

电路设计非常简单：将4个红外LED串联，然后整体连接到USB的5V电源上。

计算与原理 ：每个红外LED的工作电压（正向压降）约为1.3V。4个串联后的总压降约为 1.3V * 4 = 5.2V 。这略高于USB的5V供电电压。实际上，在5V电压下，LED不会工作在最大亮度，但电流会被限制在一个安全范围内，无需额外限流电阻也能稳定工作，且发热量小。这是一种简洁可靠的方案。

焊接步骤 ：

1. 剪开USB线 ：剪掉USB线的小头一端（Micro-USB等），剥开外皮，露出里面的四根线：红（+5V）、黑（GND）、白（Data-）、绿（Data+）。我们只需要红黑两根。
2. 识别LED极性 ：红外LED有两个引脚，短脚为阴极（负极，通常对应内部较大的电极，外壳也有平口标记），长脚为阳极（正极）。
3. 串联焊接 ：
   • 将 第一个LED的阴极（短脚） 焊接至USB的 红色（+5V）线 。这一步与常规思维相反，因为我们是整个串联回路接入电源。
   • 将 第一个LED的阳极（长脚） 与 第二个LED的阴极（短脚） 焊接在一起。
   • 同理，连接第二与第三个LED，第三与第四个LED。
   • 最后，将 第四个LED的阳极（长脚） 焊接至USB的 黑色（GND）线 。
4. 绝缘处理 ：每个焊接点都用热缩管包裹并用热风枪或打火机加热收缩，或者仔细缠绕电工胶带，确保彼此之间以及对外壳无短路。
5. 通电测试 ：将USB头插入充电器。用手机摄像头对准LED，你应该能看到LED发出微弱的紫白色光（手机CMOS对红外光敏感）。 切勿直接用肉眼长时间直视 ，虽然不可见，但红外光仍可能对眼睛造成伤害。

实操心得 ：焊接时，给每个LED的引脚预先套上一小段热缩管再焊接，焊好后将热缩管推到焊点上加热，这样比焊完再穿热缩管要方便得多。另外，建议使用不同颜色的导线或在LED上做标记（1，2，3，4），以便后续校准阶段能准确识别每个LED对应的屏幕位置。

3.3 LED在电视上的安装与定位

安装的准确性直接影响最终的校准精度和系统的可用范围。

1. 确定安装位置 ：四个LED应安装在电视屏幕的四个角附近，尽可能与屏幕玻璃处于 同一平面 。如果电视有窄边框，可以贴在边框上；如果边框较厚，可以贴在屏幕玻璃边缘的黑色区域。 绝对要避免 将LED安装在电视外壳的突出或凹陷处，这会导致LED平面与屏幕平面不共面，引入计算误差。
2. 测量与标记 ：用卷尺测量。理想情况下，四个LED应构成一个标准的矩形。水平方向的两个LED间距应尽可能大，接近电视屏幕的宽度，但必须保证在您通常的游玩位置，Wiimote的摄像头能同时看到上下两对LED。垂直间距同理。一个实用的起始间距是左右各距屏幕边缘10-15厘米，上下各距边缘5-10厘米。
3. 临时固定与测试 ：先用蓝丁胶或电工胶带将四个LED临时固定在标记好的位置。启动树莓派，运行后续的校准程序（先跳到软件部分），在初步校准界面查看Wiimote摄像头画面。移动到你预想的游玩位置（比如沙发前2-3米），检查摄像头是否能稳定、清晰地同时看到四个亮点。如果某个点经常消失，可能需要调整LED的位置或角度（稍微向内/外倾斜）。
4. 永久固定 ：确认位置合适后，使用热熔胶或3D打印的固定夹将LED永久粘合。热熔胶足够牢固且可逆（用力可以掰下来）。使用固定夹则更美观整洁。确保粘合后LED的位置没有偏移。

4. 软件环境搭建：在树莓派上配置驱动与依赖

软件部分是项目的核心，需要在树莓派上编译安装修改版的cwiid驱动库，并安装一系列Python依赖。请确保树莓派已连接网络。

4.1 系统准备与基础依赖安装

首先更新系统并安装一些编译和运行所需的工具包。

# 更新系统软件包列表
sudo apt update
sudo apt upgrade -y

# 安装蓝牙相关工具和开发库
sudo apt install -y bluetooth bluez libbluetooth-dev libusb-dev

# 安装Python3开发环境及pip
sudo apt install -y python3-dev python3-pip python3-venv

# 安装编译工具和必要的库
sudo apt install -y git build-essential autoconf automake libtool
sudo apt install -y libatlas-base-dev libjasper-dev libqtgui4 python3-pyqt5

4.2 配置Udev规则以允许用户访问输入设备

为了让普通用户权限的Python程序能够模拟鼠标输入，我们需要修改udev规则。

# 创建udev规则文件
sudo sh -c 'echo KERNEL==\"uinput\", MODE=\"0666\" > /etc/udev/rules.d/98-wiimote-uinput.rules'

# 重新加载udev规则，或直接重启树莓派
sudo udevadm control --reload-rules
sudo udevadm trigger

注意 ：如果重启后模拟鼠标功能仍然报权限错误，可以尝试将当前用户加入 input 组，然后注销重新登录。

sudo usermod -a -G input $USER

4.3 编译安装修改版cwiid库

原版的cwiid库对Wiimote摄像头数据的访问支持不够完善。我们需要使用作者修改过的版本。

# 克隆修改版的cwiid仓库
cd ~
git clone https://github.com/arpruss/cwiid-1.git
cd cwiid-1

# 生成配置脚本并编译
autoconf
./configure
make
sudo make install

# 安装Python绑定
cd python
sudo python3 setup.py install

如果 ./configure 步骤报错，提示缺少某些库（如 libbluetooth-dev ），请根据错误信息使用 sudo apt install 安装对应的 -dev 包。

4.4 安装Python运行依赖

现在安装运行光枪程序所需的Python第三方库。

# 使用pip3安装必要的库
sudo pip3 install numpy pygame opencv-python-headless uinput

这里使用了 opencv-python-headless ，它是一个不包含GUI功能的OpenCV版本，更适合在树莓派这种无桌面环境或通过SSH操作的情况下使用，体积也更小。如果你需要在树莓派桌面环境下运行带图形界面的校准程序，可以安装完整版 opencv-python ，但安装时间会很长。

4.5 获取光枪主程序

最后，下载光枪系统的Python主程序。

cd ~
git clone https://github.com/arpruss/cwiid-lightgun.git

至此，所有软件环境准备就绪。主程序路径为 ~/cwiid-lightgun/lightgun.py 。

5. 校准流程详解：实现毫米级精度的关键步骤

校准是整个项目中最需要耐心和细心的环节，它直接决定了光枪的最终精度。校准分为两部分：摄像头中心校准和LED屏幕位置校准。

5.1 摄像头中心校准：消除硬件差异

每一台Wiimote的红外摄像头光学中心可能存在微小的物理偏差。这一步的目的是找出这台特定Wiimote摄像头光轴的真实中心点坐标。

1. 准备校准工具 ：你需要一个高度为10.5mm的垫块。作者提供了3D打印模型，也可以用同等厚度的木块、乐高积木等代替。这个高度用于在遥控器倒置时保持其与正放时处于同一水平面。
2. 启动校准模式 ：在树莓派的桌面环境或通过VNC连接图形界面，打开终端，运行：

   python3 ~/cwiid-lightgun/lightgun.py -M
   

   程序会全屏显示，并提示你 同时按下Wiimote上的1和2键 进行配对。成功连接后，Wiimote的1号和4号指示灯会常亮，屏幕上方会显示一个小窗口，实时呈现Wiimote摄像头看到的画面。
3. 第一次采样（正放） ：
   • 找一个平整的桌子边缘，将Wiimote 正面朝上 （按钮朝上）， 侧边紧贴桌沿 对齐。确保Wiimote的指向与桌沿垂直，并且摄像头能看到电视四角的全部四个LED亮点。
   • 在摄像头预览窗口中，你应该能看到四个被编号的亮点。调整Wiimote位置，让四个点都清晰可见且不靠近图像边缘。
   • 按下键盘的 空格键 。程序会记录下此时四个点在摄像头中的位置。
4. 第二次采样（倒置） ：
   • 程序会提示你旋转Wiimote。将Wiimote 翻转180度 ，使其 正面朝下 （按钮贴桌面）。
   • 关键步骤 ：在Wiimote和桌面之间，垫入之前准备的 10.5mm厚的垫块 ，以确保摄像头相对于桌面的高度与正放时一致。同样，将Wiimote的同一侧边紧贴桌沿对齐。
   • 再次确保摄像头能看到四个LED，按下 空格键 。
5. 原理与目的 ：通过正放和倒置两次采样，程序可以计算出摄像头光心在Wiimote机体坐标系中的精确偏移。因为Wiimote绕其长轴旋转180度后，摄像头在水平方向上的偏移会在图像中表现为相反的位移，通过对比这两组数据，就能解算出真实的中心点。如果跳过这一步，后续的瞄准会出现固定的系统性偏差。

5.2 LED屏幕位置校准：建立空间映射关系

完成摄像头校准后，会自动进入LED位置校准界面。屏幕上会在四边显示四个箭头，分别对应一个LED。

1. 理解箭头含义 ：每个箭头由两部分组成： 方向 和 长度 。
   • 方向 ：箭头指向的方向，应该精确地对准电视上对应的那个红外LED。
   • 长度 ：箭头的长度，应该等于从 箭头根部（屏幕边缘） 到 LED实际位置 的像素距离。换句话说，把箭头的“尖”想象成那个LED，箭头的长度就是LED“缩”在屏幕后面的深度。
2. 校准操作 ：
   • 使用Wiimote上的 + 和 - 键在四个箭头之间切换选择。被选中的箭头会高亮。
   • 使用 方向键左/右 旋转箭头，使其指向对应的LED。这个过程需要你站起来，用Wiimote像激光笔一样，沿着箭头的指向看是否对准了LED。 务必仔细，这是精度基础 。
   • 使用 方向键上/下 调整箭头的长度。你需要目测屏幕边缘到LED的实际距离，并让箭头长度与之匹配。一个技巧是：用手或笔尖指着屏幕上的箭头根部，然后沿着箭头方向移动，当移动到箭头尖端时，你的手指应该刚好指向那个LED。
3. 第五个箭头（Y轴偏移补偿） ：当选中第四个箭头时按 + ，或选中第一个箭头时按 - ，会出现第五个（通常是垂直的）箭头。它默认长度为0。
   • 这个箭头用来补偿之前提到的“瞄准线与摄像头视线”的高度差 。
   • 拿起Wiimote，像举枪一样通过准星（如果装了的话）瞄准屏幕中心。观察屏幕上的红色十字准星。
   • 如果十字准星出现在你 实际瞄准点 的 下方 ，说明你需要增加这个箭头的长度（按 上 键）。增加的值（像素数）等于瞄准点与准星之间的垂直像素距离。
   • 反复测试调整，直到你通过准星瞄准哪里，红色十字准星就出现在哪里。
4. 保存与退出 ：校准完成后，按下Wiimote上的 HOME键 。所有校准数据会自动保存到 ~/.wiilightgun/ 目录下。以后使用只需运行普通模式，无需重复校准，除非你移动了LED或换了Wiimote。

避坑指南 ：

• 环境光干扰 ：校准时，确保房间内没有强烈的红外光源，如阳光直射、其他红外遥控器、打开的Wii主机感应条等。这些都会干扰摄像头识别。
• 距离要求 ：校准和游玩时，你需要站在一个能让Wiimote同时看到四个LED的位置。通常距离电视2-3米比较合适。
• 耐心微调 ：第一次校准可能花费20-30分钟。耐心调整箭头方向和长度，细微的误差会在瞄准时被放大。校准得越精细，最终体验越好。

6. 系统测试与游戏配置：在Retroarch中畅玩光枪游戏

校准完成后，就可以测试光枪并配置模拟器了。

6.1 测试光枪基本功能

在终端中运行测试命令：

python3 ~/cwiid-lightgun/lightgun.py -t

程序启动后，同样需要按Wiimote的 1+2键 连接。连接成功后，程序会进入后台运行。此时，Wiimote将模拟成一个 绝对定位的鼠标 。

• 扳机（B键） ：对应鼠标左键单击。
• A键 ：对应鼠标右键单击。
• 移动Wiimote，屏幕上的鼠标光标（如果桌面环境有的话）会跟随移动，并且是指哪打哪的绝对定位。

你可以打开一个画图程序测试点击是否准确。按 Ctrl+C 可以退出程序。

6.2 配置Retroarch运行NES光枪游戏

目标是让光枪在Retroarch的NES模拟器核心（如fceumm）中，被识别为原装的“Zapper”光枪。

1. 启动Retroarch ：在树莓派桌面启动Retroarch。
2. 加载游戏核心 ：先加载一个NES游戏ROM，并选择 fceumm 核心运行。
3. 进入快捷菜单 ：游戏中按 F1 或你设置的快捷键，调出Retroarch的快捷菜单。
4. 控制器设置 ：
   • 进入 设置 -> 输入 -> 端口1控制 。
   • 将 设备类型 设置为 RetroPad 。
   • 不要在这里绑定光枪 。
5. 核心特定设置 ：
   • 在快捷菜单中，找到 核心选项 并进入。
   • 寻找关于 Zapper （或光枪）的设置项。在 fceumm 核心中，通常名为 Zapper Mode 或 Input Device 。
   • 将其从 None 或 Mouse 改为 Touchscreen 。 这是关键一步！ 因为我们的光枪模拟的是绝对坐标鼠标，而 Touchscreen 模式正是接收绝对坐标输入。 Mouse 模式通常接收相对移动，无法工作。
6. 保存游戏预设 ：返回快捷菜单，选择 配置文件 -> 保存每游戏配置文件 。这样下次运行同一游戏时就不需要重复设置了。
7. 自动化启动脚本 ：为了方便，你可以创建一个启动脚本，在游戏启动时自动运行光枪程序。

   #!/bin/bash
   # 启动光枪程序，-B 30表示给游戏30秒启动时间，之后再连接Wiimote
   python3 ~/cwiid-lightgun/lightgun.py -t -B 30 &
   GUN_PID=$!
   # 启动Retroarch并运行指定游戏
   /opt/retropie/emulators/retroarch/bin/retroarch -L /path/to/fceumm_libretro.so /path/to/your/duckhunt.nes
   # 游戏退出后，关闭光枪程序
   kill $GUN_PID
   

   将脚本保存为 start_lightgun_game.sh ，并赋予执行权限 chmod +x start_lightgun_game.sh 。

6.3 进阶使用与问题排查

• 双人游戏 ：理论上可以运行两个 lightgun.py 实例，绑定两个Wiimote，并映射到不同的虚拟鼠标设备（需要修改uinput设备索引）。但这需要对脚本和Retroarch输入配置有更深入的了解。
• 光标抖动 ：如果光标轻微抖动，可能是环境红外干扰。确保关闭Wii主机，拉上窗帘避免阳光。如果抖动严重，可能是某个LED接触不良或供电不稳。
• 光标位置漂移 ：如果光标位置随着Wiimote角度变化而发生规律性偏移，说明LED位置校准不准确，特别是箭头长度（深度）设置有问题。需要重新进行LED位置校准。
• 无法看到四个LED ：在 -t 测试模式下，可以加上 -v 参数（verbose）运行，会在终端打印调试信息，显示摄像头看到了几个点。如果总是少于4个，请检查LED是否牢固、是否全部点亮、游玩距离是否太近导致LED超出摄像头视野。
• 微调校准文件 ：如果感觉瞄准仍有微小偏差，可以进行软件微调。先运行 python3 ~/lightgun/lightgun.py -d 进入演示模式，观察偏差。然后编辑 ~/.wiilightgun/wiimotecalibration 文件。找到类似 camera_center: [529, 508] 的行。这两个数字是摄像头中心校准值。如果光枪整体偏向右边，可以尝试将x值（529）减小几个像素（如525）。保存后重启光枪程序测试。 每次只做微小调整，并记录修改 。

7. 提升体验：3D打印枪托与准星

直接手握Wiimote射击虽然可行，但加上枪托和机械准星，沉浸感和精度会提升一个档次。

7.1 模型设计与打印要点

作者提供了枪托和准星的3D模型文件（通常在项目GitHub的 stl 或 printables 目录）。如果你有自己的设计，需注意以下几点：

• 人机工程学 ：枪托的角度和握把形状应使握持时食指能自然落在B键（扳机）上，拇指能轻松操作方向键和A键。
• 固定方式 ：设计应能牢固地卡住或套住Wiimote，避免在快速移动或扣动扳机时松动。可以考虑使用螺丝或卡扣加强固定。
• 准星设计 ：准星通常由 照门 （Rear Sight，靠近眼睛）和 准星 （Front Sight，靠近目标）组成。它们的高度差已经包含了之前软件中Y轴偏移补偿的一部分。理想情况下，当通过准星瞄准时，视线应自然指向屏幕目标，而软件补偿归零。你可以通过调整准星的高度来微调。

7.2 组装与校准

1. 打印与后处理 ：使用PLA或PETG材料打印。确保支撑去除干净，特别是卡槽内部。可以进行适当的打磨使接触面平整。
2. 安装Wiimote ：将Wiimote滑入或卡入枪托。确保所有按键可被正常按压，红外摄像头前方无遮挡。
3. 安装准星 ：将照门和准星部件安装到枪身上。初次安装后，先不要粘死。
4. 结合软件进行最终校准 ：
   • 装上枪托和准星。
   • 运行光枪程序，进入测试模式。
   • 像使用真枪一样，通过机械准星瞄准屏幕上的一个固定点（例如窗口的角落）。
   • 观察屏幕上的红色十字准星是否与你的瞄准点重合。
   • 如果不重合 ：
     • 如果偏差是固定的（例如总是偏右10个像素），回到 5.2节 ，使用第五个箭头进行软件补偿。
     • 如果偏差随着距离变化（例如近处准，远处偏），说明机械准星的安装角度有问题，需要物理调整准星的高度或倾斜度，然后重新测试。
   • 反复调整软件补偿和机械准星，直到在常用的游玩距离（如2米、3米）上，都能实现精准瞄准。
   • 调整满意后，再用胶水固定准星部件。

经过以上所有步骤，你就获得了一套高精度、可玩性极强的树莓派光枪系统。它不仅完美解决了复古光枪游戏的输入问题，其背后基于计算机视觉和单应性计算的思路，也为其他需要高精度空间定位的交互项目（如自制VR/AR交互设备、智能投影交互等）提供了宝贵的实践参考。整个项目从硬件焊接、软件编译到精密校准，涵盖了嵌入式开发、计算机视觉和系统集成等多个方面，是一次非常综合且有成就感的极客实践。