JavaScript通过Web Bluetooth API实现与蓝牙低功耗设备的交互，需用户授权并满足HTTPS、现代浏览器等条件；1. 调用requestDevice选择设备；2. 连接GATT服务器；3. 获取服务与特征值；4. 读取或监听数据；仅支持BLE、需手动触发、兼容性有限，尤其iOS不支持。
JavaScript 实现蓝牙连接和硬件交互，主要依赖于 Web Bluetooth API，它允许网页在用户授权的前提下与附近的蓝牙低功耗（BLE, Bluetooth Low Energy）设备进行通信。这种技术广泛应用于物联网（IoT）、智能穿戴设备、健康监测仪器等场景中。
Web Bluetooth API 基础
Web Bluetooth 让浏览器可以直接发现、连接并读写 BLE 外设的数据。该功能目前主要支持现代浏览器如 Chrome、Edge 和部分基于 Chromium 的浏览器，不支持 Safari 和 IE。
使用前需确保：
- 设备支持蓝牙 4.0 或以上版本
- 浏览器启用且支持 Web Bluetooth
- 网站运行在 HTTPS 环境下（本地开发可使用
localhost）
连接蓝牙设备的步骤
通过 JavaScript 连接蓝牙设备通常包括以下流程：
Java 接口排错助手
下载
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
立即学习“Java免费学习笔记（深入）”；
1. 请求设备调用
navigator.bluetooth.requestDevice() 弹出选择框，让用户选择目标设备。
const device = await navigator.bluetooth.requestDevice({
filters: [{ services: ['battery_service'] }], // 按服务筛选
optionalServices: ['battery_service'] // 后续操作需要的服务
});
2. 建立 GATT 连接获取设备的 GATT 服务器并连接。
const server = await device.gatt.connect();3. 获取服务和特征值
通过服务 UUID 获取特定服务，再获取其中的特征（Characteristic）。
const service = await server.getPrimaryService('battery_service');
const characteristic = await service.getCharacteristic('battery_level');
4. 读取或监听数据可以读取当前值或开启通知持续接收更新。
// 读取一次
const value = await characteristic.readValue();
console.log('电量:', value.getUint8(0));
// 监听变化
await characteristic.startNotifications();
characteristic.addEventListener('characteristicvaluechanged', (event) => {
const val = event.target.value;
console.log('实时电量:', val.getUint8(0));
});
实际应用场景示例
假设你有一个自定义的 BLE 设备，广播一个名为 "HeartRateMonitor" 的服务，你可以这样连接：
const device = await navigator.bluetooth.requestDevice({
filters: [
{ namePrefix: 'HR_' } // 名称以 HR_ 开头的设备
],
optionalServices: ['heart_rate']
});
const server = await device.gatt.connect();
const service = await server.getPrimaryService('heart_rate');
const char = await service.getCharacteristic('heart_rate_measurement');
await char.startNotifications();
char.addEventListener('characteristicvaluechanged', (e) => {
const data = e.target.value;
// 解析心率数据（具体格式参考 BLE 标准）
const heartRate = data.getUint8(1);
console.log('当前心率:', heartRate);
});
注意事项与限制
虽然 Web Bluetooth 提供了便捷的硬件交互方式，但仍有一些关键限制：
- 仅支持 BLE 设备，不能连接经典蓝牙（如音箱、键盘）
- 必须由用户主动触发连接操作（比如点击按钮），不能自动扫描
- 权限控制严格，用户每次都需要确认设备选择
- 不同设备的 UUID 和数据格式各异，需查阅设备文档正确解析
- 移动端兼容性差，Android 支持较好，iOS 基本不支持
基本上就这些。只要设备符合规范，配合正确的服务和特征 UUID，JavaScript 就能轻松实现与硬件的数据交互。不复杂但容易忽略细节，尤其是数据解析部分，建议结合官方 BLE 规范文档一起调试。
