当前位置：首页 > news >正文

Unity连接Arduino BLE实战：5分钟实现PC端双向通信

news 2026/5/23 6:35:01

1. 这不是“配对”，而是让Unity像手机App一样和Arduino对话

很多人第一次尝试Unity连接Arduino蓝牙模块时，会下意识打开Windows的“蓝牙设置”去“添加设备”——结果折腾半小时，Unity里依然收不到任何数据。我最初也这么干过，直到在调试日志里反复看到BluetoothLEDevice not found才意识到：Unity本身不走系统蓝牙协议栈，它需要的是一个能被C#直接调用的、轻量级的BLE通信通道，而不是传统意义上的“配对成功”。这个认知偏差，是90%初学者卡在第一步的根本原因。

标题里说的“5分钟搞定”，指的不是从零开始学蓝牙协议，而是从你手头已有Arduino Nano 33 BLE Sense（或类似带nRF52840芯片的开发板）和一台Windows/Mac电脑出发，跳过所有系统级蓝牙管理界面，在Unity中通过C#脚本直接发现、连接、读写BLE服务与特征值。整个过程不依赖任何第三方App中转，也不需要Android/iOS打包——纯PC端实时通信。核心关键词是：Unity、Arduino、BLE、C#、nRF52840、GATT、Characteristic Write/Notify。适合嵌入式初学者、交互装置创作者、教育类项目开发者，以及想快速验证传感器数据流闭环的Unity程序员。你不需要懂L2CAP或ATT层细节，但得明白“服务（Service）”是功能容器，“特征值（Characteristic）”是具体的数据管道，而“Notify”是让Arduino主动“喊话”的开关。下面所有操作，都建立在这个最小可行认知之上。

2. Arduino端：用ArduinoBLE库把开发板变成“可被Unity喊到的小喇叭”

2.1 为什么必须用nRF52840芯片？绕不开的硬件真相

不是所有Arduino都能跑BLE。Uno、Mega这些经典型号用的是ATmega328P或ATmega2560，它们没有内置BLE射频模块，强行加HC-05/HC-06只能走经典蓝牙（SPP），而Unity官方插件（如Windows UWP Bluetooth API或第三方库）根本不支持SPP串口透传。真正能和Unity无缝对接的，是原生支持BLE 5.0的nRF52系列芯片——Arduino Nano 33 BLE Sense、Nano 33 BLE、SparkFun nRF52840 Mini，都是基于nRF52840。它的关键优势在于：固件层已实现完整的GATT服务器（GATT Server），能被标准BLE Central角色（比如Unity运行的PC程序）直接扫描、连接、读写，无需额外AT指令解析或串口桥接。

我试过用ESP32做替代方案，虽然它也支持BLE，但Arduino-ESP32库的BLEServer实现存在Notify回调延迟高、连接稳定性差的问题，尤其在Unity频繁轮询时容易断连。而nRF52840的ArduinoBLE库由Nordic官方深度优化，底层使用SoftDevice S140，实测连接保持时间超过24小时无掉线。所以，如果你手头只有Uno，请先换板——这不是成本问题，而是协议栈兼容性问题。

2.2 Arduino代码：三段式结构，每行都有明确目的

以下代码已在Arduino IDE 2.3.2 + Nano 33 BLE Sense上实测通过，上传后开发板会广播一个名为“MySensorHub”的设备，并开放两个特征值：一个用于接收Unity发来的控制指令（Write），一个用于向Unity推送传感器数据（Notify）。

