Arduino与Unity串口通信实战：打造实体交互拆弹游戏

1. 项目概述：当硬件“炸弹”遇上虚拟拆解

几年前，我在一个游戏展上玩过一个实体解谜游戏，玩家需要在一个布满电线和计时器的真实箱体前操作，屏幕上的倒计时让人手心冒汗。那种指尖触碰真实开关、听到继电器“咔哒”声的紧张感，是纯鼠标点击无法比拟的。自那以后，我就一直想亲手做一个类似的东西，不是简单的“按下按钮”，而是让整个物理实体都成为游戏交互的一部分。这次的项目，就是基于这个想法的一次实践：用Arduino Uno作为“炸弹”的大脑，Unity作为游戏的“指挥中心”，打造一个需要你亲手去“摆弄”的实体拆弹游戏。

这个项目的核心，是构建一套硬件与软件深度耦合的交互系统。一个自制的木盒就是“炸弹”本体，上面集成了矩阵键盘、超声波传感器和摇杆。你的每一个物理操作——是抬起盒子、输入密码，还是小心翼翼地用摇杆引导虚拟导线——都会通过串口实时地改变Unity游戏场景中的状态。它解决的不仅仅是一个游戏创意问题，更是一个典型的物理信息到数字信号转换与同步的工程问题。无论是对于想给游戏增加实体外设的独立开发者，还是对于嵌入式或物联网领域想学习如何与上位机软件通信的爱好者，这个项目都提供了一个从电路焊接、固件编写到软件集成的完整闭环案例。

我选择Arduino和Unity这对组合，原因很直接：它们分别代表了易用性与表现力的黄金平衡点。Arduino的生态成熟，驱动各种传感器毫不费力；Unity的实时渲染和事件系统，能快速构建出富有张力的视觉反馈。而连接二者的串口通信，就像是在两个世界之间架起了一座简单却稳固的桥梁。整个制作过程，从最初的纸板原型到最终的松木盒子，我踩过了通信不同步、供电不稳、机械结构松动等一系列的“坑”，这些经验远比最终那个会“嘀嘀”响的盒子更有价值。接下来，我就把这几个月从零到一的构建过程、核心的代码逻辑，以及那些只有亲手做过才会知道的注意事项，毫无保留地分享出来。

2. 核心硬件选型与交互设计思路

2.1 硬件清单与核心功能定义

项目的硬件部分围绕“拆弹”这个核心动作展开，每一个组件都对应一种特定的解谜交互方式。我的选型原则是：常见、可靠、易于集成，同时兼顾一定的拓展性。

1. 主控单元：Arduino Uno R3

   • 为什么是Uno？对于这个项目，Uno的ATmega328P处理器性能绰绰有余。它拥有14个数字I/O口和6个模拟输入口，足以驱动本项目所有传感器，并且还有余量。其最大的优势在于稳定性极高，相关的串口通信库非常成熟，几乎不会在通信环节出现玄学问题。相比于更小巧的Nano，Uno的接口布局更宽松，在原型阶段用杜邦线连接时不易短路，调试起来更方便。

2. 输入设备一：4x4薄膜矩阵键盘

   • 功能：用于输入拆弹密码。这是最直接的“拆弹”要素。
   • 选型考量：薄膜键盘成本低，接口简单（仅需8个I/O口），并且自带按键标识，用户体验直观。我选择的是最常见的HD44780兼容款式，其驱动库（如Keypad）丰富，几乎无需底层编程。为什么不直接用单个按键？因为4x4矩阵（16键）只用8个引脚，如果使用16个独立按键则需要16个引脚，会大量占用Uno的资源，得不偿失。

3. 输入设备二：双轴摇杆模块（Joystick）

   • 功能：模拟在虚拟迷宫内引导拆弹导线的精细操作。
   • 选型考量：模块化摇杆内部通常是两个电位器，输出两路模拟信号（X轴和Y轴）。选择它是因为其操作方式符合“引导”的直觉——推杆方向即导线移动方向。模拟量的输入也让Unity端可以做出更平滑、更精确的移动反馈，比用四个方向键（数字量）体验好得多。

