Web Bluetooth API

Bluetooth

提供查询蓝牙可用性和请求访问设备的方法。

BluetoothCharacteristicProperties (en-US)

提供特定的 BluetoothRemoteGATTCharacteristic 属性。

BluetoothDevice (en-US)

表示特定脚本执行环境中的蓝牙设备。

BluetoothRemoteGATTCharacteristic (en-US)

表示 GATT 特性，提供有关外设服务进一步信息。

BluetoothRemoteGATTDescriptor (en-US)

表示 GATT 描述符，提供有关特性值的进一步信息。

BluetoothRemoteGATTServer (en-US)

表示远程设备上的 GATT 服务器。

BluetoothRemoteGATTService (en-US)

表示 GATT 服务器提供的一项服务，包括设备、相关服务列表和该服务的特征列表。

Bluetooth API 扩展了以下 API，添加了列出的特性。

Navigator.bluetooth

返回一个当前 document 的 Bluetooth 对象，提供对 Web Bluetooth API 功能的访问。

Web Bluetooth API 只能在安全的上下文中使用。

对此 API 的访问由权限策略中的 bluetooth (en-US) 指令控制。bluetooth 策略的默认白名单是 self，它允许在同源嵌套框架中使用蓝牙，但默认禁止第三方内容访问。如要启用跨源访问，需要同时在 Permissions-Policy: bluetooth HTTP 请求标头和所需的 <iframe> 中指定允许的来源。

要使用该特性，用户必须首先显式地授予权限（如果由于其他原因不允许访问，例如被权限策略阻止，则不会弹出提示）。当调用 Bluetooth.requestDevice() 请求访问未授权的新蓝牙设备时，将显示权限提示（拥有的全局对象还必须具有 transient activation (en-US)）。你可以使用 Bluetooth.getDevices() (en-US) 来检索先前已被授予站点权限的任何设备。

Permissions API (en-US) 中的 navigator.permissions.query() (en-US) 方法可以与 bluetooth 权限一起使用，用于测试站点是否具有使用蓝牙设备的权限。权限状态会是 granted、denied 或 prompt（需要用户确认提示）：

const btPermission = await navigator.permissions.query({ name: "bluetooth" });
if (btPermission.state !== "denied") {
  // 执行操作
}