如何用Web Bluetooth API控制蓝牙设备？

Web Bluetooth API 可实现网页与BLE设备通信，通过 requestDevice 选择设备并连接 GATT 服务器，读写特征值或监听数据变化，需在 HTTPS 环境下使用且仅支持 Chromium 浏览器。

Web Bluetooth API 让网页可以直接与附近的蓝牙低功耗（BLE）设备进行通信，无需安装原生应用。它适用于控制智能灯、传感器、健康设备等支持 BLE 的外设。下面介绍如何使用该 API 实现基本的连接与数据交互。

请求设备并建立连接

要使用 Web Bluetooth，第一步是让用户选择一个可用的蓝牙设备。通过 navigator.bluetooth.requestDevice() 方法触发设备选择弹窗。

你需要指定设备需要支持的服务（如心率服务 'heart_rate' 或自定义的 UUID）。例如，连接一个带自定义服务的设备：

const device = await navigator.bluetooth.requestDevice({
  filters: [{ services: ['battery_service'] }], // 按服务过滤
  optionalServices: ['device_information']     // 需要访问其他服务时添加
});

用户从列表中选择设备后，浏览器会尝试建立 GATT 连接：

const server = await device.gatt.connect();

读取和写入特征值（Characteristics）

连接成功后，可以通过远程 GATT 服务器获取服务和特征值。特征值是实际传输数据的单元，分为读、写、通知等类型。

例如，从电池服务中读取当前电量：

const service = await server.getPrimaryService('battery_service');
const characteristic = await service.getCharacteristic('battery_level');
const value = await characteristic.readValue();
const batteryLevel = value.getUint8(0);
console.log(`电量：${batteryLevel}%`);

若要向设备发送指令（比如打开灯光），可使用 writeValue 或 writeValueWithResponse：

蓝心千询

蓝心千询是vivo推出的一个多功能AI智能助手

34

查看详情

const lightChar = await service.getCharacteristic('light_control');
await lightChar.writeValue(new Uint8Array([1])); // 发送开灯命令

监听设备数据变化（开启通知）

某些设备会主动推送数据（如心率监测器）。你需要启用特征值的通知功能来实时接收更新。

设置监听如下：

const sensorChar = await service.getCharacteristic('heart_rate_measurement');
sensorChar.addEventListener('characteristicvaluechanged', (event) => {
  const value = event.target.value;
  console.log('心率:', value.getUint8(1));
});
await sensorChar.startNotifications();

注意事项与兼容性

Web Bluetooth 目前仅在基于 Chromium 的浏览器（如 Chrome、Edge）上支持，且必须运行在 HTTPS 环境下（localhost 除外）。

常见限制包括：

• 只能访问 BLE 设备，不支持经典蓝牙
• 部分操作系统权限需手动开启
• 长时间无操作可能导致连接断开

建议在用户操作（如点击按钮）后调用 requestDevice，避免自动弹窗被拦截。

基本上就这些。只要设备服务公开且格式明确，Web Bluetooth 能轻松实现网页端控制。关键是理解 GATT 结构和服务 UUID 的匹配方式。不复杂但容易忽略细节。

以上就是如何用Web Bluetooth API控制蓝牙设备？的详细内容，更多请关注php中文网其它相关文章！