From 611e1631f652f6d01ba1d9455f43519ae24bddb5 Mon Sep 17 00:00:00 2001 From: linzlinz <2495670683@qq.com> Date: Mon, 28 Apr 2025 10:57:35 +0800 Subject: [PATCH 1/2] docs bugfix Signed-off-by: linzlinz <2495670683@qq.com> --- .../reference/apis-connectivity-kit/js-apis-bluetooth-ble.md | 3 +++ 1 file changed, 3 insertions(+) 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 fbb0adb6d54..d25ec7dc811 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 @@ -3958,6 +3958,7 @@ try { | characteristicValue | ArrayBuffer | 是 | 是 | 特征对应的二进制值。 | | descriptors | Array<[BLEDescriptor](#bledescriptor)> | 是 | 是 | 特定特征的描述符列表。 | | properties | [GattProperties](#gattproperties) | 是 | 是 | 特定特征的属性描述。 | +| characteristicValueHandle | number | 是 | 是 | 特征对应的特征值句柄。 | ## BLEDescriptor @@ -3974,6 +3975,7 @@ try { | characteristicUuid | string | 是 | 是 | 特定特征(characteristic)的UUID。例如：00002a11-0000-1000-8000-00805f9b34fb。 | | descriptorUuid | string | 是 | 是 | 描述符(descriptor)的UUID。例如：00002902-0000-1000-8000-00805f9b34fb。 | | descriptorValue | ArrayBuffer | 是 | 是 | 描述符对应的二进制值。 | +| descriptorHandle | number | 是 | 是 | 描述符对应的句柄。 | ## NotifyCharacteristic @@ -4145,6 +4147,7 @@ try { | manufactureData | Array<[ManufactureData](#manufacturedata)> | 是 | 是 | 表示要广播的广播的制造商信息列表。 | | serviceData | Array<[ServiceData](#servicedata)> | 是 | 是 | 表示要广播的服务数据列表。 | | includeDeviceName | boolean | 是 | 是 | 表示是否携带设备名，可选参数。
true表示携带，false或未设置此参数表示不携带。
注意：带上设备名时广播包长度不能超出31个字节。 | +| includeTxPower | boolean | 是 | 是 | 表示是否携带发送功率，可选参数。
true表示携带，false或未设置此参数表示不携带。
注意：带上发送功率时广播包长度不能超出31个字节。 | ## AdvertisingParams11+ -- Gitee From 267ab2261bf3b19474e1e97569700dd59abc7315 Mon Sep 17 00:00:00 2001 From: linzlinz <2495670683@qq.com> Date: Mon, 12 May 2025 22:24:52 +0800 Subject: [PATCH 2/2] add docs Signed-off-by: linzlinz <2495670683@qq.com> --- .../js-apis-bluetooth-ble.md | 38 ++++++++----------- 1 file changed, 16 insertions(+), 22 deletions(-) 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 d25ec7dc811..f3c4b452235 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,35 +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) | 是 | 是 | 特定特征的属性描述。 | -| characteristicValueHandle | number | 是 | 是 | 特征对应的特征值句柄。 | +| 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 | 是 | 是 | 描述符对应的二进制值。 | -| descriptorHandle | number | 是 | 是 | 描述符对应的句柄。 | +| 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 @@ -4137,17 +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个字节。 | -| includeTxPower | 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+ -- Gitee