Web蓝牙发送数据问题排查与解决方法

第一段引用上面的摘要：本文旨在帮助开发者解决在使用 Web Bluetooth API 向设备发送数据时遇到的问题。通过分析常见错误原因，例如缺少通知启动、服务和特征值查找错误等，提供详细的排查步骤和示例代码，助力开发者顺利实现蓝牙数据传输功能。本文将重点关注characteristic.startNotifications() 的重要性，并提供调试建议。

在使用 Web Bluetooth API 进行数据传输时，开发者可能会遇到数据无法发送或发送后设备未响应的问题。这通常与以下几个方面有关：蓝牙连接、服务和特征值的查找，以及数据发送过程中的配置。本文将重点关注这些方面，并提供详细的排查和解决步骤。

1. 确保已启动通知 (Notifications)

在使用 Web Bluetooth API 与蓝牙设备通信时，一个常见的错误是忘记启动特征值的通知功能。 许多蓝牙设备需要客户端订阅特征值的变化才能接收数据。 这通常通过调用characteristic.startNotifications()方法来实现。

const sendStringToDevice = async () => {
    try {
        // Request Bluetooth device
        const device = await navigator.bluetooth.requestDevice({
            filters: [{ name: 'monocle' }],
            optionalServices: [0x2A00],
        });

        // Connect to the device
        const server = await device.gatt.connect();

        // Get the specified service
        const service = await server.getPrimaryService(0x2A00); // 使用服务 UUID

        // Get the specified characteristic
        const characteristic = await service.getCharacteristic(0x2A05); // 使用特征 UUID

        // **重要：启动通知**
        await characteristic.startNotifications();

        characteristic.addEventListener('characteristicvaluechanged',
            (event) => {
                // 从 event.target.value 读取数据
                const value = event.target.value;
                // 将 ArrayBuffer 转换为字符串
                let decoder = new TextDecoder('utf-8');
                let decodedString = decoder.decode(value);
                console.log('Received: ' + decodedString);
            });

        // Convert the string to a UInt8Array (assuming ASCII encoding)
        const encoder = new TextEncoder('utf-8');
        const data = encoder.encode(message);

        // Send the data to the characteristic
        await characteristic.writeValue(data);

        console.log(`String "${message}" sent successfully to monocle`);
    } catch (error) {
        console.error('Error sending string to Bluetooth device:', error);
    }
};

注意事项:

• characteristic.startNotifications() 必须在发送数据之前调用。
• 某些设备可能需要特定的权限才能启动通知。请参考设备文档。
• 启动通知后，需要监听 characteristicvaluechanged 事件来接收来自设备的数据。

2. 检查服务和特征值的 UUID

确保你使用的服务和特征值的 UUID 是正确的。错误的 UUID 会导致无法找到对应的服务或特征值，从而导致数据发送失败。 可以通过设备的文档或使用蓝牙扫描工具来确认 UUID。 在上面的代码示例中，我使用了 getPrimaryService(0x2A00) 和 getCharacteristic(0x2A05)，请确保替换为你实际使用的服务和特征值的 UUID。

3. 错误处理和调试

当遇到问题时，仔细检查浏览器的开发者工具中的控制台输出。 错误消息通常会提供有关问题的线索。 此外，可以使用 try...catch 块来捕获潜在的错误，并进行相应的处理。 确保你的 console.log 语句能够执行，如果在发送数据前后都没有输出，那么问题可能出现在连接建立或服务/特征值查找阶段。

4. 权限问题

某些浏览器或操作系统可能需要用户授予蓝牙权限才能访问蓝牙设备。 确保你的应用程序已获得必要的权限。

5. 数据格式

确保你发送的数据格式与设备期望的格式一致。 例如，某些设备可能需要特定的编码方式或数据长度。

6. 总结

在使用 Web Bluetooth API 发送数据时，需要仔细检查连接状态、服务和特征值的 UUID、通知设置、权限以及数据格式。通过仔细排查这些方面，可以解决大多数数据发送问题。characteristic.startNotifications() 的调用至关重要，请务必确保在发送数据之前调用它。 此外，充分利用浏览器的开发者工具进行调试，可以帮助你更快地找到问题所在。