JavaScript 通过 Web Bluetooth API 可在支持的浏览器中直接与蓝牙低功耗（BLE）设备交互，实现扫描发现、连接断连、读写特征值、订阅通知及服务遍历；需 HTTPS、Chromium 内核、用户授权且仅限 BLE 设备。
JavaScript 通过 Web Bluetooth API 可以在支持的浏览器中直接与蓝牙低功耗（BLE）设备交互，无需原生 App 或插件。它不是操作传统经典蓝牙（如音频耳机），而是面向 BLE 外设（如传感器、手环、开发板等）的现代 Web 标准。
能做什么：核心功能
Web Bluetooth API 提供以下关键能力：
-
扫描并发现附近 BLE 设备：调用
navigator.bluetooth.requestDevice()弹出系统选择框，用户手动选取设备（需用户主动授权） -
连接与断开设备：通过
device.gatt.connect()建立 GATT 连接；支持监听gattserverdisconnected事件处理意外断连 -
读写特征值（Characteristic）：对已知 UUID 的 service 和 characteristic 执行
readValue()、writeValue()、startNotifications()等操作 - 订阅通知（Notifications）和指示（Indications）：让设备在数据变化时主动推送，例如实时接收温湿度传感器更新
-
遍历服务与特征结构：通过
device.gatt.getPrimaryService()和service.getCharacteristics()动态探索设备能力（部分设备需先启用服务发现权限）
使用前提和限制
该 API 并非随处可用，必须满足以下条件：
- 仅支持 HTTPS 网站（
localhost也允许，适合本地开发） - 目前仅 Chromium 内核浏览器稳定支持（Chrome 56+、Edge 79+、Opera）；Firefox 和 Safari 尚未实现或仅实验性支持
- 需要用户显式授权——每次请求设备都触发弹窗，不能静默连接
- 只支持 BLE（Bluetooth 4.0+），不支持经典蓝牙协议（如 A2DP、SPP）
- 部分操作系统需额外配置：macOS 要求 macOS 10.15+；Linux 需 BlueZ 5.4+ 和正确权限（如
bluetooth用户组）
一个最小可运行示例
以下代码点击按钮后请求连接一个提供电池服务（0000180f-0000-1000-8000-00805f9b34fb）的设备，并读取电量：
立即学习“Java免费学习笔记（深入）”；
document.getElementById('connectBtn').addEventListener('click', async () => {
try {
const device = await navigator.bluetooth.requestDevice({
filters: [{ services: ['battery_service'] }], // 或用 UUID 字符串
optionalServices: ['battery_service']
});
const server = await device.gatt.connect();
const service = await server.getPrimaryService('battery_service');
const characteristic = await service.getCharacteristic('battery_level');
const value = await characteristic.readValue();
console.log('电量：', value.getUint8(0) + '%');
} catch (error) {
console.error('操作失败：', error);
}
});
常见注意事项
实际开发中容易踩坑的地方：
- 设备必须处于可被发现（discoverable）且广播（advertising）状态，否则扫描不到
- 读写前务必检查 characteristic 的属性（
properties.read、properties.notify等），否则会报错 - 二进制数据用
DataView或Uint8Array处理，别直接当字符串解析 - 频繁读写或开启通知后记得适时
stopNotifications()和disconnect()，避免资源泄漏 - 移动端 Chrome 在后台标签页可能暂停蓝牙操作，建议引导用户保持前台
基本上就这些。Web Bluetooth 让网页具备了轻量级硬件交互能力，适合做控制面板、调试工具、教育演示等场景，但不适合高实时性或复杂配对流程的应用。