4. 传感器：HC-SR04超声波测距模块

   • 功能：检测木盒是否被抬起，作为触发第一个谜题的条件。
   • 选型考量：这是一个非常巧妙的非接触式检测方案。最初我考虑过使用水银开关或倾角传感器，但前者有安全风险，后者成本较高。HC-SR04价格低廉，测距精度（厘米级）对于“检测抬起”这个动作来说完全足够。其原理是发射超声波并接收回波，通过时间差计算距离。我将它朝下安装在盒子底部，当盒子放在桌面上时，测得的距离是一个很小的固定值（几厘米）；当盒子被抬起，距离值会急剧增大，从而被程序识别。

5. 结构主体：自制松木盒

   • 材料：12mm厚松木板。松木质地较软，易于切割和打磨，适合手工制作。
   • 设计核心：模块化。所有电子元件都不是用胶水死死粘住的，而是通过弹性扎带、卡槽和少量螺丝固定。例如，Arduino板用四根扎带固定在盒内底板的四个安装孔上；摇杆从底板下方用螺丝固定，上方再用一个扎带箍住其壳体防止转动。这样设计的好处是，如果某个元件损坏，或者我想升级换代，可以快速拆卸更换，而无需破坏整个盒子。

注意：供电是硬件稳定的基石。整个系统由一台电脑的USB端口通过数据线为Arduino供电。这里有一个关键细节：当同时连接多个传感器，尤其是超声波模块和摇杆同时工作时，瞬间电流可能较大。务必确保USB线质量良好，连接牢固。我曾因使用一根老化线材导致摇杆读数时断时续，排查了很久才发现是供电不足。如果条件允许，可以外接一个5V/2A的电源适配器到Arduino的电源接口，让USB仅负责数据传输，这样最为稳定。

2.2 软件架构与通信协议设计

硬件是躯体，软件是灵魂。整个系统的软件部分分为两块：运行在Arduino上的固件，以及运行在电脑上的Unity游戏程序。它们之间通过串行通信进行对话。

为什么选择串口通信？对于这种单向传感器数据上报、偶尔接收简单指令的场景，串口通信是最简单、最直接、延迟也相对较低的方式。像I2C、SPI等多用于板载设备间通信；网络通信（如Wi-Fi）则过于复杂，且可能引入不必要的延迟和配置麻烦。串口是“即插即用”的典范，在Unity中也有非常成熟的串口通信库（如System.IO.Ports）。

通信协议设计：为了避免数据混乱，必须定义一套清晰的“语言”。我设计了一个简单的基于字符串的指令协议，格式为：[指令头],[数据1],[数据2];。分号作为结束符，便于Unity端分割数据包。

• 超声波数据："DIST,123;"表示当前测距为123厘米（实际会除以一个系数，例如29.1，来换算成厘米）。
• 键盘数据："KEY,A;"表示按下了A键（在4x4键盘上，A可能代表数字1）。
• 摇杆数据："JOY,512,498;"表示X轴模拟值为512，Y轴为498（在10位ADC下，范围是0-1023）。

在Arduino端，程序逻辑是一个大循环：持续读取各个传感器的值，一旦发现某个值发生变化（比如按键被按下、摇杆移动了超过一个阈值、距离变化超过5厘米），就立即通过Serial.println()发送对应的指令字符串。这里采用变化上报而非轮询上报，可以大幅减少冗余数据，降低串口带宽压力。

在Unity端，则开启一个线程持续监听串口。收到数据后，根据指令头解析数据，并触发对应的事件。例如，收到"DIST,200;"，就会调用一个OnBoxLifted()方法，在游戏UI中升起那个提示密码的“舱门”。

实操心得：波特率与数据稳定性。串口通信的波特率（数据传输速度）需要两端严格匹配。我选择的是115200。这个速率远高于实际所需的数据量，但高波特率的好处是，数据包发送得快，不容易堵塞。在代码中，务必在Serial.begin(115200)和Unity端初始化串口时设置相同的值。此外，在Arduino发送数据的代码前后加上短暂的delay(5)，可以给串口缓冲区留出处理时间，能有效避免数据包粘连在一起导致Unity解析失败。

3. 分步实现：从原型到成品

