BluetoothRemoteGATTCharacteristic

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

BluetoothRemoteGATTCharacteristic 接口是 Web Bluetooth API 的一部分,它代表一个 GATT 特征(Characteristic)。GATT 特征是提供设备服务(peripheral's service)更多信息的基本数据元素。

EventTarget BluetoothRemoteGATTCharacteristic

实例属性

BluetoothRemoteGATTCharacteristic.service 只读 实验性

返回此特征所属的 BluetoothRemoteGATTService

BluetoothRemoteGATTCharacteristic.uuid 只读 实验性

返回一个包含该特征 UUID 的字符串,例如,心率测量(Heart Rate Measurement)特征的 UUID 是 '00002a37-0000-1000-8000-00805f9b34fb'

BluetoothRemoteGATTCharacteristic.properties 只读 实验性

返回此特征的属性。

BluetoothRemoteGATTCharacteristic.value 只读 实验性

当前缓存的特征值。当特征的值通过通知或指示读取或更新时,此值会更新。

实例方法

BluetoothRemoteGATTCharacteristic.getDescriptor() 实验性

返回一个 Promise,该 Promise 解析为给定描述符 UUID 的第一个 BluetoothRemoteGATTDescriptor

BluetoothRemoteGATTCharacteristic.getDescriptors() 实验性

返回一个 Promise,该 Promise 解析为给定描述符 UUID 的所有 BluetoothRemoteGATTDescriptor 对象的 Array

BluetoothRemoteGATTCharacteristic.readValue() 实验性

返回一个 Promise,如果 value 属性可用且受支持,则该 Promise 解析为包含 value 属性副本的 DataView。否则,它将抛出错误。

BluetoothRemoteGATTCharacteristic.writeValue() 已弃用

value 属性设置为给定 ArrayBuffer 中包含的字节,以可选响应写入特征值,并返回生成的 Promise

BluetoothRemoteGATTCharacteristic.writeValueWithResponse() 实验性

value 属性设置为给定 ArrayBuffer 中包含的字节,以必需响应写入特征值,并返回生成的 Promise

BluetoothRemoteGATTCharacteristic.writeValueWithoutResponse() 实验性

value 属性设置为给定 ArrayBuffer 中包含的字节,无响应写入特征值,并返回生成的 Promise

BluetoothRemoteGATTCharacteristic.startNotifications() 实验性

返回一个 Promise,当 navigator.bluetooth 被添加到活动通知上下文时,该 Promise 会解析。

BluetoothRemoteGATTCharacteristic.stopNotifications() 实验性

返回一个 Promise,当 navigator.bluetooth 从活动通知上下文中移除时,该 Promise 会解析。

事件

characteristicvaluechanged 实验性

BluetoothRemoteGATTCharacteristic 的值发生变化时,会在此对象上触发。

规范

规范
Web 蓝牙
# bluetoothgattcharacteristic-interface

浏览器兼容性