diff --git a/zh-cn/application-dev/reference/apis-connectivity-kit/js-apis-bluetooth-ble.md b/zh-cn/application-dev/reference/apis-connectivity-kit/js-apis-bluetooth-ble.md index fbb0adb6d54c090d7c82759d050990c3b259f626..f3c4b452235b556d8aabfab75783f261e1e39341 100644 --- a/zh-cn/application-dev/reference/apis-connectivity-kit/js-apis-bluetooth-ble.md +++ b/zh-cn/application-dev/reference/apis-connectivity-kit/js-apis-bluetooth-ble.md @@ -3947,33 +3947,31 @@ try { 描述characteristic的接口参数定义 。 -**原子化服务API**:从API version 12开始,该接口支持在原子化服务中使用。 - **系统能力**:SystemCapability.Communication.Bluetooth.Core | 名称 | 类型 | 可读 | 可写 | 说明 | | ------------------- | ---------------------------------------- | ---- | ---- | ---------------------------------------- | -| serviceUuid | string | 是 | 是 | 特定服务(service)的UUID。例如:00001888-0000-1000-8000-00805f9b34fb。 | -| characteristicUuid | string | 是 | 是 | 特定特征(characteristic)的UUID。例如:00002a11-0000-1000-8000-00805f9b34fb。 | -| characteristicValue | ArrayBuffer | 是 | 是 | 特征对应的二进制值。 | -| descriptors | Array<[BLEDescriptor](#bledescriptor)> | 是 | 是 | 特定特征的描述符列表。 | -| properties | [GattProperties](#gattproperties) | 是 | 是 | 特定特征的属性描述。 | +| serviceUuid | string | 是 | 是 | 特定服务(service)的UUID。例如:00001888-0000-1000-8000-00805f9b34fb。**原子化服务API**:从API version 12开始,该接口支持在原子化服务中使用。| +| characteristicUuid | string | 是 | 是 | 特定特征(characteristic)的UUID。例如:00002a11-0000-1000-8000-00805f9b34fb。**原子化服务API**:从API version 12开始,该接口支持在原子化服务中使用。| +| characteristicValue | ArrayBuffer | 是 | 是 | 特征对应的二进制值。**原子化服务API**:从API version 12开始,该接口支持在原子化服务中使用。| +| descriptors | Array<[BLEDescriptor](#bledescriptor)> | 是 | 是 | 特定特征的描述符列表。**原子化服务API**:从API version 12开始,该接口支持在原子化服务中使用。| +| properties | [GattProperties](#gattproperties) | 是 | 是 | 特定特征的属性描述。**原子化服务API**:从API version 12开始,该接口支持在原子化服务中使用。| +| characteristicValueHandle18+ | number | 是 | 是 | 特征值的唯一标识符。当对端BLE蓝牙设备提供了多个相同UUID的特征值时,可以通过此标识符区分不同的特征值,描述符下同。**原子化服务API**:从API version 18开始,该接口支持在原子化服务中使用。| ## BLEDescriptor 描述descriptor的接口参数定义。 -**原子化服务API**:从API version 12开始,该接口支持在原子化服务中使用。 - **系统能力**:SystemCapability.Communication.Bluetooth.Core | 名称 | 类型 | 可读 | 可写 | 说明 | | ------------------ | ----------- | ---- | ---- | ---------------------------------------- | -| serviceUuid | string | 是 | 是 | 特定服务(service)的UUID。例如:00001888-0000-1000-8000-00805f9b34fb。 | -| characteristicUuid | string | 是 | 是 | 特定特征(characteristic)的UUID。例如:00002a11-0000-1000-8000-00805f9b34fb。 | -| descriptorUuid | string | 是 | 是 | 描述符(descriptor)的UUID。例如:00002902-0000-1000-8000-00805f9b34fb。 | -| descriptorValue | ArrayBuffer | 是 | 是 | 描述符对应的二进制值。 | +| serviceUuid | string | 是 | 是 | 特定服务(service)的UUID。例如:00001888-0000-1000-8000-00805f9b34fb。**原子化服务API**:从API version 12开始,该接口支持在原子化服务中使用。| +| characteristicUuid | string | 是 | 是 | 特定特征(characteristic)的UUID。例如:00002a11-0000-1000-8000-00805f9b34fb。**原子化服务API**:从API version 12开始,该接口支持在原子化服务中使用。| +| descriptorUuid | string | 是 | 是 | 描述符(descriptor)的UUID。例如:00002902-0000-1000-8000-00805f9b34fb。**原子化服务API**:从API version 12开始,该接口支持在原子化服务中使用。| +| descriptorValue | ArrayBuffer | 是 | 是 | 描述符对应的二进制值。**原子化服务API**:从API version 12开始,该接口支持在原子化服务中使用。| +| descriptorHandle18+ | number | 是 | 是 | 描述符的唯一标识符。**原子化服务API**:从API version 18开始,该接口支持在原子化服务中使用。| ## NotifyCharacteristic @@ -4135,16 +4133,15 @@ try { 描述BLE广播数据包的内容,广播包数据长度为31个字节。 -**原子化服务API**:从API version 12开始,该接口支持在原子化服务中使用。 - **系统能力**:SystemCapability.Communication.Bluetooth.Core | 名称 | 类型 | 可读 | 可写 | 说明 | | --------------- | ---------------------------------------- | ---- | ---- | --------------------------- | -| serviceUuids | Array<string> | 是 | 是 | 表示要广播的服务 UUID 列表。 | -| manufactureData | Array<[ManufactureData](#manufacturedata)> | 是 | 是 | 表示要广播的广播的制造商信息列表。 | -| serviceData | Array<[ServiceData](#servicedata)> | 是 | 是 | 表示要广播的服务数据列表。 | -| includeDeviceName | boolean | 是 | 是 | 表示是否携带设备名,可选参数。
true表示携带,false或未设置此参数表示不携带。
注意:带上设备名时广播包长度不能超出31个字节。 | +| serviceUuids | Array<string> | 是 | 是 | 表示要广播的服务 UUID 列表。**原子化服务API**:从API version 12开始,该接口支持在原子化服务中使用。| +| manufactureData | Array<[ManufactureData](#manufacturedata)> | 是 | 是 | 表示要广播的广播的制造商信息列表。**原子化服务API**:从API version 12开始,该接口支持在原子化服务中使用。| +| serviceData | Array<[ServiceData](#servicedata)> | 是 | 是 | 表示要广播的服务数据列表。**原子化服务API**:从API version 12开始,该接口支持在原子化服务中使用。| +| includeDeviceName | boolean | 是 | 是 | 表示是否携带设备名,可选参数。
true表示携带,false或未设置此参数表示不携带。
注意:带上设备名时广播包长度不能超出31个字节。**原子化服务API**:从API version 12开始,该接口支持在原子化服务中使用。| +| includeTxPower18+ | boolean | 是 | 是 | 表示是否携带广播发送功率,可选参数。
true表示携带广播参数,默认值为false。携带该值后,广播报文将多占用3个字节。
注意:带上广播发送功率时广播包长度不能超出31个字节。**原子化服务API**:从API version 18开始,该接口支持在原子化服务中使用。| ## AdvertisingParams11+