#include <ArduinoBLE.h> // 定义BLE服务UUID（自定义，但需保证全局唯一，这里用标准格式） const char* SERVICE_UUID = "12345678-1234-1234-1234-123456789012"; // 控制指令特征值UUID（允许Write，用于Unity发命令） const char* CONTROL_CHAR_UUID = "87654321-1234-1234-1234-123456789012"; // 传感器数据特征值UUID（允许Notify，用于Arduino主动推数据） const char* SENSOR_CHAR_UUID = "abcdef01-1234-1234-1234-123456789012"; BLEService sensorService(SERVICE_UUID); BLECharacteristic controlChar(CONTROL_CHAR_UUID, BLERead | BLEWrite, 20); // 20字节缓冲区 BLECharacteristic sensorChar(SENSOR_CHAR_UUID, BLERead | BLENotify, 20); // 模拟传感器数据（实际项目中替换为IMU、温湿度等读取） float temperature = 25.3; int ledState = 0; void setup() { Serial.begin(9600); // 初始化BLE，设置设备名和广播间隔 if (!BLE.begin()) { Serial.println("BLE failed to initialize"); while (1); } BLE.setLocalName("MySensorHub"); // 广播名，Unity扫描时显示此名称 BLE.setAdvertisedService(sensorService); sensorService.addCharacteristic(controlChar); sensorService.addCharacteristic(sensorChar); BLE.addService(sensorService); // 启用Notify，让Unity能订阅该特征值变化 sensorChar.writeValue((uint8_t*)&temperature, sizeof(temperature)); // 初始值 sensorChar.setEventHandler(BLEWritten, onControlWrite); // 绑定写入事件 BLE.advertise(); // 开始广播 Serial.println("BLE device advertised as MySensorHub"); } void loop() { // 处理BLE事件（连接、断开、写入等） BLEDevice central = BLE.central(); if (central) { Serial.print("Connected to central: "); Serial.println(central.address()); // 模拟每2秒更新一次温度数据并Notify static unsigned long lastNotify = 0; if (millis() - lastNotify >= 2000) { temperature += 0.1; // 模拟缓慢升温 sensorChar.writeValue((uint8_t*)&temperature, sizeof(temperature)); lastNotify = millis(); Serial.print("Notified temperature: "); Serial.println(temperature); } } } // 当Unity向controlChar写入数据时触发 void onControlWrite(BLEDevice central, BLECharacteristic characteristic) { uint8_t value[20]; int len = characteristic.readValue(value, sizeof(value)); if (len > 0) { // 解析前2字节：0x01开启LED，0x00关闭LED if (len >= 2 && value[0] == 0x01) { digitalWrite(LED_BUILTIN, HIGH); ledState = 1; Serial.println("LED ON via BLE command"); } else if (len >= 2 && value[0] == 0x00) { digitalWrite(LED_BUILTIN, LOW); ledState = 0; Serial.println("LED OFF via BLE command"); } } }

提示：这段代码的核心逻辑是“服务注册→特征值定义→事件绑定→循环Notify”。sensorChar.setEventHandler(BLEWritten, onControlWrite)这行看似多余，实则关键——它让Arduino能响应Unity的写入请求，形成双向通信闭环。很多教程只做Notify单向推送，导致Unity无法反向控制硬件，项目实用性大打折扣。

2.3 硬件接线与供电：别让5V毁掉你的nRF52840

Nano 33 BLE Sense的IO口是3.3V电平，直接接5V传感器或LED会烧毁芯片。我曾因图省事把DHT22温湿度传感器接到5V引脚，结果板子再也没法进入BLE模式。正确做法是：所有外设必须接3.3V电源，IO口使用pinMode(pin, INPUT_PULLUP)时内部上拉也是3.3V。LED控制示例中，digitalWrite(LED_BUILTIN, HIGH)实际输出3.3V，驱动小功率LED完全足够。若需驱动继电器或电机，必须加光耦隔离或MOSFET驱动电路。另外，USB供电电流有限（通常500mA），当连接多个传感器时，建议用外部5V/2A电源适配器，通过VIN引脚输入——但注意VIN经过板载稳压器降压至3.3V，效率较低，长时间高负载可能发热。我的经验是：传感器数量≤3个时USB供电足够；≥4个务必外接电源。

3. Unity端：用UWP API绕过Win32蓝牙限制，直连BLE设备

3.1 为什么不能用Windows传统蓝牙API？一个被忽略的系统级障碍

Unity默认编译目标是.NET Framework或.NET Standard，而Windows原生BLE支持（Windows.Devices.Bluetooth）属于UWP（Universal Windows Platform）专属API。这意味着：你无法在普通Win32 Player或Editor中直接调用BluetoothLEDevice.FromIdAsync()。很多教程让你安装“Windows SDK”就完事，却没告诉你必须将Unity构建设置切换到UWP平台，并选择D3D编译后端。这是Unity BLE通信最大的隐藏门槛——不是代码写错，而是构建环境没配对。

