告别过时教程！用C#和InTheHand.Net.Bluetooth NuGet包搞定UWP蓝牙通信（附完整代码）
现代UWP蓝牙开发实战：基于InTheHand.Net.Bluetooth的完整解决方案
在物联网设备普及的今天，蓝牙通信已成为移动应用开发中的常见需求。许多C#开发者转向UWP平台开发蓝牙应用时，往往会遇到一个尴尬的问题——网上大量教程仍在使用已过时的InTheHand.Net.Personal.dll，而微软官方推荐的最新NuGet包InTheHand.Net.Bluetooth却鲜有系统性的中文资料。本文将带你从零开始，使用现代工具链构建一个完整的UWP蓝牙通信解决方案。
1. 环境准备与NuGet包配置
1.1 创建UWP项目
首先在Visual Studio 2022中创建一个空白UWP项目。确保目标版本和最低版本都设置为Windows 10版本1809或更高，这是使用新版蓝牙API的最低要求。
// 包引用配置 <PackageReference Include="InTheHand.Net.Bluetooth" Version="4.0.5" />1.2 权限配置
UWP应用访问蓝牙设备需要声明相关能力。在Package.appxmanifest文件中添加以下代码：
<Capabilities> <DeviceCapability Name="bluetooth" /> </Capabilities>注意：如果目标设备支持蓝牙LE，还需要添加
bluetooth.genericAttributeProfile能力
2. 蓝牙设备发现与连接
2.1 设备发现实现
新版库提供了更简洁的设备发现API。以下代码展示了如何异步发现周围蓝牙设备：
public async Task DiscoverDevicesAsync() { var client = new BluetoothClient(); var devices = await client.DiscoverDevicesAsync(maxDevices: 10); foreach(var device in devices) { Debug.WriteLine($"发现设备: {device.DeviceName} - {device.DeviceAddress}"); } }2.2 设备连接优化
连接蓝牙设备时，我们需要注意几个关键点：
- 连接超时处理
- 设备状态验证
- 异常处理机制
public async Task<bool> ConnectToDeviceAsync(BluetoothDeviceInfo device) { try { var client = new BluetoothClient(); await client.ConnectAsync(device.DeviceAddress, BluetoothService.SerialPort, TimeSpan.FromSeconds(5)); return client.Connected; } catch(BluetoothConnectionException ex) { Debug.WriteLine($"连接失败: {ex.Message}"); return false; } }3. 数据传输实现
3.1 数据接收处理
接收数据时需要处理字节流转换和缓冲区管理。以下是改进后的数据接收方法：
public async Task StartReceivingAsync(BluetoothClient client) { var stream = client.GetStream(); byte[] buffer = new byte[1024]; while(client.Connected) { try { int bytesRead = await stream.ReadAsync(buffer, 0, buffer.Length); if(bytesRead > 0) { string data = Encoding.UTF8.GetString(buffer, 0, bytesRead); Debug.WriteLine($"收到数据: {data}"); } } catch(Exception ex) { Debug.WriteLine($"接收错误: {ex.Message}"); break; } } }3.2 数据发送实现
发送数据时需要注意数据分块和编码处理：
public async Task SendDataAsync(BluetoothClient client, string message) { if(!client.Connected) throw new InvalidOperationException("蓝牙未连接"); var stream = client.GetStream(); byte[] data = Encoding.UTF8.GetBytes(message); await stream.WriteAsync(data, 0, data.Length); await stream.FlushAsync(); }4. 实战技巧与常见问题
4.1 新旧API对比
下表展示了新旧版本库的主要差异：
| 特性 | 旧版(Personal.dll) | 新版(Bluetooth NuGet) |
|---|---|---|
| 命名空间 | InTheHand.Net.Personal | InTheHand.Net.Bluetooth |
| 设备发现 | DiscoverDevices() | DiscoverDevicesAsync() |
| 连接方式 | 同步连接 | 支持异步连接 |
| 平台支持 | 有限 | 完整UWP支持 |
| 维护状态 | 已废弃 | 活跃维护 |
4.2 性能优化建议
- 缓冲区管理：根据设备特性调整缓冲区大小
- 连接池：对频繁连接的设备实现连接池
- 异常恢复：实现自动重连机制
- 资源释放：确保及时释放蓝牙资源
// 资源释放示例 public void Dispose() { _client?.Dispose(); _receiveCancellationTokenSource?.Cancel(); }4.3 调试技巧
- 使用Windows自带的"蓝牙LE Explorer"工具测试设备
- 在设备管理器中检查蓝牙驱动状态
- 使用Wireshark抓取蓝牙HCI数据包
- 在代码中添加详细的日志记录
5. 完整示例项目结构
一个组织良好的蓝牙通信项目应该包含以下组件：
/BluetoothService ├── IBluetoothService.cs // 接口定义 ├── BluetoothServiceImpl.cs // 具体实现 ├── Models │ ├── BluetoothDevice.cs // 设备模型 │ └── BluetoothMessage.cs // 消息模型 └── Exceptions ├── BluetoothConnectionException.cs └── BluetoothDiscoveryException.cs核心服务接口设计：
public interface IBluetoothService { Task<IEnumerable<BluetoothDevice>> DiscoverDevicesAsync(); Task ConnectAsync(BluetoothDevice device); Task DisconnectAsync(); Task SendMessageAsync(string message); IObservable<string> MessageReceived { get; } bool IsConnected { get; } }在实际项目中，我发现最有效的调试方式是在关键节点添加状态日志。例如，在连接状态变化时记录详细参数，这能帮助快速定位间歇性连接问题的根源。