【亲测免费】 BLE for Unity 3D 在 Windows 上的安装与配置完全指南

BLE for Unity 3D 在 Windows 上的安装与配置完全指南

项目基础介绍

BleWinrtDll 是一个专为 Unity 3D 开发者设计的开源项目，它使得开发者能够在不使用通用Windows平台(UWP)的情况下，在Windows系统上实现蓝牙低功耗(BLE)的功能。此项目基于微软的蓝牙低能量样本，并通过C++/WinRT封装部分UWP BLE API到一个DLL中，以便于在Unity项目中直接使用。项目采用的主要编程语言为 C++ 和少量 C#。

关键技术和框架

• C++/WinRT: 用于创建和封装Windows Runtime组件，允许在非UWP环境中访问Windows 10的现代API。
• Unity 3D: 强大的游戏开发引擎，支持跨平台游戏及应用开发。
• WTFPL License: 一种自由度极高的软件授权协议，几乎不限制对代码的任何使用。

安装和配置步骤

准备工作

1. 安装Unity: 确保你的电脑上已安装最新或指定版本的Unity编辑器。
2. 下载Visual Studio: 至少需要社区版2019及以上，确保包含了C++桌面开发环境和UWP的支持。
3. 环境组件: 安装“MSVC C++ Buildtools”、“Windows 10 SDK”/“Windows 11 SDK”(根据操作系统)以及“.NET Framework 4.7.2 SDK”。

安装步骤

第一步：获取项目源码

1. 使用Git克隆项目到本地：git clone https://github.com/adabru/BleWinrtDll.git

第二步：编译DLL

1. 打开BleWinrtDll.sln文件，可能需要通过Visual Studio安装缺失的组件。
2. 设置项目配置为“Release”模式，并选择适合您机器的架构，通常是“x64”。
3. 编译BleWinrtDll项目。如果遇到编译错误，请参照仓库中的Issue说明解决，例如wait_for成员错误可能需额外处理。
4. 成功编译后，找到编译产物x64\Release\BleWinrtDll.dll。

第三步：集成到Unity项目

1. 打开或创建一个新的Unity项目。
2. 将编译好的BleWinrtDll.dll复制到Unity项目的Assets目录下。
3. （可选）导入BleWinrtDll Unity目录以获得示例场景和脚本，理解如何在Unity中调用这些DLL函数。
4. 在Unity编辑器中，你可能需要调整脚本中的常量或变量，如targetDeviceName, serviceUuid, 和 characteristicUuids以匹配你想要连接的特定BLE设备。

第四步：测试与配置

1. 运行Unity中的Demo场景，确认蓝牙设备能够被发现并与之交互。
2. 根据实际需求，可能会涉及到修改脚本中的线程管理策略，推荐使用非阻塞调用或在Unity中妥善管理线程生命周期。

注意事项

• 分发Windows独立构建时，确保目标设备已安装必要的Microsoft Visual C++ Redistributable。
• 对于HoloLens 2等特殊设备，需要遵循仓库中的特定配置指导。

完成上述步骤，你就能够成功地在Unity项目中使用BLE功能，无需依赖UWP环境了。