Web Bluetooth API 浏览器支持
发布于 更新于
navigator.bluetooth.requestDevice() 返回一个 Promise,兑现值是符合所给条件的蓝牙设备。浏览器没有设备选择器界面时,它会返回第一个符合条件的设备。它的浏览器支持数据来自 BCD 的 api.Bluetooth.requestDevice 键。
Chrome 桌面版与 Android 版从 56 起支持 requestDevice(),Edge 从 79 起支持,Samsung Internet 从 6.0 起支持,Opera 从 43 起支持。BCD 没有记录 Firefox 桌面版和 Android 版、macOS 与 iOS 上的 Safari,以及 Android WebView 的支持。Firefox 与 WebKit 的实现跟踪地址列在对应行中。
- 图例
- 支持
- 部分支持
- 需开启标志
- 不支持
- 未知
| 浏览器 / 平台 | 支持 | 版本 | 置信度 | 来源 | 备注 |
|---|---|---|---|---|---|
| Chrome (Desktop)# | 支持 | 56 | 高 | 来源 | — |
| Chrome (Android)# | 支持 | 56 | 高 | 来源 | 1 |
| Edge (Desktop)# | 支持 | 79 | 高 | 来源 | 2 |
| Firefox (Desktop)# | 不支持 | — | 高 | 来源 | 3 |
| Firefox (Android)# | 不支持 | — | 高 | 来源 | 45 |
| Safari (macOS)# | 不支持 | — | 高 | 来源 | 6 |
| Safari (iOS)# | 不支持 | — | 高 | 来源 | 78 |
| Samsung Internet# | 支持 | 6.0 | 高 | 来源 | 9 |
| WebView (Android)# | 不支持 | — | 高 | 来源 | 10 |
| Opera# | 支持 | 43 | 高 | 来源 | 11 |
- 由 browser-compat-data 镜像自 Chrome 的数据推导。
- 由 browser-compat-data 镜像自 Chrome 的数据推导。
- 实现跟踪:https://bugzil.la/674737。
- 实现跟踪:https://bugzil.la/674737。
- 由 browser-compat-data 镜像自 Firefox 的数据推导。
- 实现跟踪:https://webkit.org/b/101034。
- 实现跟踪:https://webkit.org/b/101034。
- 由 browser-compat-data 镜像自 Safari 的数据推导。
- 由 browser-compat-data 镜像自 Chrome Android 的数据推导。
- browser-compat-data 未记录 WebView Android 的支持。
- 镜像 Chrome 的实现(BCD `opera: mirror`):Linux 上有支持,但默认未启用。
请求设备
链接到“请求设备”一节navigator.bluetooth 返回当前文档的 Bluetooth 对象。requestDevice() 接收筛选选项,并返回一个 Promise;兑现值是符合条件的 BluetoothDevice。接口只在安全上下文中开放,WorkerNavigator 不提供它,因此设备选择要从文档发起。
选项中必须提供 filters,或把 acceptAllDevices 设为 true。筛选条件可以匹配广播出来的 GATT 服务、设备名或名称前缀。用户选定设备后,当前源只能访问 filters.services 与 optionalServices 列出的服务。若筛选条件只写设备名,还要把应用需要的服务放进 optionalServices。
网站首次请求某台设备时,requestDevice() 会显示权限提示;调用所在的全局对象还要有瞬时用户激活。因此应把调用直接放进点按处理函数。下面的代码先检测接口;没有支持时禁用按钮并显示页内说明。
const button = document.createElement('button');button.textContent = '连接蓝牙设备';const status = document.createElement('p');document.body.append(button, status);
if (!('bluetooth' in navigator)) { button.disabled = true; status.textContent = '此浏览器无法连接蓝牙设备。';} else { button.addEventListener('click', async () => { try { const device = await navigator.bluetooth.requestDevice({ filters: [{ services: ['battery_service'] }], }); status.textContent = device.name ?? '已选择蓝牙设备'; } catch (error) { status.textContent = `${error.name}: ${error.message}`; } });}检测分支会在请求权限之前准备好可见的兜底结果。浏览器支持接口时,点按按钮会查找广播 Battery Service 的设备。Promise 返回的对象标识用户选定的设备;如何打开 GATT 连接、读取 characteristic,可继续查看 Web Bluetooth 参考条目。
权限与嵌入
链接到“权限与嵌入”一节bluetooth Permissions Policy 控制接口访问。默认允许列表为 self,同源嵌套 frame 可以使用,第三方内容默认不能使用。跨源 frame 需要同时在 Permissions-Policy 响应头与 iframe 的 allow 属性中写入允许的源。策略拦截后,权限提示不会出现。
Bluetooth.getDevices() 可以返回此前已获当前网站授权的设备。Permissions API 查询 bluetooth 权限时,状态为 granted、denied 或 prompt。这些相关方法各有自己的 BCD 支持数据。
另请参阅
链接到“另请参阅”一节- Web Bluetooth API:连接蓝牙低功耗设备
- WebUSB API 浏览器支持
- Web Bluetooth 规范(Web Bluetooth Community Group)
- Web Bluetooth API(developer.mozilla.org)