Web Bluetooth API基础流程概述
web bluetooth api允许网页与近距离的低功耗蓝牙（ble）设备进行通信。其基本操作流程通常包括以下几个步骤：请求设备、连接到gatt服务器、获取服务、获取特征值，然后才能进行读写操作。
- 请求设备 (Request Device): 使用navigator.bluetooth.requestDevice()方法发现并选择附近的蓝牙设备。通常会通过filters参数指定设备名称、服务UUID等条件。
- 连接到GATT服务器 (Connect to GATT Server): 一旦用户选择了设备，通过device.gatt.connect()方法建立与设备GATT服务器的连接。
- 获取主要服务 (Get Primary Service): 连接成功后，需要获取设备提供的特定蓝牙服务。服务是特征值的集合，通过UUID进行标识。可以使用server.getPrimaryService(serviceUUID)或server.getPrimaryServices()。
- 获取特征值 (Get Characteristic): 在获取到服务后，需要进一步获取该服务下的特定特征值。特征值是实际存储或传输数据的地方，同样通过UUID标识。可以使用service.getCharacteristic(characteristicUUID)。
- 执行操作 (Perform Operations): 获取到特征值后，即可对其进行读（readValue）、写（writeValue）或订阅通知（startNotifications/stopNotifications）等操作。
核心问题分析：为何数据写入会“卡住”？
在Web Bluetooth开发中，开发者有时会遇到writeValue操作无响应，既不成功也不报错的情况，导致程序“卡住”。这通常是由于以下一个或多个原因造成的：
- UUIDs不匹配或未指定: getPrimaryService()和getCharacteristic()方法在未指定UUID时，行为可能不符合预期，或者返回的服务/特征值并非目标。
- 特征值属性不符: 尝试对一个不支持写入操作的特征值进行writeValue。每个特征值都有其定义的属性（如读、写、通知），必须确保操作与属性匹配。
- 设备或服务实现要求: 尽管startNotifications()主要用于订阅设备发来的数据更新，但在某些蓝牙设备的实现中，即使是执行writeValue操作，也可能要求对应的特征值或服务处于“通知已启用”的状态。这可能是一种设备内部的握手机制，确保数据通道的完整性。如果缺少这一步，设备可能不会响应写入请求，导致JavaScript侧的Promise无法解析或拒绝。
解决方案：启用特征值通知 (startNotifications)
针对上述“卡住”的问题，一个常见的且有效的解决方案是在执行writeValue之前，先调用await characteristic.startNotifications()。
startNotifications()方法的作用是启用设备对该特征值的通知功能。当特征值的数据在设备端发生变化时，设备会主动向Web页面发送通知。虽然这看起来与写入数据无关，但在某些设备和蓝牙协议栈的实现中，启用通知被视为一种激活数据通道或确认连接状态的隐含要求。通过调用它，即使不需要接收通知，也可能“解锁”后续的写入操作。
修正后的代码示例
以下是一个修正后的JavaScript代码示例，演示了如何正确地连接设备、获取服务和特征值，并在写入数据前启用通知：
/**
* 向蓝牙设备发送字符串数据
* @param {string} message 要发送的字符串
*/
const sendStringToDevice = async (message) => {
try {
// 1. 请求蓝牙设备
// filters用于过滤设备，optionalServices用于声明将要访问的服务，确保浏览器在配对时请求这些权限
const device = await navigator.bluetooth.requestDevice({
filters: [{ name: 'monocle' }], // 根据设备名称过滤
optionalServices: [0x2A00, 'YOUR_SERVICE_UUID_HERE'], // 示例服务UUID，请替换为实际服务的UUID
});
console.log(`已找到设备: ${device.name}`);
// 2. 连接到设备GATT服务器
const server = await device.gatt.connect();
console.log('已连接到GATT服务器');
// 3. 获取指定服务
// 假设要连接的服务UUID是 'YOUR_SERVICE_UUID_HERE' (例如，可以是自定义的UUID或标准UUID)
// 0x2A00 是 Generic Access Service，通常用于设备信息，实际应用数据服务通常是自定义UUID
const serviceUUID = 'YOUR_SERVICE_UUID_HERE'; // *** 请替换为实际的服务UUID ***
const service = await server.getPrimaryService(serviceUUID);
console.log(`已获取服务: ${serviceUUID}`);
// 4. 获取指定特征值
// 假设要写入的特征值UUID是 'YOUR_CHARACTERISTIC_UUID_HERE'
const characteristicUUID = 'YOUR_CHARACTERISTIC_UUID_HERE'; // *** 请替换为实际的特征值UUID ***
const characteristic = await service.getCharacteristic(characteristicUUID);
console.log(`已获取特征值: ${characteristicUUID}`);
// 5. 启用特征值通知 (关键步骤：即使是写入操作，某些设备也可能需要此步骤)
// 这一步通常用于订阅设备发来的通知，但有时也是写入操作成功的前置条件。
await characteristic.startNotifications();
console.log(`特征值 ${characteristicUUID} 通知已启用`);
// 6. 准备要发送的数据
const encoder = new TextEncoder('utf-8');
const data = encoder.encode(message);
console.log(`准备发送数据: ${message} (字节: ${data})`);
// 7. 发送数据到特征值
await characteristic.writeValue(data);
console.log(`字符串 "${message}" 已成功发送到 ${device.name}`);
} catch (error) {
console.error('发送字符串到蓝牙设备时出错:', error);
// 可以在这里添加更详细的错误处理，例如断开连接或提示用户
} finally {
// 可选：在操作完成后断开连接，或者保持连接以便后续操作
// if (device && device.gatt.connected) {
// device.gatt.disconnect();
// console.log('设备已断开连接');
// }
}
};
// 示例调用
// sendStringToDevice("Hello from Web Bluetooth!");重要提示:
- 请将 YOUR_SERVICE_UUID_HERE 和 YOUR_CHARACTERISTIC_UUID_HERE 替换为你的蓝牙设备实际使用的服务和特征值UUID。这些UUIDs通常由设备制造商提供，或通过蓝牙扫描工具（如Chrome DevTools的Web Bluetooth选项卡）进行发现。
- 0x2A00 是标准的“Generic Access Service” UUID，通常不用于应用数据传输。应用数据通常使用自定义的128位UUID。
注意事项与最佳实践
- UUIDs的准确性: 蓝牙通信严重依赖于正确的服务和特征值UUIDs。务必使用设备制造商提供的准确UUIDs。错误的UUIDs将导致无法找到服务或特征值。
- 特征值属性检查: 在进行读写操作前，建议检查特征值的属性（characteristic.properties），确保它支持你尝试进行的操作（例如，characteristic.properties.write 应为 true）。
- 异步操作与await: Web Bluetooth API是高度异步的。务必在每个返回Promise的方法前使用await关键字，以确保操作按顺序执行。
- 错误处理: 使用try-catch块捕获潜在的蓝牙通信错误。错误信息通常能提供有价值的调试线索。
- 设备兼容性与实现差异: 不同的蓝牙设备和固件实现可能对Web Bluetooth API有不同的行为。在开发过程中，务必针对目标设备进行充分测试。
- 断开连接与资源释放: 在完成通信或应用程序关闭时，考虑调用device.gatt.disconnect()来释放蓝牙资源。
- 权限管理: 浏览器会要求用户授权Web页面访问蓝牙设备。确保在用户界面中清晰地引导用户进行授权。
总结
当Web Bluetooth的writeValue操作出现阻塞时，一个常见的解决方案是确保在写入数据前调用await characteristic.startNotifications()。虽然startNotifications主要用于订阅设备通知，但在某些设备实现中，它可能作为激活数据通道或满足特定协议要求的隐含步骤。结合正确的服务和特征值UUIDs、充分的错误处理以及对蓝牙协议栈的理解，可以有效解决数据传输中的“卡住”问题，确保Web Bluetooth应用的稳定运行。