3.1 第一步：建立通信桥梁与核心交互原型

万事开头难，这个项目的“开头”就是让Arduino和Unity说上话。我建议完全抛开硬件，先从软件连通性测试开始。

1. Arduino端“心跳测试”：在Arduino IDE中，烧录一个最简单的程序，每秒发送一个递增的数字。

void setup() { Serial.begin(115200); } void loop() { static int count = 0; Serial.print("Count: "); Serial.println(count); count++; delay(1000); // 每秒发送一次 }

烧录后，打开Arduino IDE自带的串口监视器，设置波特率为115200，你应该能看到不断滚动的“Count: X”信息。这证明Arduino的串口发送功能正常。

2. Unity端接收“心跳”：在Unity中，你需要处理跨平台串口支持。我使用了System.IO.Ports（在Windows上需确保项目设置为.NET Framework或.NET Standard，而非较新的.NET Core/.NET 5+，因为后者官方库支持不完善）。

using System.IO.Ports; using UnityEngine; public class SerialManager : MonoBehaviour { private SerialPort _serialPort; public string portName = "COM3"; // 你的Arduino端口号 public int baudRate = 115200; void Start() { _serialPort = new SerialPort(portName, baudRate); try { _serialPort.Open(); Debug.Log("串口连接成功: " + portName); } catch (System.Exception e) { Debug.LogError("串口连接失败: " + e.Message); } } void Update() { if (_serialPort != null && _serialPort.IsOpen) { try { string message = _serialPort.ReadLine(); // 读取一行 Debug.Log("收到: " + message); // 这里可以解析message，触发游戏事件 } catch (System.Exception) { } } } void OnDestroy() { if (_serialPort != null && _serialPort.IsOpen) _serialPort.Close(); } }

将这段脚本挂载到Unity场景中的任意GameObject上，在Inspector面板中填写正确的portName（在Windows设备管理器中查看Arduino的COM号，如COM3；在macOS上是/dev/cu.usbmodemXXX）。运行Unity，如果能在Console窗口看到和串口监视器里一样的“Count: X”日志，恭喜你，通信桥梁已经打通！

3. 第一个交互原型：抬起盒子触发事件通信打通后，我接上了第一个传感器：HC-SR04超声波模块。接线很简单：Vcc接5V，Gnd接Gnd，Trig接数字引脚9，Echo接数字引脚10。

Arduino端代码升级为读取距离并发送：

#include <NewPing.h> // 使用NewPing库简化超声波操作 #define TRIGGER_PIN 9 #define ECHO_PIN 10 #define MAX_DISTANCE 200 // 最大检测距离200厘米 NewPing sonar(TRIGGER_PIN, ECHO_PIN, MAX_DISTANCE); int lastSentDistance = 0; void setup() { Serial.begin(115200); } void loop() { delay(50); // 每次测量间隔50毫秒，避免信号干扰 unsigned int distance = sonar.ping_cm(); // 获取距离（厘米） // 只有当距离变化超过5厘米时才发送，减少数据量 if (abs(distance - lastSentDistance) > 5) { Serial.print("DIST,"); Serial.print(distance); Serial.println(";"); lastSentDistance = distance; } }

在Unity端，修改Update方法中的解析逻辑：

void Update() { if (_serialPort != null && _serialPort.IsOpen) { try { string message = _serialPort.ReadLine().Trim(); // 去除换行符 if (message.StartsWith("DIST,")) { string[] parts = message.Split(',', ';'); if (int.TryParse(parts[1], out int dist)) { if (dist > 20) { // 如果距离大于20厘米，认为盒子被抬起 OnBoxLifted(); // 触发自定义事件 } } } } catch (System.Exception) { } } }

此时，在Unity中创建一个简单的UI图像（比如一个舱门），编写OnBoxLifted()方法，让它向上移动。当你用手抬起装有超声波模块的盒子（甚至初期只是用纸板固定模块模拟）时，Unity屏幕上的舱门就会升起。这个“魔法时刻”是整个项目最令人兴奋的起点，它证明了物理动作可以无缝驱动虚拟世界。

3.2 第二步：集成矩阵键盘与摇杆输入

有了通信框架和第一个成功交互，后续组件的集成就是按部就班的“填空”了。

1. 集成4x4矩阵键盘：接线略复杂，需要将键盘的8个引脚（4行R1-R4，4列C1-C4）连接到Arduino的8个数字I/O口。我使用了Keypad库来管理扫描逻辑。

#include <Keypad.h> const byte ROWS = 4; const byte COLS = 4; char keys[ROWS][COLS] = { {'1','2','3','A'}, {'4','5','6','B'}, {'7','8','9','C'}, {'*','0','#','D'} }; byte rowPins[ROWS] = {2, 3, 4, 5}; // 连接行引脚 byte colPins[COLS] = {6, 7, 8, 9}; // 连接列引脚 Keypad keypad = Keypad(makeKeymap(keys), rowPins, colPins, ROWS, COLS); void loop() { char key = keypad.getKey(); // 非阻塞式获取按键 if (key) { Serial.print("KEY,"); Serial.print(key); Serial.println(";"); } // ... 其他传感器读取 }

在Unity端，解析KEY指令，将其显示在屏幕上的密码输入框内，并验证密码是否正确。这里可以设计一个简单的密码逻辑，比如正确密码是“1984”，输入正确则进入下一关。

2. 集成双轴摇杆：摇杆模块通常有5个引脚：Vcc, Gnd, VRx（X轴模拟输出）, VRy（Y轴模拟输出）, SW（按键，未使用）。将VRx和VRy分别接到Arduino的A0和A1模拟输入引脚。

#define JOY_X_PIN A0 #define JOY_Y_PIN A1 int lastJoyX = 0; int lastJoyY = 0; const int JOY_THRESHOLD = 10; // 变化阈值，减少抖动和冗余发送 void loop() { int joyX = analogRead(JOY_X_PIN); int joyY = analogRead(JOY_Y_PIN); // 只有当摇杆位置变化超过阈值时才发送 if (abs(joyX - lastJoyX) > JOY_THRESHOLD || abs(joyY - lastJoyY) > JOY_THRESHOLD) { Serial.print("JOY,"); Serial.print(joyX); Serial.print(","); Serial.print(joyY); Serial.println(";"); lastJoyX = joyX; lastJoyY = joyY; } // ... 键盘和超声波读取 }

在Unity端，解析JOY指令。将模拟值（0-1023）映射到屏幕上一个光标或导线头的移动范围上。例如，可以创建一个2D的迷宫贴图，让摇杆控制一个点在其中移动，避开墙壁，最终到达终点。

关键技巧：多任务处理与防数据冲突。Arduino的loop()函数是顺序执行的。如果某个传感器读取或发送操作耗时过长（比如超声波测距等待回波），会阻塞其他传感器的读取。我的解决方案是使用状态机和非阻塞延时。例如，为超声波读取设置一个时间戳，每隔50毫秒才触发一次新的测量，而不是每次loop()都等待。对于串口发送，确保每次只发送一条完整的指令，并在指令间添加微小延时（delay(2)），防止数据在串口缓冲区中堆叠在一起，导致Unity端读取到半截或不完整的指令，引发解析错误。

3.3 第三步：木盒设计与总装调试

当所有电子功能在面包板上测试无误后，就可以着手制作最终的外壳了。木盒不仅是容器，更是用户体验的重要组成部分。

1. 设计与切割：我用Fusion 360绘制了简单的盒体图纸。一个长方体，上盖可打开。前面板开孔用于安装键盘（开孔尺寸需比键盘PCB板略小，使其能卡住）。底板开孔用于安装摇杆（从下往上穿，用螺母固定）和超声波模块（开两个小圆孔分别对应发射和接收探头）。侧边开一个方形孔，用于引出USB线。所有尺寸务必反复测量，特别是开孔位置，要与内部元件的安装位置精准对应。

2. 组装与固定：

• Arduino Uno：在盒内底板对应Uno安装孔的位置，拧上四颗M3的尼龙柱。然后用四根细细的弹性扎带，穿过板子与尼龙柱之间的空隙，将Uno牢牢地“绑”在底板上。这种方式比螺丝固定更柔和，且抗震。
• 摇杆：从底板下方穿过开孔，在上方用配套的螺母拧紧。为了防止用力推摇杆时整个模块旋转，我在摇杆壳体上方又横着绑了一根扎带，两端固定在底板两侧，形成一道“保险杠”。
• 矩阵键盘：我切割了三小块木条，粘在面板开孔的内侧，形成一个“井”字形卡槽。键盘的PCB板可以严丝合缝地从这个卡槽正面推进去，背面再用一点热熔胶点一下防止脱落，这样既牢固又方便日后取出。
• 超声波模块：将其探头部分从底板下方塞进两个小圆孔，用热熔胶在盒子内部将其固定。同样，在模块上方用一根扎带横跨固定，防止其因线缆拉扯而移位。

3. 布线整理：使用尼龙扎带将杜邦线捆扎整齐，沿盒内壁走线。绝对不要让线缆悬空或纠缠在活动部件（如摇杆）周围。混乱的线缆不仅是美观问题，更可能在盖盖子时被挤压，导致短路或接触不良。所有连接到Arduino的线，我都尽量使用了不同颜色的杜邦线，并按功能分组（如所有键盘行线用黄色，列线用绿色），这在后期调试时能救命。

4. 总装与通电测试：盖上盖子（暂时不要拧死），连接USB线到电脑。首先在Arduino IDE的串口监视器中观察，手动触发各个传感器（按键盘、摇动摇杆、抬起盒子），看发送的指令格式是否正确、数据是否稳定。然后打开Unity游戏场景，进行完整的集成测试。重点测试并发操作：比如一边抬起盒子看着舱门升起，一边用摇杆操作迷宫，同时还能输入密码。观察Unity是否会出现卡顿、指令丢失或解析错误。

4. 核心代码逻辑与Unity集成详解

4.1 Arduino固件代码架构解析

Arduino端的代码是整个系统的数据采集与转发中心。其核心架构是一个基于状态的非阻塞轮询系统，旨在稳定、高效地管理多个输入设备。

// 1. 引入必要的库 #include <Keypad.h> #include <NewPing.h> // 2. 硬件引脚定义与对象初始化 // ... (键盘、超声波、摇杆的引脚定义和对象创建，同前文) // 3. 状态变量定义 unsigned long lastSonarTime = 0; const unsigned long sonarInterval = 50; // 超声波测量间隔50ms int lastDist = 0; int lastJoyX = 0; int lastJoyY = 0; const int joyThreshold = 10; void setup() { Serial.begin(115200); // 初始化各传感器（如有需要） } void loop() { // 第一部分：处理键盘（非阻塞，即时响应） char key = keypad.getKey(); if (key) { sendData("KEY", String(key)); } // 第二部分：处理超声波（定时非阻塞） unsigned long currentMillis = millis(); if (currentMillis - lastSonarTime >= sonarInterval) { lastSonarTime = currentMillis; unsigned int distance = sonar.ping_cm(); if (abs(distance - lastDist) > 5) { // 变化超过5cm才发送 lastDist = distance; sendData("DIST", String(distance)); } } // 第三部分：处理摇杆（变化上报） int joyX = analogRead(JOY_X_PIN); int joyY = analogRead(JOY_Y_PIN); if (abs(joyX - lastJoyX) > joyThreshold || abs(joyY - lastJoyY) > joyThreshold) { lastJoyX = joyX; lastJoyY = joyY; sendData("JOY", String(joyX) + "," + String(joyY)); } // 可以在这里添加其他传感器或逻辑 } // 统一的发送函数，确保格式一致并添加延时防止数据包粘连 void sendData(String prefix, String value) { Serial.print(prefix); Serial.print(","); Serial.print(value); Serial.println(";"); delay(2); // 关键的小延时，让串口缓冲区有时间处理 }

代码要点解析：

• 非阻塞设计：loop()函数中没有任何delay()（除了发送时的小延时），所有操作都基于时间戳或即时读取，保证了系统的响应速度。
• 变化上报：超声波和摇杆都采用了“变化超过阈值才上报”的策略。这极大地减少了不必要的数据传输，避免了串口拥堵和Unity端的处理压力。对于摇杆，这个阈值（joyThreshold）很重要，它过滤掉了模拟信号的微小抖动（噪声）。
• 统一发送函数：将数据打包成固定格式前缀,数据;后发送，并跟随一个2毫秒的delay。这个短暂的延时是经验值，它能确保每个数据包在串口缓冲区中被完整地分隔开，是保证通信稳定的关键小技巧。

4.2 Unity端数据解析与游戏逻辑绑定

Unity端的任务是接收、解析数据，并将其转化为游戏内的视觉和逻辑反馈。关键在于稳定地读取串口和高效地分发事件。

1. 稳定的串口通信管理类：为了避免在主线程（Update）中直接进行可能阻塞的串口读取操作，更好的做法是使用多线程或异步。这里我使用一个简单的后台线程来监听串口。

using System.IO.Ports; using System.Threading; using UnityEngine; using System.Collections.Concurrent; public class SerialCommunication : MonoBehaviour { public string portName = "COM3"; public int baudRate = 115200; private SerialPort _serialPort; private Thread _readThread; private bool _isRunning = false; // 线程安全的队列，用于存放从串口线程接收到的原始数据 private ConcurrentQueue<string> _dataQueue = new ConcurrentQueue<string>(); void Start() { OpenSerialPort(); } void OpenSerialPort() { try { _serialPort = new SerialPort(portName, baudRate); _serialPort.ReadTimeout = 100; _serialPort.Open(); _isRunning = true; _readThread = new Thread(ReadSerialData); _readThread.Start(); Debug.Log($"串口 {portName} 已连接。"); } catch (System.Exception e) { Debug.LogError($"无法打开串口 {portName}: {e.Message}"); } } // 在独立线程中持续读取数据 private void ReadSerialData() { while (_isRunning && _serialPort != null && _serialPort.IsOpen) { try { string message = _serialPort.ReadLine(); if (!string.IsNullOrEmpty(message)) { _dataQueue.Enqueue(message.Trim()); // 存入队列 } } catch (System.TimeoutException) { } // 读取超时是正常的，继续循环 catch (System.Exception e) { Debug.LogWarning($"读取串口时出错: {e.Message}"); break; } } } // 在主线程的Update中处理队列中的数据，保证线程安全 void Update() { while (_dataQueue.TryDequeue(out string rawMessage)) { ParseAndHandleMessage(rawMessage); } } void ParseAndHandleMessage(string message) { // 示例：解析 "DIST,123;" if (message.StartsWith("DIST,")) { string[] parts = message.Split(',', ';'); if (parts.Length >= 2 && int.TryParse(parts[1], out int distance)) { // 触发事件，通知其他游戏组件 EventManager.Instance.TriggerBoxLifted(distance > 20); } } else if (message.StartsWith("KEY,")) { // ... 解析键盘输入 } else if (message.StartsWith("JOY,")) { // ... 解析摇杆输入 } } void OnDestroy() { _isRunning = false; if (_readThread != null && _readThread.IsAlive) _readThread.Join(500); // 等待线程结束，最多500ms if (_serialPort != null && _serialPort.IsOpen) _serialPort.Close(); } }

2. 使用事件系统解耦：不要让SerialCommunication类直接去操作UI或游戏对象。应该使用一个事件管理器（Event Manager）或C#的Action/Event来解耦。

// 一个简单的事件管理器示例 public class EventManager : MonoBehaviour { public static EventManager Instance; public System.Action<bool> OnBoxStateChanged; // 参数：是否被抬起 public System.Action<char> OnKeyPressed; public System.Action<Vector2> OnJoystickMoved; // 参数：标准化后的摇杆向量 void Awake() { Instance = this; } }

在ParseAndHandleMessage中，不再直接控制UI，而是触发事件：

EventManager.Instance.OnBoxStateChanged?.Invoke(distance > 20);

然后，在负责控制舱门动画的脚本中监听这个事件：

void OnEnable() { EventManager.Instance.OnBoxStateChanged += HandleBoxLifted; } void OnDisable() { EventManager.Instance.OnBoxStateChanged -= HandleBoxLifted; } void HandleBoxLifted(bool isLifted) { // 控制舱门动画或状态 _doorAnimator.SetBool("IsOpen", isLifted); }

这种设计让代码结构清晰，易于维护和扩展。如果你想增加新的硬件反馈（比如震动马达），只需要在事件管理器中新增一个事件，并在对应的硬件控制脚本中触发它即可，无需修改通信解析逻辑。

3. 摇杆数据的平滑处理与映射：从Arduino传来的摇杆原始值（0-1023）是离散的，直接用来控制UI可能会抖动。通常需要进行死区处理和平滑滤波。

// 在解析JOY消息后 Vector2 rawInput = new Vector2(joyX, joyY); // 1. 归一化到(-1, 1)范围 Vector2 normalizedInput = new Vector2( (rawInput.x - 512f) / 512f, // 假设中值是512 (rawInput.y - 512f) / 512f ); // 2. 死区处理，忽略中心附近的微小波动 float deadZone = 0.1f; if (normalizedInput.magnitude < deadZone) { normalizedInput = Vector2.zero; } // 3. 触发事件 EventManager.Instance.OnJoystickMoved?.Invoke(normalizedInput);

在接收事件的脚本中，再用这个归一化的向量去控制屏幕上的光标移动，乘以一个速度系数即可。

5. 调试、优化与项目总结

5.1 常见问题排查与解决方案

在开发过程中，我遇到了几乎所有硬件交互项目都会踩的坑。这里列出一个速查表，希望能帮你快速定位问题。

5.2 项目优化与扩展方向

这个基础框架有很大的扩展潜力，以下是一些可以尝试的方向：

1. 增加输出反馈（沉浸感升级）：

   • 震动马达：在密码输入错误或炸弹爆炸时，让木盒震动。只需在Arduino上接一个小型震动马达（需三极管驱动），Unity在特定事件时通过串口发送指令（如"VIB,255,1000;"表示最大强度震动1秒）控制它。
   • LED灯带：在盒子边缘安装RGB LED灯带（如WS2812B），用Unity控制颜色和闪烁模式，用于指示游戏状态（如倒计时紧张时变红闪烁）。
   • 蜂鸣器：添加有源蜂鸣器，播放简单的音调，作为操作提示或警报。

2. 通信协议升级：

   • 二进制协议：当前基于字符串的协议易于调试但效率较低。可以升级为二进制协议，将多个传感器的数据打包成一个结构体发送，能显著提高数据传输效率和速度。
   • 错误校验：在数据包末尾加入校验和（如CRC8），Unity端收到数据后先校验，确保数据完整性。

3. 游戏内容深化：

   • 多阶段解谜：设计更复杂的谜题链。例如，先抬起盒子获得密码提示，输入密码后解锁摇杆控制权，完成导线迷宫后，超声波传感器又变成需要保持特定角度（距离）的稳定器。
   • 多人协作：制作两个盒子，一个负责输入，一个负责稳定，通过网络或蓝牙让两个Unity实例同步状态，实现本地多人合作拆弹。

4. 制作工艺提升：

   • PCB设计：如果打算批量制作或追求极致整洁，可以设计一块定制PCB，将Arduino、传感器接口、驱动电路等集成在一块板上，通过排线连接外部设备，盒子内部会非常清爽。
   • 3D打印外壳：使用3D打印制作更复杂、更精致的外壳，可以完美贴合所有元件，并设计卡扣结构，实现无螺丝组装。

回顾整个项目，最大的收获不是做出了一个能玩的游戏盒子，而是完整地走通了一次“从物理信号到数字逻辑再到视觉反馈”的创造链路。它强迫我去思考硬件稳定性、软件架构、用户体验甚至机械结构这些跨领域的问题。那些深夜调试串口通信、为了一根接触不良的线排查半天的经历，最终都变成了对系统更深的理解。硬件项目总是充满意外，但也正因如此，当所有部件终于协同工作，盒子里的灯光随着屏幕上的倒计时同步闪烁时，那种成就感是纯软件项目无法给予的。这个拆弹游戏盒子现在放在我的书架上，它不仅是一个玩具，更像一个纪念碑，纪念着一次充满焊锡味、木头屑和代码调试的愉快创造旅程。