Web Bluetooth API
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Web Bluetooth API 提供了与低功耗蓝牙设备进行连接和交互的能力。
备注:此 API 在 Web Worker 中不可用(未通过 WorkerNavigator
暴露)。
接口
Bluetooth
-
提供查询蓝牙可用性和请求访问设备的方法。
BluetoothCharacteristicProperties
-
提供特定的
BluetoothRemoteGATTCharacteristic
属性。 BluetoothDevice
-
表示特定脚本执行环境中的蓝牙设备。
BluetoothRemoteGATTCharacteristic
-
表示 GATT 特性,提供有关外设服务进一步信息。
BluetoothRemoteGATTDescriptor
-
表示 GATT 描述符,提供有关特性值的进一步信息。
BluetoothRemoteGATTServer
-
表示远程设备上的 GATT 服务器。
BluetoothRemoteGATTService
-
表示 GATT 服务器提供的一项服务,包括设备、相关服务列表和该服务的特征列表。
对其他接口的扩展
Bluetooth API 扩展了以下 API,添加了列出的特性。
Navigator
-
返回一个当前 document 的
Bluetooth
对象,提供对 Web Bluetooth API 功能的访问。
安全注意事项
Web Bluetooth API 只能在安全的上下文中使用。
对此 API 的访问由权限策略中的 bluetooth
指令控制。bluetooth
策略的默认白名单是 self
,它允许在同源嵌套框架中使用蓝牙,但默认禁止第三方内容访问。如要启用跨源访问,需要同时在 Permissions-Policy: bluetooth
HTTP 请求标头和所需的 <iframe>
中指定允许的来源。
要使用该特性,用户必须首先显式地授予权限(如果由于其他原因不允许访问,例如被权限策略阻止,则不会弹出提示)。当调用 Bluetooth.requestDevice()
请求访问未授权的新蓝牙设备时,将显示权限提示(拥有的全局对象还必须具有 transient activation)。你可以使用 Bluetooth.getDevices()
来检索先前已被授予站点权限的任何设备。
Permissions API 中的 navigator.permissions.query()
方法可以与 bluetooth
权限一起使用,用于测试站点是否具有使用蓝牙设备的权限。权限状态会是 granted
、denied
或 prompt
(需要用户确认提示):
const btPermission = await navigator.permissions.query({ name: "bluetooth" });
if (btPermission.state !== "denied") {
// 执行操作
}
规范
Specification |
---|
Web Bluetooth # bluetooth |
浏览器兼容性
BCD tables only load in the browser