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

BluetoothDevice 是 Web 蓝牙 API 的接口，表示特定脚本执行环境中的蓝牙设备。

接口

interface BluetoothDevice {
  readonly attribute DOMString id;
  readonly attribute DOMString? name;
  readonly attribute BluetoothRemoteGATTServer? gatt;
  readonly attribute FrozenArray uuids;

  Promise watchAdvertisements();
  void unwatchAdvertisements();
  readonly attribute boolean watchingAdvertisements;
};
BluetoothDevice implements EventTarget;
BluetoothDevice implements BluetoothDeviceEventHandlers;
BluetoothDevice implements CharacteristicEventHandlers;
BluetoothDevice implements ServiceEventHandlers;

属性

BluetoothDevice.id 只读

一个 DOMString，唯一标识一个设备。

BluetoothDevice.name 只读

一个 DOMString，表示设备可读名称。

BluetoothDevice.gatt 只读

对设备的 BluetoothRemoteGATTServer 的引用。

BluetoothDevice.uuids 只读

列出设备允许提供的当前来源访问的 GATT 服务的 UUID。

BluetoothDevice.watchingAdvertisements 只读

是否使用 BluetoothDevice.watchAdvertisements() 激活了广告。

非标准的 Chrome 操作系统属性

这些属性仅在 Google 的 Chrome OS 45 上实现，并已从 Chrome 52 中删除。

BluetoothDevice.adData 只读

一个 BluetoothAdvertisingData 实例，其中包含该设备收到的最新广告数据。

BluetoothDevice.deviceClass 只读

一个数字，表示蓝牙设备 “设备类别”。

BluetoothDevice.vendorIDSource 只读

device_information 服务 pnp_id 特性中的供应商 ID 来源字段。

BluetoothDevice.vendorID 只读

device_information 服务 pnp_id 特性中的 16 位供应商 ID 字段。

BluetoothDevice.productID 只读

device_information 服务 pnp_id 特性中的 16 位产品 ID 字段。

BluetoothDevice.productVersion 只读

device_information 服务 pnp_id特性中的 16 位产品版本字段。

BluetoothDevice.paired 只读

一个 Boolean 值，指示设备是否与系统配对。

BluetoothDevice.gattServer 只读

对设备 GATT 服务器的引用；如果设备已断开连接，则为 null。

方法

BluetoothDevice.watchAdvertisments()

一个 Promise，解析为 undefined，如果由于任何原因而无法显示广告，则会被拒绝并显示错误。

BluetoothDevice.unwatchAdvertisments()

停止观看广告。

BluetoothDevice.connectGATT()

一个 Promise，解析为 BluetoothRemoteGATTServer 实例。

规范

规范	状态	备注
Web Bluetooth BluetoothDevice 的定义	草稿	初始定义。

桌面浏览器兼容性

移动浏览器兼容性