BluetoothRemoteGATTCharacteristic
BluetoothRemoteGattCharacteristic
接口是 Web Bluetooth API 的一部分,它表示一个 GATT 特性,GATT 特性是提供有关外设服务更多信息的,基本的的数据元素。
实例属性
BluetoothRemoteGATTCharacteristic.service
只读 实验性-
返回此特性所属的
BluetoothRemoteGATTService
。 BluetoothRemoteGATTCharacteristic.uuid
只读 实验性-
返回一个包含特性的 UUID 的字符串,例如,心率测量特性的 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
,该 Promise 解析为一个DataView
,其中包含value
属性的副本(如果可用并受支持)。否则抛出错误。 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 Bluetooth # bluetoothgattcharacteristic-interface |
浏览器兼容性
BCD 表格仅在浏览器中加载