BluetoothRemoteGATTCharacteristic

可用性有限

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

实验性: 这是一个 实验性技术
在生产环境中使用此功能之前,请仔细查看 浏览器兼容性表

安全上下文:此功能仅在 安全上下文(HTTPS)中可用,在某些或所有 支持的浏览器 中。

BluetoothRemoteGattCharacteristic 接口是 Web Bluetooth API 的一部分,它表示一个 GATT 特性,GATT 特性是提供有关外设服务更多信息的,基本的的数据元素。

EventTarget BluetoothRemoteGATTCharacteristic

实例属性

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 表格仅在浏览器中加载