Web Bluetooth数据写入指南：解决特征值操作阻塞问题

Web Bluetooth API基础流程概述

web bluetooth api允许网页与近距离的低功耗蓝牙（ble）设备进行通信。其基本操作流程通常包括以下几个步骤：请求设备、连接到gatt服务器、获取服务、获取特征值，然后才能进行读写操作。

1. 请求设备 (Request Device): 使用navigator.bluetooth.requestDevice()方法发现并选择附近的蓝牙设备。通常会通过filters参数指定设备名称、服务UUID等条件。
2. 连接到GATT服务器 (Connect to GATT Server): 一旦用户选择了设备，通过device.gatt.connect()方法建立与设备GATT服务器的连接。
3. 获取主要服务 (Get Primary Service): 连接成功后，需要获取设备提供的特定蓝牙服务。服务是特征值的集合，通过UUID进行标识。可以使用server.getPrimaryService(serviceUUID)或server.getPrimaryServices()。
4. 获取特征值 (Get Characteristic): 在获取到服务后，需要进一步获取该服务下的特定特征值。特征值是实际存储或传输数据的地方，同样通过UUID标识。可以使用service.getCharacteristic(characteristicUUID)。
5. 执行操作 (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代码示例，演示了如何正确地连接设备、获取服务和特征值，并在写入数据前启用通知：

英特尔AI工具

英特尔AI与机器学习解决方案

70

查看详情

/**
 * 向蓝牙设备发送字符串数据
 * @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。

注意事项与最佳实践

1. UUIDs的准确性: 蓝牙通信严重依赖于正确的服务和特征值UUIDs。务必使用设备制造商提供的准确UUIDs。错误的UUIDs将导致无法找到服务或特征值。
2. 特征值属性检查: 在进行读写操作前，建议检查特征值的属性（characteristic.properties），确保它支持你尝试进行的操作（例如，characteristic.properties.write 应为 true）。
3. 异步操作与await: Web Bluetooth API是高度异步的。务必在每个返回Promise的方法前使用await关键字，以确保操作按顺序执行。
4. 错误处理: 使用try-catch块捕获潜在的蓝牙通信错误。错误信息通常能提供有价值的调试线索。
5. 设备兼容性与实现差异: 不同的蓝牙设备和固件实现可能对Web Bluetooth API有不同的行为。在开发过程中，务必针对目标设备进行充分测试。
6. 断开连接与资源释放: 在完成通信或应用程序关闭时，考虑调用device.gatt.disconnect()来释放蓝牙资源。
7. 权限管理: 浏览器会要求用户授权Web页面访问蓝牙设备。确保在用户界面中清晰地引导用户进行授权。

总结

当Web Bluetooth的writeValue操作出现阻塞时，一个常见的解决方案是确保在写入数据前调用await characteristic.startNotifications()。虽然startNotifications主要用于订阅设备通知，但在某些设备实现中，它可能作为激活数据通道或满足特定协议要求的隐含步骤。结合正确的服务和特征值UUIDs、充分的错误处理以及对蓝牙协议栈的理解，可以有效解决数据传输中的“卡住”问题，确保Web Bluetooth应用的稳定运行。

以上就是Web Bluetooth数据写入指南：解决特征值操作阻塞问题的详细内容，更多请关注php中文网其它相关文章！