我踩过的坑：在Unity Editor里写好所有C#脚本，运行时抛出System.TypeLoadException: Could not load type 'Windows.Devices.Bluetooth.BluetoothLEDevice'。查了三天文档才发现，Editor本身不加载UWP API集，必须真机部署到Windows 10/11系统才能运行。解决方案只有两个：要么用UWP构建后在本地运行（推荐），要么用第三方插件如“BLE Client for Unity”（收费且需额外授权）。本文选择前者，因为它是微软官方路径，稳定、免费、无黑盒。

3.2 Unity C#脚本：从扫描到订阅Notify的完整生命周期

以下脚本需放在Unity 2021.3.30f1（LTS）及以上版本，构建设置（File → Build Settings）中选择“Universal Windows Platform”，SDK选“Universal 10”，Target Device选“Any Device”，Build Type选“D3D”。脚本命名为BLEManager.cs，挂载到空GameObject上。

using System; using System.Collections; using System.Runtime.InteropServices; using UnityEngine; using Windows.Devices.Bluetooth; using Windows.Devices.Bluetooth.Advertisement; using Windows.Devices.Bluetooth.GenericAttributeProfile; using Windows.Devices.Enumeration; using Windows.Storage.Streams; public class BLEManager : MonoBehaviour { [Header("BLE Configuration")] public string targetDeviceName = "MySensorHub"; // 必须与Arduino端setLocalName一致 public string serviceUUID = "12345678-1234-1234-1234-123456789012"; public string sensorCharUUID = "abcdef01-1234-1234-1234-123456789012"; public string controlCharUUID = "87654321-1234-1234-1234-123456789012"; private BluetoothLEDevice _bleDevice; private GattDeviceService _service; private GattCharacteristic _sensorChar; private GattCharacteristic _controlChar; private EventHandler<BluetoothLEAdvertisementReceivedEventArgs> _advertisingHandler; void Start() { StartCoroutine(ScanAndConnect()); } IEnumerator ScanAndConnect() { Debug.Log("Starting BLE scan for " + targetDeviceName); // 步骤1：启动广告扫描（UWP要求必须用此方式发现设备） var watcher = BluetoothLEAdvertisementWatcher(); watcher.Received += OnAdvertisementReceived; watcher.Start(); // 等待10秒扫描，超时则停止 yield return new WaitForSeconds(10f); watcher.Stop(); watcher.Received -= OnAdvertisementReceived; if (_bleDevice == null) { Debug.LogError("Failed to find BLE device: " + targetDeviceName); yield break; } Debug.Log("Found device: " + _bleDevice.Name + ", Address: " + _bleDevice.BluetoothAddress); // 步骤2：连接设备 var connStatus = await _bleDevice.GetGattServicesAsync(); if (connStatus.Status != GattCommunicationStatus.Success) { Debug.LogError("Failed to connect to GATT services"); yield break; } // 步骤3：查找指定服务 _service = connStatus.Services.FirstOrDefault(s => s.Uuid.ToString().Equals(serviceUUID, StringComparison.OrdinalIgnoreCase)); if (_service == null) { Debug.LogError("Service not found: " + serviceUUID); yield break; } // 步骤4：查找传感器特征值（Notify） var sensorResult = await _service.GetCharacteristicsForUuidAsync(Guid.Parse(sensorCharUUID)); if (sensorResult.Status != GattCommunicationStatus.Success || sensorResult.Characteristics.Count == 0) { Debug.LogError("Sensor characteristic not found"); yield break; } _sensorChar = sensorResult.Characteristics[0]; // 步骤5：查找控制特征值（Write） var controlResult = await _service.GetCharacteristicsForUuidAsync(Guid.Parse(controlCharUUID)); if (controlResult.Status != GattCommunicationStatus.Success || controlResult.Characteristics.Count == 0) { Debug.LogError("Control characteristic not found"); yield break; } _controlChar = controlResult.Characteristics[0]; // 步骤6：启用Notify订阅（关键！否则收不到Arduino推送） var notifyStatus = await _sensorChar.WriteClientCharacteristicConfigurationDescriptorAsync( GattClientCharacteristicConfigurationDescriptorValue.Notify); if (notifyStatus != GattCommunicationStatus.Success) { Debug.LogError("Failed to enable Notify"); yield break; } Debug.Log("BLE connection established. Subscribed to sensor notifications."); // 步骤7：开始监听Notify事件 _sensorChar.ValueChanged += OnSensorValueChanged; } private void OnAdvertisementReceived(BluetoothLEAdvertisementWatcher sender, BluetoothLEAdvertisementReceivedEventArgs args) { if (args.Advertisement.LocalName == targetDeviceName) { // 找到目标设备，停止扫描并保存设备引用 _bleDevice = args.BluetoothAddress == 0 ? null : BluetoothLEDevice.FromBluetoothAddressAsync(args.BluetoothAddress).AsTask().Result; if (_bleDevice != null) { Debug.Log("Device discovered: " + _bleDevice.Name); sender.Stop(); // 立即停止扫描，避免重复触发 } } } private void OnSensorValueChanged(GattCharacteristic sender, GattValueChangedEventArgs args) { // 将二进制数据转换为float（Arduino端用writeValue((uint8_t*)&temp, sizeof(temp))发送） var reader = DataReader.FromBuffer(args.CharacteristicValue); float temp = reader.ReadSingle(); Debug.Log("Received temperature: " + temp.ToString("F1") + "°C"); // 在Unity中更新UI或触发逻辑（例如：温度>30°C时变红） UpdateTemperatureUI(temp); } private void UpdateTemperatureUI(float temp) { // 示例：更新Text组件显示 var text = GameObject.Find("TempText")?.GetComponent<UnityEngine.UI.Text>(); if (text != null) { text.text = $"Temp: {temp:F1}°C"; text.color = temp > 30f ? Color.red : Color.green; } } // 发送控制指令给Arduino（例如：点亮LED） public async void SendControlCommand(byte cmd) { if (_controlChar == null) return; var writer = new DataWriter(); writer.WriteByte(cmd); // 发送单字节指令 var status = await _controlChar.WriteValueAsync(writer.DetachBuffer()); if (status != GattCommunicationStatus.Success) { Debug.LogError("Failed to write control command"); } } // 辅助方法：创建广告扫描器（UWP必需） private BluetoothLEAdvertisementWatcher BluetoothLEAdvertisementWatcher() { var watcher = new BluetoothLEAdvertisementWatcher(); watcher.ScanningMode = BluetoothLEScanningMode.Active; return watcher; } void OnDestroy() { // 清理资源，防止内存泄漏 _sensorChar?.ValueChanged -= OnSensorValueChanged; _bleDevice?.Dispose(); } }

注意：此脚本依赖UWP API，因此必须在UWP构建后运行。在Unity Editor中会报错，这是正常现象。构建时勾选“Development Build”和“Script Debugging”，方便真机调试。另外，SendControlCommand方法暴露为public，你可以在Button.onClick事件中直接调用bleManager.SendControlCommand(0x01)来点亮LED，实现真正的交互闭环。

3.3 构建与部署：三步完成从Unity到Windows的落地

配置Player Settings：Edit → Project Settings → Player → Other Settings → Target SDK选“Universal 10”，Minimum Platform Version选“10.0.17763.0”（对应Windows 10 1809，确保BLE API可用）。
构建UWP包：File → Build Settings → Platform选“Universal Windows Platform” → Build Type选“D3D” → Click “Build” → 选择空文件夹（如Build/UWP）→ 等待生成.appx包。
安装与运行：进入生成的文件夹，双击Add-AppDevPackage.ps1（右键以PowerShell运行），按提示安装。安装完成后，在开始菜单找到应用图标，点击运行。此时Unity窗口会弹出，控制台显示“BLE connection established”，Arduino板载LED随按钮点击亮灭，温度数值实时刷新——5分钟目标达成。

4. 排查链路：从“找不到设备”到“数据乱码”的全路径诊断

4.1 第一层障碍：Windows系统级蓝牙服务未启用或驱动异常

即使Arduino代码正确、Unity脚本无误，Windows系统层的蓝牙服务状态也会直接阻断整个流程。我遇到过最诡异的一次：Unity构建包在同事电脑上秒连，而我的电脑始终BluetoothLEDevice.FromBluetoothAddressAsync返回null。排查过程如下：

检查蓝牙硬件开关：笔记本物理按键（Fn+F5等）是否开启？任务栏右下角蓝牙图标是否显示“已启用”？右键图标→“打开设置”→确认“蓝牙”开关为开。
验证系统蓝牙功能：打开Windows设置→蓝牙和其他设备→点击“添加蓝牙或其他设备”→选择“蓝牙”→观察是否能扫描到“MySensorHub”。如果系统设置里都搜不到，说明Arduino广播失败或距离过远（nRF52840有效距离约10米无障碍）。
重置蓝牙驱动：设备管理器→蓝牙→右键“Intel(R) Wireless Bluetooth(R)”或“Realtek Bluetooth Adapter”→“卸载设备”→勾选“删除此设备的驱动程序软件”→重启电脑，系统自动重装驱动。这一步解决了我70%的“找不到设备”问题。
禁用其他BLE干扰源：关闭手机蓝牙、智能手表、无线耳机等所有BLE设备。曾有用户反馈，Apple Watch的持续广播会占用Windows蓝牙信道，导致Unity扫描超时。

4.2 第二层障碍：UUID大小写与格式不匹配导致服务查找失败

Arduino端定义的UUID是字符串"12345678-1234-1234-1234-123456789012"，而Unity中Guid.Parse()对字符串格式极其敏感。常见错误包括：

UUID中混入中文标点（如全角短横线“－”而非ASCII短横线“-”）；
字符串末尾有多余空格（Arduino串口打印时易产生）；
Unity脚本中UUID变量名拼写错误（如sensorCharUUID写成sensorCharUuid）；
大小写不一致：虽然GUID本身不区分大小写，但String.Equals()默认区分，必须用StringComparison.OrdinalIgnoreCase。

我在调试时，曾因复制Arduino代码中的UUID时多了一个换行符，导致Guid.Parse()抛出FormatException。解决方案是在Unity脚本中增加校验：

private bool ValidateUUID(string uuidStr) { try { var guid = Guid.Parse(uuidStr.Trim()); // Trim()去除首尾空格 Debug.Log("Valid UUID: " + guid); return true; } catch (Exception e) { Debug.LogError("Invalid UUID format: " + uuidStr + " | Error: " + e.Message); return false; } }

4.3 第三层障碍：Notify订阅失败与数据解析错位

即使连接成功，Unity也可能收不到Arduino推送的数据。根本原因在于：Notify必须显式启用，且数据长度必须严格匹配。Arduino端writeValue((uint8_t*)&temperature, sizeof(temperature))发送4字节float，而Unity端reader.ReadSingle()也必须读取4字节。如果Arduino改用writeValue("HELLO", 5)发送字符串，Unity就必须用reader.ReadString(5)读取，否则ReadSingle()会读取错误字节，解析出NaN或极大值。

我实测过数据错位的典型现象：Arduino发送temperature = 25.3（十六进制00 00 C9 41），UnityReadSingle()正确解析为25.300001；但如果Arduino误写为writeValue(&temperature, 2)（只发2字节），Unity读取时会截断，得到0.000000。解决方案是：在Arduino端Serial Monitor中打印原始字节，用在线Hex转Float工具（如https://www.h-schmidt.net/FloatConverter/IEEE754.html）验证；Unity端用args.CharacteristicValue.ToArray()打印字节数组，对比是否一致。

4.4 第四层障碍：UWP权限缺失导致构建包安装失败

UWP应用需声明蓝牙权限，否则安装后无法调用BLE API。Unity构建时不会自动添加，必须手动编辑Package.appxmanifest文件。步骤如下：

构建UWP包后，用记事本打开Build/UWP/Package.appxmanifest；
在<Capabilities>节点内添加：

<uap:Capability Name="bluetooth" /> <rescap:Capability Name="bluetooth.genericAttributeProfile" />

注意：rescap命名空间需在根节点声明：xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"；
保存文件，重新运行Add-AppDevPackage.ps1。

缺少此配置会导致应用安装成功但运行时报Access is denied，控制台无任何BLE日志——这是最隐蔽的权限问题。

5. 实战扩展：从温度监控到多设备协同的工业级思路

5.1 单设备进阶：添加RSSI信号强度与连接状态可视化

BLE通信质量不仅看数据通不通，更要看连接稳不稳定。ArduinoBLE库提供BLEDevice.rssi()方法获取信号强度（单位dBm），范围通常-100（极弱）到-30（极强）。我在Unity中扩展了状态面板：

// 在BLEManager中添加 private float _rssi; private Text _rssiText; // 引用UI Text组件 // 在OnSensorValueChanged中更新 _rssi = _bleDevice?.ConnectionStatus == BluetoothConnectionStatus.Connected ? _bleDevice.Rssi : 0; _rssiText.text = $"RSSI: {_rssi} dBm"; _rssiText.color = _rssi > -60 ? Color.green : _rssi > -80 ? Color.yellow : Color.red;

实测数据：距离1米时RSSI≈-45dBm，5米时≈-65dBm，10米时≈-85dBm。当RSSI低于-90dBm时，Notify丢包率显著上升，此时可触发Unity UI闪烁警告，提示用户靠近设备。

5.2 多设备协同：用设备地址（MAC）区分不同Arduino节点

一个Unity场景常需连接多个BLE设备（如温湿度+光照+噪声传感器）。Arduino端无法修改MAC地址，但可通过广播数据包（Advertisement Data）携带自定义标识。修改Arduino代码，在setup()中添加：

// 在BLE.advertise()前插入 BLEAdvertisingData advertisingData; advertisingData.setManufacturerData("TEMP_001"); // 自定义字符串 BLE.setAdvertisingData(advertisingData);

Unity端在OnAdvertisementReceived中解析：

string manufacturerData = args.Advertisement.ManufacturerData?.FirstOrDefault()?.Data?.ToString(); if (manufacturerData != null && manufacturerData.Contains("TEMP_001")) { // 识别为1号温感节点 _tempNode = _bleDevice; }

这样，Unity可同时管理多个设备，各自推送不同数据流，互不干扰。

5.3 工业级容错：心跳包机制与自动重连策略

真实项目中，BLE连接可能因干扰临时中断。我设计了一套轻量级心跳机制：Arduino每5秒向sensorChar写入一个递增计数器，Unity端记录最后收到的时间戳。若超过8秒无新数据，则判定断连，触发重连协程：

private float _lastReceiveTime; private const float HEARTBEAT_TIMEOUT = 8f; void Update() { if (Time.time - _lastReceiveTime > HEARTBEAT_TIMEOUT && _bleDevice != null) { Debug.LogWarning("Heartbeat timeout. Attempting auto-reconnect..."); StartCoroutine(ReconnectRoutine()); } } IEnumerator ReconnectRoutine() { // 先清理旧连接 _sensorChar?.ValueChanged -= OnSensorValueChanged; _bleDevice?.Dispose(); // 延迟2秒后重试 yield return new WaitForSeconds(2f); StartCoroutine(ScanAndConnect()); }

实测表明，该策略在Wi-Fi信道拥堵环境下，平均重连耗时3.2秒，用户几乎无感知。

5.4 跨平台延伸：MacOS上的替代方案（CoreBluetooth）

虽然本文聚焦Windows UWP，但MacOS开发者同样可实现。Unity 2022.3+支持macOS原生BLE，原理类似：用CoreBluetooth框架替代UWP API。关键差异在于：

不需要构建UWP包，直接在macOS Player中运行；
使用CBPeripheral和CBCharacteristic类，API命名风格与UWP不同；
广播名扫描用CBCentralManager.ScanForPeripherals；
Notify启用用peripheral.SetNotifyValue(true, characteristic)。

代码结构高度相似，只需替换命名空间和类名。这意味着同一套Arduino固件，可同时服务于Windows和MacOS的Unity项目，真正实现跨平台硬件交互。

我在实际项目中用这套方案交付过三个教育类装置：一个用Unity渲染3D热力图展示教室各角落温度分布，一个用BLE同步控制12个Arduino节点的LED矩阵，还有一个用IMU数据驱动Unity角色动作。每次从零搭建到稳定运行，不超过2小时——因为所有坑都已踩过，所有参数都已调优。现在，你手里的这份指南，就是我压缩了三年实战经验后的“抄作业”模板。

查看全文

http://www.jsqmd.com/news/869208/