@doubao-dev/plugin-app-dev 0.0.0-stage → 0.0.40-canary-dea0ddc73-20261026073950

package/dist/skills/doubao-plugin-app/references/frontend/doubao-agentic-service-api/16-/350/223/235/347/211/231.md

@@ -0,0 +1,3364 @@
+# 豆包应用插件的端能力 API: 蓝牙
+
+蓝牙和 BLE 能力；通常先打开适配器，再扫描、连接和读写。
+
+[返回目录](./groups.md) | [返回速查](./quick-reference.md)
+
+## 速查
+
+| API | 说明 |
+| --- | --- |
+| [openBluetoothAdapter](#openbluetoothadapter) | 打开蓝牙适配器。 |
+| [startBluetoothDevicesDiscovery](#startbluetoothdevicesdiscovery) | 开始搜索附近的蓝牙设备。 |
+| [stopBluetoothDevicesDiscovery](#stopbluetoothdevicesdiscovery) | 停止搜索附近的蓝牙设备。 |
+| [getBluetoothAdapterState](#getbluetoothadapterstate) | 获取蓝牙适配器状态。 |
+| [getBluetoothDevices](#getbluetoothdevices) | 获取当前蓝牙模块发现的设备列表。 |
+| [getConnectedBluetoothDevices](#getconnectedbluetoothdevices) | 获取已连接的蓝牙设备列表。 |
+| [makeBluetoothPair](#makebluetoothpair) | 发起蓝牙配对。 |
+| [isBluetoothDevicePaired](#isbluetoothdevicepaired) | 查询蓝牙设备是否已经配对。 |
+| [closeBluetoothAdapter](#closebluetoothadapter) | 关闭蓝牙适配器。 |
+| [createBLEConnection](#createbleconnection) | 创建 BLE 连接。 |
+| [closeBLEConnection](#closebleconnection) | 关闭 BLE 连接。 |
+| [getBLEDeviceServices](#getbledeviceservices) | 获取 BLE 服务列表。 |
+| [getBLEDeviceCharacteristics](#getbledevicecharacteristics) | 获取 BLE 特征值列表。 |
+| [getBLEDeviceRSSI](#getbledevicerssi) | 获取 BLE 设备 RSSI。 |
+| [getBLEMTU](#getblemtu) | 获取 BLE MTU。 |
+| [notifyBLECharacteristicValueChange](#notifyblecharacteristicvaluechange) | 订阅 BLE 特征值变化。 |
+| [readBLECharacteristicValue](#readblecharacteristicvalue) | 读取 BLE 特征值。 |
+| [setBLEMTU](#setblemtu) | 设置 BLE MTU。 |
+| [writeBLECharacteristicValue](#writeblecharacteristicvalue) | 写入 BLE 特征值。 |
+| [onBluetoothAdapterStateChange](#onbluetoothadapterstatechange) | 注册蓝牙适配器状态变化回调。<br><br>返回取消监听函数。 |
+| [onBluetoothDeviceFound](#onbluetoothdevicefound) | 注册发现蓝牙设备回调。<br><br>返回取消监听函数。 |
+| [onBLEConnectionStateChange](#onbleconnectionstatechange) | 注册 BLE 连接状态变化回调。<br><br>返回取消监听函数。 |
+| [onBLECharacteristicValueChange](#onblecharacteristicvaluechange) | 注册 BLE 特征值变化回调。<br><br>返回取消监听函数。 |
+
+## API 详情
+
+<a id="openbluetoothadapter"></a>
+### openBluetoothAdapter()
+
+# openBluetoothAdapter
+
+打开蓝牙适配器。
+
+## 扫码预览
+![扫码预览 openBluetoothAdapter](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fdevice%252Fbluetooth-adapter%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.25`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android、iOS</td><td>使用蓝牙能力需要系统蓝牙权限，Android 低版本扫描附近设备还需定位权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- 首次使用蓝牙能力时会触发系统蓝牙权限申请；用户拒绝后调用失败，需引导用户在系统设置中开启蓝牙权限
+
+## 使用说明
+
+蓝牙流程入口。
+
+- 蓝牙流程入口，后续搜索、连接能力都需要先成功打开适配器
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+openBluetoothAdapter(params?: object): Promise<object>
+```
+
+## 入参
+
+无。
+
+## 调用示例
+
+```typescript
+import { openBluetoothAdapter } from '@doubao-dev/framework/api';
+
+await openBluetoothAdapter();
+```
+
+## 成功返回
+
+无返回字段。
+
+### 返回示例
+
+```json
+{}
+```
+
+## 错误处理
+
+错误对象和通用错误码见 [通用错误处理](./common-errors.md#错误返回)。
+
+### 错误码
+
+#### 通用错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>说明</th><th>平台</th></tr>
+</thead>
+<tbody>
+<tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android、iOS</td></tr>
+<tr><td><code>106</code></td><td><code>system permission denied</code></td><td>系统权限未授予</td><td>Android、iOS</td></tr>
+<tr><td><code>116</code></td><td><code>resource not found</code></td><td>资源不存在</td><td>Android、iOS</td></tr>
+<tr><td><code>118</code></td><td><code>already exists</code></td><td>资源已存在</td><td>Android、iOS</td></tr>
+</tbody>
+</table>
+
+<a id="startbluetoothdevicesdiscovery"></a>
+### startBluetoothDevicesDiscovery()
+
+# startBluetoothDevicesDiscovery
+
+开始搜索附近的蓝牙设备。
+
+## 扫码预览
+![扫码预览 startBluetoothDevicesDiscovery](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fdevice%252Fbluetooth-discovery%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.25`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android、iOS</td><td>扫描附近蓝牙设备需要系统蓝牙权限，Android 低版本还需定位权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- 首次搜索时会触发系统蓝牙权限申请；用户拒绝后调用失败，需引导用户在系统设置中开启蓝牙权限
+
+### 前置条件
+
+- 需先调用 openBluetoothAdapter 打开蓝牙适配器
+
+## 使用说明
+
+通常先调用 openBluetoothAdapter。
+
+- 通过 onBluetoothDeviceFound 接收扫描结果，不再需要搜索时应调用 stopBluetoothDevicesDiscovery 以降低功耗
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+startBluetoothDevicesDiscovery(params?: StartBluetoothDevicesDiscoveryParams): Promise<object>
+```
+
+## 入参
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必填</th><th>默认值</th><th>约束</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>allowDuplicatesKey</code></td><td><code>boolean</code></td><td>否</td><td><code>false</code></td><td>-</td><td>是否允许重复上报同一设备。</td></tr>
+<tr><td><code>interval</code></td><td><code>number</code></td><td>否</td><td><code>由平台使用默认上报间隔</code></td><td>-</td><td>上报设备的间隔，单位毫秒。</td></tr>
+<tr><td><code>powerLevel</code></td><td><code>BluetoothPowerLevel</code></td><td>否</td><td><code>medium</code></td><td>-</td><td>扫描功耗等级。</td></tr>
+<tr><td><code>services</code></td><td><code>string[]</code></td><td>否</td><td><code>不按服务 UUID 过滤</code></td><td>-</td><td>按主服务 UUID 过滤搜索范围。</td></tr>
+</tbody>
+</table>
+
+## 调用示例
+
+```typescript
+import { openBluetoothAdapter, startBluetoothDevicesDiscovery } from '@doubao-dev/framework/api';
+
+await openBluetoothAdapter();
+await startBluetoothDevicesDiscovery({ allowDuplicatesKey: false });
+```
+
+## 成功返回
+
+无返回字段。
+
+### 返回示例
+
+```json
+{}
+```
+
+## 错误处理
+
+错误对象和通用错误码见 [通用错误处理](./common-errors.md#错误返回)。
+
+### 错误码
+
+#### 通用错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>说明</th><th>平台</th></tr>
+</thead>
+<tbody>
+<tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android、iOS</td></tr>
+<tr><td><code>104</code></td><td><code>invalid parameter</code></td><td>参数不合法</td><td>Android、iOS</td></tr>
+<tr><td><code>106</code></td><td><code>system permission denied</code></td><td>系统权限未授予</td><td>Android、iOS</td></tr>
+<tr><td><code>116</code></td><td><code>resource not found</code></td><td>资源不存在</td><td>Android、iOS</td></tr>
+<tr><td><code>118</code></td><td><code>already exists</code></td><td>资源已存在</td><td>Android、iOS</td></tr>
+</tbody>
+</table>
+
+<a id="stopbluetoothdevicesdiscovery"></a>
+### stopBluetoothDevicesDiscovery()
+
+# stopBluetoothDevicesDiscovery
+
+停止搜索附近的蓝牙设备。
+
+## 扫码预览
+![扫码预览 stopBluetoothDevicesDiscovery](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fdevice%252Fbluetooth-discovery%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.25`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android、iOS</td><td>使用蓝牙能力需要系统蓝牙权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- 依赖 openBluetoothAdapter 阶段已获得的系统蓝牙权限；权限被拒绝或在系统设置中撤销后调用失败，需引导用户在系统设置中开启蓝牙权限
+
+### 前置条件
+
+- 需先调用 startBluetoothDevicesDiscovery 开始搜索
+
+## 使用说明
+
+- 搜索到目标设备后应尽快停止搜索以降低功耗
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+stopBluetoothDevicesDiscovery(params?: object): Promise<object>
+```
+
+## 入参
+
+无。
+
+## 调用示例
+
+```typescript
+import { stopBluetoothDevicesDiscovery } from '@doubao-dev/framework/api';
+
+await stopBluetoothDevicesDiscovery();
+```
+
+## 成功返回
+
+无返回字段。
+
+### 返回示例
+
+```json
+{}
+```
+
+## 错误处理
+
+错误对象和通用错误码见 [通用错误处理](./common-errors.md#错误返回)。
+
+### 错误码
+
+#### 通用错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>说明</th><th>平台</th></tr>
+</thead>
+<tbody>
+<tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android、iOS</td></tr>
+<tr><td><code>116</code></td><td><code>resource not found</code></td><td>资源不存在</td><td>Android、iOS</td></tr>
+</tbody>
+</table>
+
+<a id="getbluetoothadapterstate"></a>
+### getBluetoothAdapterState()
+
+# getBluetoothAdapterState
+
+获取蓝牙适配器状态。
+
+## 扫码预览
+![扫码预览 getBluetoothAdapterState](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fdevice%252Fbluetooth-adapter%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.25`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android、iOS</td><td>使用蓝牙能力需要系统蓝牙权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- 依赖 openBluetoothAdapter 阶段已获得的系统蓝牙权限；权限被拒绝或在系统设置中撤销后调用失败，需引导用户在系统设置中开启蓝牙权限
+
+### 前置条件
+
+- 需先调用 openBluetoothAdapter 打开蓝牙适配器
+
+## 使用说明
+
+- 通过 available 判断蓝牙是否可用，discovering 判断是否正在搜索
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+getBluetoothAdapterState(params?: object): Promise<GetBluetoothAdapterStateResult>
+```
+
+## 入参
+
+无。
+
+## 调用示例
+
+```typescript
+import { getBluetoothAdapterState } from '@doubao-dev/framework/api';
+
+const { available, discovering } = await getBluetoothAdapterState();
+
+console.log(available, discovering);
+```
+
+## 成功返回
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>available</code></td><td><code>boolean</code></td><td>是</td><td>蓝牙适配器是否可用。</td></tr>
+<tr><td><code>discovering</code></td><td><code>boolean</code></td><td>是</td><td>是否正在搜索蓝牙设备。</td></tr>
+</tbody>
+</table>
+
+### 返回示例
+
+```json
+{
+  "available": true,
+  "discovering": false
+}
+```
+
+## 错误处理
+
+错误对象和通用错误码见 [通用错误处理](./common-errors.md#错误返回)。
+
+### 错误码
+
+#### 通用错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>说明</th><th>平台</th></tr>
+</thead>
+<tbody>
+<tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android、iOS</td></tr>
+<tr><td><code>116</code></td><td><code>resource not found</code></td><td>资源不存在</td><td>Android、iOS</td></tr>
+</tbody>
+</table>
+
+<a id="getbluetoothdevices"></a>
+### getBluetoothDevices()
+
+# getBluetoothDevices
+
+获取当前蓝牙模块发现的设备列表。
+
+## 扫码预览
+![扫码预览 getBluetoothDevices](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fdevice%252Fbluetooth-discovery%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.25`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android、iOS</td><td>使用蓝牙能力需要系统蓝牙权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- 依赖 openBluetoothAdapter 阶段已获得的系统蓝牙权限；权限被拒绝或在系统设置中撤销后调用失败，需引导用户在系统设置中开启蓝牙权限
+
+### 前置条件
+
+- 需先调用 startBluetoothDevicesDiscovery 开始搜索
+
+## 使用说明
+
+通常先调用 startBluetoothDevicesDiscovery。
+
+- `advertisData` 与 `serviceData` 以 ArrayBuffer 返回
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+getBluetoothDevices(params: object): Promise<GetBluetoothDevicesResult>
+```
+
+## 入参
+
+无。
+
+## 调用示例
+
+```typescript
+import { getBluetoothDevices } from '@doubao-dev/framework/api';
+
+const { devices } = await getBluetoothDevices();
+
+console.log(devices.map((device) => device.name));
+```
+
+## 成功返回
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>devices</code></td><td><code>BluetoothDevice[]</code></td><td>是</td><td>当前蓝牙模块已发现的设备列表。</td></tr>
+<tr><td><code>devices[].advertisData</code></td><td><code>ArrayBuffer</code></td><td>否</td><td>广播二进制数据。</td></tr>
+<tr><td><code>devices[].advertisServiceUUIDs</code></td><td><code>string[]</code></td><td>否</td><td>广播中的服务 UUID 列表。</td></tr>
+<tr><td><code>devices[].connectable</code></td><td><code>boolean</code></td><td>否</td><td>是否可连接。</td></tr>
+<tr><td><code>devices[].deviceId</code></td><td><code>string</code></td><td>是</td><td>设备 ID。</td></tr>
+<tr><td><code>devices[].localName</code></td><td><code>string</code></td><td>否</td><td>广播中的本地名称。</td></tr>
+<tr><td><code>devices[].name</code></td><td><code>string</code></td><td>是</td><td>设备名称。</td></tr>
+<tr><td><code>devices[].RSSI</code></td><td><code>number</code></td><td>是</td><td>RSSI 信号强度，单位 dBm。</td></tr>
+<tr><td><code>devices[].serviceData</code></td><td><code>BluetoothBinaryField</code></td><td>否</td><td>广播中的服务数据。</td></tr>
+</tbody>
+</table>
+
+### 返回示例
+
+```json
+{
+  "devices": [
+    {
+      "deviceId": "device-id",
+      "name": "Doubao BLE",
+      "RSSI": -60,
+      "connectable": true
+    }
+  ]
+}
+```
+
+## 错误处理
+
+错误对象和通用错误码见 [通用错误处理](./common-errors.md#错误返回)。
+
+### 错误码
+
+#### 通用错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>说明</th><th>平台</th></tr>
+</thead>
+<tbody>
+<tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android、iOS</td></tr>
+<tr><td><code>116</code></td><td><code>resource not found</code></td><td>资源不存在</td><td>Android、iOS</td></tr>
+</tbody>
+</table>
+
+<a id="getconnectedbluetoothdevices"></a>
+### getConnectedBluetoothDevices()
+
+# getConnectedBluetoothDevices
+
+获取已连接的蓝牙设备列表。
+
+## 扫码预览
+![扫码预览 getConnectedBluetoothDevices](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fdevice%252Fbluetooth-discovery%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.25`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android、iOS</td><td>使用蓝牙能力需要系统蓝牙权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- 依赖 openBluetoothAdapter 阶段已获得的系统蓝牙权限；权限被拒绝或在系统设置中撤销后调用失败，需引导用户在系统设置中开启蓝牙权限
+
+### 前置条件
+
+- 需先调用 openBluetoothAdapter 打开蓝牙适配器
+
+## 使用说明
+
+- 需传入主服务 UUID 列表 services 才能过滤出目标设备
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+getConnectedBluetoothDevices(params: GetConnectedBluetoothDevicesParams): Promise<GetConnectedBluetoothDevicesResult>
+```
+
+## 入参
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必填</th><th>默认值</th><th>约束</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>services</code></td><td><code>string[]</code></td><td>是</td><td>-</td><td>-</td><td>蓝牙主服务 UUID 列表。</td></tr>
+</tbody>
+</table>
+
+## 调用示例
+
+```typescript
+import { getConnectedBluetoothDevices } from '@doubao-dev/framework/api';
+
+const { devices } = await getConnectedBluetoothDevices({
+  services: ['0000180D-0000-1000-8000-00805F9B34FB']
+});
+
+console.log(devices);
+```
+
+## 成功返回
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>devices</code></td><td><code>ConnectedBluetoothDevice[]</code></td><td>是</td><td>已连接设备列表。</td></tr>
+<tr><td><code>devices[].deviceId</code></td><td><code>string</code></td><td>是</td><td>设备 ID。</td></tr>
+<tr><td><code>devices[].name</code></td><td><code>string</code></td><td>是</td><td>设备名称。</td></tr>
+</tbody>
+</table>
+
+### 返回示例
+
+```json
+{
+  "devices": [
+    {
+      "deviceId": "device-id",
+      "name": "Doubao BLE"
+    }
+  ]
+}
+```
+
+## 错误处理
+
+错误对象和通用错误码见 [通用错误处理](./common-errors.md#错误返回)。
+
+### 错误码
+
+#### 通用错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>说明</th><th>平台</th></tr>
+</thead>
+<tbody>
+<tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android、iOS</td></tr>
+<tr><td><code>104</code></td><td><code>invalid parameter</code></td><td>参数不合法</td><td>Android、iOS</td></tr>
+<tr><td><code>116</code></td><td><code>resource not found</code></td><td>资源不存在</td><td>Android、iOS</td></tr>
+</tbody>
+</table>
+
+<a id="makebluetoothpair"></a>
+### makeBluetoothPair()
+
+# makeBluetoothPair
+
+发起蓝牙配对。
+
+## 扫码预览
+![扫码预览 makeBluetoothPair](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fdevice%252Fbluetooth-connection%252Findex)
+
+## 使用限制
+
+> [!WARNING]
+> **iOS**：豆包 iOS 的 makeBluetoothPair 固定返回不支持；iOS 上调用无法发起蓝牙配对。
+
+## 支持版本
+
+前端库版本不低于 `0.0.25`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>不支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android</td><td>发起配对需要系统蓝牙权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- **Android**：依赖已获得的系统蓝牙权限；权限被拒绝或在系统设置中撤销后调用失败，需引导用户在系统设置中开启蓝牙权限
+
+### 前置条件
+
+- **Android**：需先调用 openBluetoothAdapter 打开蓝牙适配器
+
+## 使用说明
+
+- 该能力仅在 Android 生效，iOS 调用会返回不支持
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+makeBluetoothPair(params: MakeBluetoothPairParams): Promise<object>
+```
+
+## 入参
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必填</th><th>默认值</th><th>约束</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>deviceId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>蓝牙设备 ID。</td></tr>
+<tr><td><code>pin</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>配对 PIN 码。</td></tr>
+<tr><td><code>timeout</code></td><td><code>number</code></td><td>否</td><td><code>20000</code></td><td>-</td><td>超时时间，单位毫秒。</td></tr>
+</tbody>
+</table>
+
+## 调用示例
+
+```typescript
+import { makeBluetoothPair } from '@doubao-dev/framework/api';
+
+await makeBluetoothPair({
+  deviceId: 'device-id',
+  pin: '000000',
+  timeout: 10000
+});
+```
+
+## 成功返回
+
+无返回字段。
+
+### 返回示例
+
+```json
+{}
+```
+
+## 错误处理
+
+错误对象和通用错误码见 [通用错误处理](./common-errors.md#错误返回)。
+
+### 错误码
+
+#### 通用错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>说明</th><th>平台</th></tr>
+</thead>
+<tbody>
+<tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android</td></tr>
+<tr><td><code>103</code></td><td><code>feature not support</code></td><td>当前环境不支持该能力</td><td>iOS</td></tr>
+<tr><td><code>104</code></td><td><code>invalid parameter</code></td><td>参数不合法</td><td>Android</td></tr>
+<tr><td><code>106</code></td><td><code>system permission denied</code></td><td>系统权限未授予</td><td>Android</td></tr>
+<tr><td><code>114</code></td><td><code>operation cancelled</code></td><td>操作已取消</td><td>Android</td></tr>
+<tr><td><code>115</code></td><td><code>operation timeout</code></td><td>操作超时</td><td>Android</td></tr>
+<tr><td><code>116</code></td><td><code>resource not found</code></td><td>资源不存在</td><td>Android</td></tr>
+<tr><td><code>118</code></td><td><code>already exists</code></td><td>资源已存在</td><td>Android</td></tr>
+</tbody>
+</table>
+
+<a id="isbluetoothdevicepaired"></a>
+### isBluetoothDevicePaired()
+
+# isBluetoothDevicePaired
+
+查询蓝牙设备是否已经配对。
+
+## 扫码预览
+![扫码预览 isBluetoothDevicePaired](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fdevice%252Fbluetooth-connection%252Findex)
+
+## 使用限制
+
+> [!WARNING]
+> **iOS**：豆包 iOS 的 isBluetoothDevicePaired 固定返回不支持；iOS 上调用无法查询设备是否已配对。
+
+## 支持版本
+
+前端库版本不低于 `0.0.25`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>不支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android</td><td>查询配对状态需要系统蓝牙权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- **Android**：依赖已获得的系统蓝牙权限；权限被拒绝或在系统设置中撤销后调用失败，需引导用户在系统设置中开启蓝牙权限
+
+### 前置条件
+
+- **Android**：需先调用 openBluetoothAdapter 打开蓝牙适配器
+
+## 使用说明
+
+- 该能力仅在 Android 生效，iOS 调用会返回不支持
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+isBluetoothDevicePaired(params: IsBluetoothDevicePairedParams): Promise<object>
+```
+
+## 入参
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必填</th><th>默认值</th><th>约束</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>deviceId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>蓝牙设备 ID。</td></tr>
+</tbody>
+</table>
+
+## 调用示例
+
+```typescript
+import { isBluetoothDevicePaired } from '@doubao-dev/framework/api';
+
+await isBluetoothDevicePaired({ deviceId: 'device-id' });
+```
+
+## 成功返回
+
+无返回字段。
+
+### 返回示例
+
+```json
+{}
+```
+
+## 错误处理
+
+错误对象和通用错误码见 [通用错误处理](./common-errors.md#错误返回)。
+
+### 错误码
+
+#### 通用错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>说明</th><th>平台</th></tr>
+</thead>
+<tbody>
+<tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android</td></tr>
+<tr><td><code>103</code></td><td><code>feature not support</code></td><td>当前环境不支持该能力</td><td>iOS</td></tr>
+<tr><td><code>104</code></td><td><code>invalid parameter</code></td><td>参数不合法</td><td>Android</td></tr>
+<tr><td><code>116</code></td><td><code>resource not found</code></td><td>资源不存在</td><td>Android</td></tr>
+</tbody>
+</table>
+
+<a id="closebluetoothadapter"></a>
+### closeBluetoothAdapter()
+
+# closeBluetoothAdapter
+
+关闭蓝牙适配器。
+
+## 扫码预览
+![扫码预览 closeBluetoothAdapter](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fdevice%252Fbluetooth-adapter%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.25`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android、iOS</td><td>使用蓝牙能力需要系统蓝牙权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- 依赖 openBluetoothAdapter 阶段已获得的系统蓝牙权限；权限被拒绝或在系统设置中撤销后调用失败，需引导用户在系统设置中开启蓝牙权限
+
+## 使用说明
+
+会关闭蓝牙模块。
+
+- 会释放蓝牙模块资源并断开相关连接，蓝牙流程结束时调用
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+closeBluetoothAdapter(params?: object): Promise<object>
+```
+
+## 入参
+
+无。
+
+## 调用示例
+
+```typescript
+import { closeBluetoothAdapter } from '@doubao-dev/framework/api';
+
+await closeBluetoothAdapter();
+```
+
+## 成功返回
+
+无返回字段。
+
+### 返回示例
+
+```json
+{}
+```
+
+## 错误处理
+
+错误对象和通用错误码见 [通用错误处理](./common-errors.md#错误返回)。
+
+### 错误码
+
+#### 通用错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>说明</th><th>平台</th></tr>
+</thead>
+<tbody>
+<tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android、iOS</td></tr>
+<tr><td><code>116</code></td><td><code>resource not found</code></td><td>资源不存在</td><td>Android、iOS</td></tr>
+</tbody>
+</table>
+
+<a id="createbleconnection"></a>
+### createBLEConnection()
+
+# createBLEConnection
+
+创建 BLE 连接。
+
+## 扫码预览
+![扫码预览 createBLEConnection](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fdevice%252Fbluetooth-connection%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.25`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android、iOS</td><td>使用蓝牙能力需要系统蓝牙权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- 依赖 openBluetoothAdapter 阶段已获得的系统蓝牙权限；权限被拒绝或在系统设置中撤销后调用失败，需引导用户在系统设置中开启蓝牙权限
+
+### 前置条件
+
+- 需先通过搜索或已连接列表获得目标 deviceId
+
+## 使用说明
+
+需要传入 deviceId。
+
+- 连接成功后可通过 onBLEConnectionStateChange 监听连接状态变化
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+createBLEConnection(params: CreateBLEConnectionParams): Promise<object>
+```
+
+## 入参
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必填</th><th>默认值</th><th>约束</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>deviceId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>蓝牙设备 ID。</td></tr>
+<tr><td><code>timeout</code></td><td><code>number</code></td><td>否</td><td><code>20000</code></td><td>-</td><td>超时时间，单位毫秒。</td></tr>
+</tbody>
+</table>
+
+## 调用示例
+
+```typescript
+import { createBLEConnection } from '@doubao-dev/framework/api';
+
+await createBLEConnection({
+  deviceId: 'device-id',
+  timeout: 10000
+});
+```
+
+## 成功返回
+
+无返回字段。
+
+### 返回示例
+
+```json
+{}
+```
+
+## 错误处理
+
+错误对象和通用错误码见 [通用错误处理](./common-errors.md#错误返回)。
+
+### 错误码
+
+#### 通用错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>说明</th><th>平台</th></tr>
+</thead>
+<tbody>
+<tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android、iOS</td></tr>
+<tr><td><code>104</code></td><td><code>invalid parameter</code></td><td>参数不合法</td><td>Android、iOS</td></tr>
+<tr><td><code>115</code></td><td><code>operation timeout</code></td><td>操作超时</td><td>Android、iOS</td></tr>
+<tr><td><code>116</code></td><td><code>resource not found</code></td><td>资源不存在</td><td>Android、iOS</td></tr>
+<tr><td><code>118</code></td><td><code>already exists</code></td><td>资源已存在</td><td>Android、iOS</td></tr>
+</tbody>
+</table>
+
+<a id="closebleconnection"></a>
+### closeBLEConnection()
+
+# closeBLEConnection
+
+关闭 BLE 连接。
+
+## 扫码预览
+![扫码预览 closeBLEConnection](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fdevice%252Fbluetooth-connection%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.25`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android、iOS</td><td>使用蓝牙能力需要系统蓝牙权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- 依赖 openBluetoothAdapter 阶段已获得的系统蓝牙权限；权限被拒绝或在系统设置中撤销后调用失败，需引导用户在系统设置中开启蓝牙权限
+
+### 前置条件
+
+- 需先调用 createBLEConnection 建立连接
+
+## 使用说明
+
+- 不再使用设备时应主动断开连接以释放资源
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+closeBLEConnection(params: CloseBLEConnectionParams): Promise<object>
+```
+
+## 入参
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必填</th><th>默认值</th><th>约束</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>deviceId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>蓝牙设备 ID。</td></tr>
+</tbody>
+</table>
+
+## 调用示例
+
+```typescript
+import { closeBLEConnection } from '@doubao-dev/framework/api';
+
+await closeBLEConnection({ deviceId: 'device-id' });
+```
+
+## 成功返回
+
+无返回字段。
+
+### 返回示例
+
+```json
+{}
+```
+
+## 错误处理
+
+错误对象和通用错误码见 [通用错误处理](./common-errors.md#错误返回)。
+
+### 错误码
+
+#### 通用错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>说明</th><th>平台</th></tr>
+</thead>
+<tbody>
+<tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android、iOS</td></tr>
+<tr><td><code>104</code></td><td><code>invalid parameter</code></td><td>参数不合法</td><td>Android、iOS</td></tr>
+<tr><td><code>116</code></td><td><code>resource not found</code></td><td>资源不存在</td><td>Android、iOS</td></tr>
+</tbody>
+</table>
+
+<a id="getbledeviceservices"></a>
+### getBLEDeviceServices()
+
+# getBLEDeviceServices
+
+获取 BLE 服务列表。
+
+## 扫码预览
+![扫码预览 getBLEDeviceServices](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fdevice%252Fbluetooth-services%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.25`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android、iOS</td><td>使用蓝牙能力需要系统蓝牙权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- 依赖 openBluetoothAdapter 阶段已获得的系统蓝牙权限；权限被拒绝或在系统设置中撤销后调用失败，需引导用户在系统设置中开启蓝牙权限
+
+### 前置条件
+
+- 需先调用 createBLEConnection 建立连接
+
+## 使用说明
+
+通常先调用 createBLEConnection。
+
+- 通过返回的 uuid 进一步获取特征值列表
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+getBLEDeviceServices(params: GetBLEDeviceServicesParams): Promise<GetBLEDeviceServicesResult>
+```
+
+## 入参
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必填</th><th>默认值</th><th>约束</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>deviceId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>蓝牙设备 ID。</td></tr>
+</tbody>
+</table>
+
+## 调用示例
+
+```typescript
+import { getBLEDeviceServices } from '@doubao-dev/framework/api';
+
+const { services } = await getBLEDeviceServices({ deviceId: 'device-id' });
+
+console.log(services);
+```
+
+## 成功返回
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>services</code></td><td><code>BluetoothService[]</code></td><td>是</td><td>设备服务列表。</td></tr>
+<tr><td><code>services[].isPrimary</code></td><td><code>boolean</code></td><td>是</td><td>是否为主服务。</td></tr>
+<tr><td><code>services[].uuid</code></td><td><code>string</code></td><td>是</td><td>服务 UUID。</td></tr>
+</tbody>
+</table>
+
+### 返回示例
+
+```json
+{
+  "services": [
+    {
+      "uuid": "0000180D-0000-1000-8000-00805F9B34FB",
+      "isPrimary": true
+    }
+  ]
+}
+```
+
+## 错误处理
+
+错误对象和通用错误码见 [通用错误处理](./common-errors.md#错误返回)。
+
+### 错误码
+
+#### 通用错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>说明</th><th>平台</th></tr>
+</thead>
+<tbody>
+<tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android、iOS</td></tr>
+<tr><td><code>104</code></td><td><code>invalid parameter</code></td><td>参数不合法</td><td>Android、iOS</td></tr>
+<tr><td><code>116</code></td><td><code>resource not found</code></td><td>资源不存在</td><td>Android、iOS</td></tr>
+</tbody>
+</table>
+
+<a id="getbledevicecharacteristics"></a>
+### getBLEDeviceCharacteristics()
+
+# getBLEDeviceCharacteristics
+
+获取 BLE 特征值列表。
+
+## 扫码预览
+![扫码预览 getBLEDeviceCharacteristics](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fdevice%252Fbluetooth-services%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.25`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android、iOS</td><td>使用蓝牙能力需要系统蓝牙权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- 依赖 openBluetoothAdapter 阶段已获得的系统蓝牙权限；权限被拒绝或在系统设置中撤销后调用失败，需引导用户在系统设置中开启蓝牙权限
+
+### 前置条件
+
+- 需先调用 getBLEDeviceServices 获取服务列表
+
+## 使用说明
+
+通常先获取 BLE 服务列表。
+
+- 通过 properties 判断特征值支持的读写与订阅能力
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+getBLEDeviceCharacteristics(params: GetBLEDeviceCharacteristicsParams): Promise<GetBLEDeviceCharacteristicsResult>
+```
+
+## 入参
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必填</th><th>默认值</th><th>约束</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>deviceId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>蓝牙设备 ID。</td></tr>
+<tr><td><code>serviceId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>服务 ID。</td></tr>
+</tbody>
+</table>
+
+## 调用示例
+
+```typescript
+import { getBLEDeviceCharacteristics } from '@doubao-dev/framework/api';
+
+const { characteristics } = await getBLEDeviceCharacteristics({
+  deviceId: 'device-id',
+  serviceId: 'service-id'
+});
+
+console.log(characteristics);
+```
+
+## 成功返回
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>characteristics</code></td><td><code>BluetoothCharacteristic[]</code></td><td>是</td><td>特征值列表。</td></tr>
+<tr><td><code>characteristics[].properties</code></td><td><code>BluetoothCharacteristicProperties</code></td><td>是</td><td>特征值能力。</td></tr>
+<tr><td><code>characteristics[].properties.indicate</code></td><td><code>boolean</code></td><td>是</td><td>是否支持 indicate。</td></tr>
+<tr><td><code>characteristics[].properties.notify</code></td><td><code>boolean</code></td><td>是</td><td>是否支持 notify。</td></tr>
+<tr><td><code>characteristics[].properties.read</code></td><td><code>boolean</code></td><td>是</td><td>是否支持 read。</td></tr>
+<tr><td><code>characteristics[].properties.write</code></td><td><code>boolean</code></td><td>是</td><td>是否支持 write。</td></tr>
+<tr><td><code>characteristics[].properties.writeDefault</code></td><td><code>boolean</code></td><td>是</td><td>是否支持带响应写入。</td></tr>
+<tr><td><code>characteristics[].properties.writeNoResponse</code></td><td><code>boolean</code></td><td>是</td><td>是否支持无响应写入。</td></tr>
+<tr><td><code>characteristics[].uuid</code></td><td><code>string</code></td><td>是</td><td>特征值 UUID。</td></tr>
+</tbody>
+</table>
+
+### 返回示例
+
+```json
+{
+  "characteristics": [
+    {
+      "uuid": "00002A37-0000-1000-8000-00805F9B34FB",
+      "properties": {
+        "indicate": false,
+        "notify": true,
+        "read": true,
+        "write": false,
+        "writeNoResponse": false,
+        "writeDefault": false
+      }
+    }
+  ]
+}
+```
+
+## 错误处理
+
+错误对象和通用错误码见 [通用错误处理](./common-errors.md#错误返回)。
+
+### 错误码
+
+#### 通用错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>说明</th><th>平台</th></tr>
+</thead>
+<tbody>
+<tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android、iOS</td></tr>
+<tr><td><code>104</code></td><td><code>invalid parameter</code></td><td>参数不合法</td><td>Android、iOS</td></tr>
+<tr><td><code>116</code></td><td><code>resource not found</code></td><td>资源不存在</td><td>Android、iOS</td></tr>
+</tbody>
+</table>
+
+<a id="getbledevicerssi"></a>
+### getBLEDeviceRSSI()
+
+# getBLEDeviceRSSI
+
+获取 BLE 设备 RSSI。
+
+## 扫码预览
+![扫码预览 getBLEDeviceRSSI](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fdevice%252Fbluetooth-services%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.25`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android、iOS</td><td>使用蓝牙能力需要系统蓝牙权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- 依赖 openBluetoothAdapter 阶段已获得的系统蓝牙权限；权限被拒绝或在系统设置中撤销后调用失败，需引导用户在系统设置中开启蓝牙权限
+
+### 前置条件
+
+- 需先调用 createBLEConnection 建立连接
+
+## 使用说明
+
+- RSSI 单位为 dBm，值越接近 0 信号越强
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+getBLEDeviceRSSI(params: GetBLEDeviceRSSIParams): Promise<GetBLEDeviceRSSIResult>
+```
+
+## 入参
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必填</th><th>默认值</th><th>约束</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>deviceId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>蓝牙设备 ID。</td></tr>
+</tbody>
+</table>
+
+## 调用示例
+
+```typescript
+import { getBLEDeviceRSSI } from '@doubao-dev/framework/api';
+
+const { RSSI } = await getBLEDeviceRSSI({ deviceId: 'device-id' });
+
+console.log(RSSI);
+```
+
+## 成功返回
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>RSSI</code></td><td><code>number</code></td><td>是</td><td>RSSI 信号强度，单位 dBm。</td></tr>
+</tbody>
+</table>
+
+### 返回示例
+
+```json
+{
+  "RSSI": -55
+}
+```
+
+## 错误处理
+
+错误对象和通用错误码见 [通用错误处理](./common-errors.md#错误返回)。
+
+### 错误码
+
+#### 通用错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>说明</th><th>平台</th></tr>
+</thead>
+<tbody>
+<tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android、iOS</td></tr>
+<tr><td><code>104</code></td><td><code>invalid parameter</code></td><td>参数不合法</td><td>Android、iOS</td></tr>
+<tr><td><code>116</code></td><td><code>resource not found</code></td><td>资源不存在</td><td>Android、iOS</td></tr>
+</tbody>
+</table>
+
+<a id="getblemtu"></a>
+### getBLEMTU()
+
+# getBLEMTU
+
+获取 BLE MTU。
+
+## 扫码预览
+![扫码预览 getBLEMTU](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fdevice%252Fbluetooth-mtu%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.25`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android、iOS</td><td>使用蓝牙能力需要系统蓝牙权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- 依赖 openBluetoothAdapter 阶段已获得的系统蓝牙权限；权限被拒绝或在系统设置中撤销后调用失败，需引导用户在系统设置中开启蓝牙权限
+
+### 前置条件
+
+- 需先调用 createBLEConnection 建立连接
+
+## 使用说明
+
+- 通过 mtu 判断单次可传输的最大字节数
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+getBLEMTU(params: GetBLEMTUParams): Promise<GetBLEMTUResult>
+```
+
+## 入参
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必填</th><th>默认值</th><th>约束</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>deviceId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>蓝牙设备 ID。</td></tr>
+<tr><td><code>writeType</code></td><td><code>BluetoothWriteType</code></td><td>否</td><td><code>由平台按当前连接选择写入模式</code></td><td>-</td><td>写入模式。</td></tr>
+</tbody>
+</table>
+
+## 调用示例
+
+```typescript
+import { getBLEMTU } from '@doubao-dev/framework/api';
+
+const { mtu } = await getBLEMTU({ deviceId: 'device-id' });
+
+console.log(mtu);
+```
+
+## 成功返回
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>mtu</code></td><td><code>number</code></td><td>是</td><td>当前 MTU。</td></tr>
+</tbody>
+</table>
+
+### 返回示例
+
+```json
+{
+  "mtu": 23
+}
+```
+
+## 错误处理
+
+错误对象和通用错误码见 [通用错误处理](./common-errors.md#错误返回)。
+
+### 错误码
+
+#### 通用错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>说明</th><th>平台</th></tr>
+</thead>
+<tbody>
+<tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android、iOS</td></tr>
+<tr><td><code>104</code></td><td><code>invalid parameter</code></td><td>参数不合法</td><td>Android、iOS</td></tr>
+<tr><td><code>116</code></td><td><code>resource not found</code></td><td>资源不存在</td><td>Android、iOS</td></tr>
+</tbody>
+</table>
+
+<a id="notifyblecharacteristicvaluechange"></a>
+### notifyBLECharacteristicValueChange()
+
+# notifyBLECharacteristicValueChange
+
+订阅 BLE 特征值变化。
+
+## 扫码预览
+![扫码预览 notifyBLECharacteristicValueChange](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fdevice%252Fbluetooth-characteristic%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.25`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android、iOS</td><td>使用蓝牙能力需要系统蓝牙权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- 依赖 openBluetoothAdapter 阶段已获得的系统蓝牙权限；权限被拒绝或在系统设置中撤销后调用失败，需引导用户在系统设置中开启蓝牙权限
+
+### 前置条件
+
+- 需先调用 getBLEDeviceCharacteristics 确认特征值支持 notify 或 indicate
+
+## 使用说明
+
+订阅指定特征值变化。
+
+- 订阅开启后特征值变化会通过 onBLECharacteristicValueChange 回传
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+notifyBLECharacteristicValueChange(params: NotifyBLECharacteristicValueChangeParams): Promise<object>
+```
+
+## 入参
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必填</th><th>默认值</th><th>约束</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>characteristicId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>特征值 ID。</td></tr>
+<tr><td><code>deviceId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>蓝牙设备 ID。</td></tr>
+<tr><td><code>serviceId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>服务 ID。</td></tr>
+<tr><td><code>state</code></td><td><code>boolean</code></td><td>是</td><td>-</td><td>-</td><td>是否启用订阅。</td></tr>
+<tr><td><code>type</code></td><td><code>BluetoothNotifyType</code></td><td>否</td><td><code>indication</code></td><td>-</td><td>订阅类型。</td></tr>
+</tbody>
+</table>
+
+## 调用示例
+
+```typescript
+import { notifyBLECharacteristicValueChange } from '@doubao-dev/framework/api';
+
+await notifyBLECharacteristicValueChange({
+  deviceId: 'device-id',
+  serviceId: 'service-id',
+  characteristicId: 'characteristic-id',
+  state: true
+});
+```
+
+## 成功返回
+
+无返回字段。
+
+### 返回示例
+
+```json
+{}
+```
+
+## 错误处理
+
+错误对象和通用错误码见 [通用错误处理](./common-errors.md#错误返回)。
+
+### 错误码
+
+#### 通用错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>说明</th><th>平台</th></tr>
+</thead>
+<tbody>
+<tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android、iOS</td></tr>
+<tr><td><code>103</code></td><td><code>feature not support</code></td><td>当前环境不支持该能力</td><td>Android、iOS</td></tr>
+<tr><td><code>104</code></td><td><code>invalid parameter</code></td><td>参数不合法</td><td>Android、iOS</td></tr>
+<tr><td><code>116</code></td><td><code>resource not found</code></td><td>资源不存在</td><td>Android、iOS</td></tr>
+</tbody>
+</table>
+
+<a id="readblecharacteristicvalue"></a>
+### readBLECharacteristicValue()
+
+# readBLECharacteristicValue
+
+读取 BLE 特征值。
+
+## 扫码预览
+![扫码预览 readBLECharacteristicValue](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fdevice%252Fbluetooth-characteristic%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.25`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android、iOS</td><td>使用蓝牙能力需要系统蓝牙权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- 依赖 openBluetoothAdapter 阶段已获得的系统蓝牙权限；权限被拒绝或在系统设置中撤销后调用失败，需引导用户在系统设置中开启蓝牙权限
+
+### 前置条件
+
+- 需先调用 getBLEDeviceCharacteristics 确认特征值支持 read
+
+## 使用说明
+
+需要传入 serviceId 和 characteristicId。
+
+- 读取到的数据不在本接口返回，需通过 onBLECharacteristicValueChange 接收
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+readBLECharacteristicValue(params: ReadBLECharacteristicValueParams): Promise<object>
+```
+
+## 入参
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必填</th><th>默认值</th><th>约束</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>characteristicId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>特征值 ID。</td></tr>
+<tr><td><code>deviceId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>蓝牙设备 ID。</td></tr>
+<tr><td><code>serviceId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>服务 ID。</td></tr>
+</tbody>
+</table>
+
+## 调用示例
+
+```typescript
+import { readBLECharacteristicValue } from '@doubao-dev/framework/api';
+
+await readBLECharacteristicValue({
+  deviceId: 'device-id',
+  serviceId: 'service-id',
+  characteristicId: 'characteristic-id'
+});
+```
+
+## 成功返回
+
+无返回字段。
+
+### 返回示例
+
+```json
+{}
+```
+
+## 错误处理
+
+错误对象和通用错误码见 [通用错误处理](./common-errors.md#错误返回)。
+
+### 错误码
+
+#### 通用错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>说明</th><th>平台</th></tr>
+</thead>
+<tbody>
+<tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android、iOS</td></tr>
+<tr><td><code>103</code></td><td><code>feature not support</code></td><td>当前环境不支持该能力</td><td>Android、iOS</td></tr>
+<tr><td><code>104</code></td><td><code>invalid parameter</code></td><td>参数不合法</td><td>Android、iOS</td></tr>
+<tr><td><code>116</code></td><td><code>resource not found</code></td><td>资源不存在</td><td>Android、iOS</td></tr>
+</tbody>
+</table>
+
+<a id="setblemtu"></a>
+### setBLEMTU()
+
+# setBLEMTU
+
+设置 BLE MTU。
+
+## 扫码预览
+![扫码预览 setBLEMTU](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fdevice%252Fbluetooth-mtu%252Findex)
+
+## 使用限制
+
+> [!WARNING]
+> **iOS**：豆包 iOS 的 setBLEMTU 固定返回不支持；iOS 上调用无法设置 MTU。
+
+## 支持版本
+
+前端库版本不低于 `0.0.25`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>不支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android</td><td>设置 MTU 需要系统蓝牙权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- **Android**：依赖已获得的系统蓝牙权限；权限被拒绝或在系统设置中撤销后调用失败，需引导用户在系统设置中开启蓝牙权限
+
+### 前置条件
+
+- **Android**：需先调用 createBLEConnection 建立连接
+
+## 使用说明
+
+- 该能力仅在 Android 生效，返回的 mtu 为最终协商结果，iOS 调用会返回不支持
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+setBLEMTU(params: SetBLEMTUParams): Promise<SetBLEMTUResult>
+```
+
+## 入参
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必填</th><th>默认值</th><th>约束</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>deviceId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>蓝牙设备 ID。</td></tr>
+<tr><td><code>mtu</code></td><td><code>number</code></td><td>是</td><td>-</td><td>-</td><td>目标 MTU。</td></tr>
+</tbody>
+</table>
+
+## 调用示例
+
+```typescript
+import { setBLEMTU } from '@doubao-dev/framework/api';
+
+const { mtu } = await setBLEMTU({
+  deviceId: 'device-id',
+  mtu: 512
+});
+
+console.log(mtu);
+```
+
+## 成功返回
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>mtu</code></td><td><code>number</code></td><td>是</td><td>最终协商得到的 MTU。</td></tr>
+</tbody>
+</table>
+
+### 返回示例
+
+```json
+{
+  "mtu": 512
+}
+```
+
+## 错误处理
+
+错误对象和通用错误码见 [通用错误处理](./common-errors.md#错误返回)。
+
+### 错误码
+
+#### 通用错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>说明</th><th>平台</th></tr>
+</thead>
+<tbody>
+<tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android</td></tr>
+<tr><td><code>103</code></td><td><code>feature not support</code></td><td>当前环境不支持该能力</td><td>iOS</td></tr>
+<tr><td><code>104</code></td><td><code>invalid parameter</code></td><td>参数不合法</td><td>Android</td></tr>
+<tr><td><code>116</code></td><td><code>resource not found</code></td><td>资源不存在</td><td>Android</td></tr>
+</tbody>
+</table>
+
+<a id="writeblecharacteristicvalue"></a>
+### writeBLECharacteristicValue()
+
+# writeBLECharacteristicValue
+
+写入 BLE 特征值。
+
+## 扫码预览
+![扫码预览 writeBLECharacteristicValue](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fdevice%252Fbluetooth-characteristic%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.25`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android、iOS</td><td>使用蓝牙能力需要系统蓝牙权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- 依赖 openBluetoothAdapter 阶段已获得的系统蓝牙权限；权限被拒绝或在系统设置中撤销后调用失败，需引导用户在系统设置中开启蓝牙权限
+
+### 前置条件
+
+- 需先调用 getBLEDeviceCharacteristics 确认特征值支持写入
+
+## 使用说明
+
+value 需要是 ArrayBuffer。
+
+- value 需传入 ArrayBuffer，单次写入长度不应超过当前 MTU
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+writeBLECharacteristicValue(params: WriteBLECharacteristicValueParams): Promise<object>
+```
+
+## 入参
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必填</th><th>默认值</th><th>约束</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>characteristicId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>特征值 ID。</td></tr>
+<tr><td><code>deviceId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>蓝牙设备 ID。</td></tr>
+<tr><td><code>serviceId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>服务 ID。</td></tr>
+<tr><td><code>value</code></td><td><code>ArrayBuffer</code></td><td>是</td><td>-</td><td>-</td><td>要写入的二进制数据。</td></tr>
+<tr><td><code>writeType</code></td><td><code>BluetoothWriteType</code></td><td>否</td><td><code>由平台按特征值能力选择写入模式</code></td><td>-</td><td>写入模式。</td></tr>
+</tbody>
+</table>
+
+## 调用示例
+
+```typescript
+import { writeBLECharacteristicValue } from '@doubao-dev/framework/api';
+
+await writeBLECharacteristicValue({
+  deviceId: 'device-id',
+  serviceId: 'service-id',
+  characteristicId: 'characteristic-id',
+  value: new Uint8Array([1, 2, 3]).buffer
+});
+```
+
+## 成功返回
+
+无返回字段。
+
+### 返回示例
+
+```json
+{}
+```
+
+## 错误处理
+
+错误对象和通用错误码见 [通用错误处理](./common-errors.md#错误返回)。
+
+### 错误码
+
+#### 通用错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>说明</th><th>平台</th></tr>
+</thead>
+<tbody>
+<tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android、iOS</td></tr>
+<tr><td><code>103</code></td><td><code>feature not support</code></td><td>当前环境不支持该能力</td><td>Android、iOS</td></tr>
+<tr><td><code>104</code></td><td><code>invalid parameter</code></td><td>参数不合法</td><td>Android、iOS</td></tr>
+<tr><td><code>116</code></td><td><code>resource not found</code></td><td>资源不存在</td><td>Android、iOS</td></tr>
+</tbody>
+</table>
+
+<a id="onbluetoothadapterstatechange"></a>
+### onBluetoothAdapterStateChange()
+
+# onBluetoothAdapterStateChange
+
+注册蓝牙适配器状态变化回调。
+
+## 支持版本
+
+前端库版本不低于 `0.0.36`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android、iOS</td><td>使用蓝牙能力需要系统蓝牙权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- 依赖 openBluetoothAdapter 阶段已获得的系统蓝牙权限；权限被拒绝或在系统设置中撤销后事件不再回调，需引导用户在系统设置中开启蓝牙权限
+
+### 前置条件
+
+- 需先调用 openBluetoothAdapter 打开蓝牙适配器
+
+## 使用说明
+
+- 通过 available 与 discovering 感知适配器可用性与搜索状态变化
+
+## 调用方式
+
+### 事件监听 API
+
+```typescript
+onBluetoothAdapterStateChange(callback: (event: GetBluetoothAdapterStateResult) => void): () => void
+```
+
+## 入参
+
+无。
+
+## 调用示例
+
+```typescript
+import { onBluetoothAdapterStateChange } from '@doubao-dev/framework/api';
+
+const off = onBluetoothAdapterStateChange(({ available, discovering }) => {
+  console.log(available, discovering);
+});
+
+off();
+```
+
+## 回调参数
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>event.available</code></td><td><code>boolean</code></td><td>是</td><td>蓝牙适配器是否可用。</td></tr>
+<tr><td><code>event.discovering</code></td><td><code>boolean</code></td><td>是</td><td>是否正在搜索蓝牙设备。</td></tr>
+</tbody>
+</table>
+
+## 返回值
+
+返回取消当前监听函数的函数。
+
+### 回调示例
+
+```json
+{
+  "available": true,
+  "discovering": false
+}
+```
+
+<a id="onbluetoothdevicefound"></a>
+### onBluetoothDeviceFound()
+
+# onBluetoothDeviceFound
+
+注册发现蓝牙设备回调。
+
+## 支持版本
+
+前端库版本不低于 `0.0.36`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android、iOS</td><td>扫描附近蓝牙设备需要系统蓝牙权限，Android 低版本还需定位权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- 依赖 startBluetoothDevicesDiscovery 阶段已获得的系统蓝牙权限；权限被拒绝或在系统设置中撤销后事件不再回调，需引导用户在系统设置中开启蓝牙权限
+
+### 前置条件
+
+- 需先调用 startBluetoothDevicesDiscovery 开始搜索
+
+## 使用说明
+
+- `advertisData` 与 `serviceData` 以 ArrayBuffer 返回
+
+## 调用方式
+
+### 事件监听 API
+
+```typescript
+onBluetoothDeviceFound(callback: BluetoothDeviceFoundListener): () => void
+```
+
+## 入参
+
+无。
+
+## 调用示例
+
+```typescript
+import { onBluetoothDeviceFound } from '@doubao-dev/framework/api';
+
+const off = onBluetoothDeviceFound(({ devices }) => {
+  console.log(devices);
+});
+
+off();
+```
+
+## 回调参数
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>event.devices</code></td><td><code>BluetoothDeviceFoundDevice[]</code></td><td>是</td><td>本次扫描上报的新发现设备列表。</td></tr>
+<tr><td><code>event.devices[].advertisData</code></td><td><code>ArrayBuffer</code></td><td>否</td><td>广播二进制数据。</td></tr>
+<tr><td><code>event.devices[].advertisServiceUUIDs</code></td><td><code>string[]</code></td><td>否</td><td>广播中的服务 UUID 列表。</td></tr>
+<tr><td><code>event.devices[].connectable</code></td><td><code>boolean</code></td><td>否</td><td>是否可连接。</td></tr>
+<tr><td><code>event.devices[].deviceId</code></td><td><code>string</code></td><td>是</td><td>设备 ID。</td></tr>
+<tr><td><code>event.devices[].localName</code></td><td><code>string</code></td><td>否</td><td>广播中的本地名称。</td></tr>
+<tr><td><code>event.devices[].name</code></td><td><code>string</code></td><td>是</td><td>设备名称。</td></tr>
+<tr><td><code>event.devices[].RSSI</code></td><td><code>number</code></td><td>是</td><td>RSSI 信号强度，单位 dBm。</td></tr>
+<tr><td><code>event.devices[].serviceData</code></td><td><code>BluetoothBinaryField</code></td><td>否</td><td>广播中的服务数据。</td></tr>
+</tbody>
+</table>
+
+## 返回值
+
+返回取消当前监听函数的函数。
+
+### 回调示例
+
+```json
+{
+  "devices": [
+    {
+      "deviceId": "device-id",
+      "name": "Doubao BLE",
+      "RSSI": -60,
+      "connectable": true
+    }
+  ]
+}
+```
+
+<a id="onbleconnectionstatechange"></a>
+### onBLEConnectionStateChange()
+
+# onBLEConnectionStateChange
+
+注册 BLE 连接状态变化回调。
+
+## 支持版本
+
+前端库版本不低于 `0.0.36`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android、iOS</td><td>使用蓝牙能力需要系统蓝牙权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- 依赖 openBluetoothAdapter 阶段已获得的系统蓝牙权限；权限被拒绝或在系统设置中撤销后事件不再回调，需引导用户在系统设置中开启蓝牙权限
+
+### 前置条件
+
+- 需先调用 createBLEConnection 建立连接
+
+## 使用说明
+
+- 设备主动断开或连接恢复时都会回调，通过 connected 判断当前状态
+
+## 调用方式
+
+### 事件监听 API
+
+```typescript
+onBLEConnectionStateChange(callback: (event: BLEConnectionStateChangeEvent) => void): () => void
+```
+
+## 入参
+
+无。
+
+## 调用示例
+
+```typescript
+import { onBLEConnectionStateChange } from '@doubao-dev/framework/api';
+
+const off = onBLEConnectionStateChange(({ deviceId, connected }) => {
+  console.log(deviceId, connected);
+});
+
+off();
+```
+
+## 回调参数
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>event.connected</code></td><td><code>boolean</code></td><td>是</td><td>是否已连接。</td></tr>
+<tr><td><code>event.deviceId</code></td><td><code>string</code></td><td>是</td><td>蓝牙设备 ID。</td></tr>
+</tbody>
+</table>
+
+## 返回值
+
+返回取消当前监听函数的函数。
+
+### 回调示例
+
+```json
+{
+  "deviceId": "device-id",
+  "connected": true
+}
+```
+
+<a id="onblecharacteristicvaluechange"></a>
+### onBLECharacteristicValueChange()
+
+# onBLECharacteristicValueChange
+
+注册 BLE 特征值变化回调。
+
+## 支持版本
+
+前端库版本不低于 `0.0.36`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>支持</td></tr>
+<tr><td>PC</td><td>不支持</td></tr>
+<tr><td>HarmonyOS</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>不支持</td></tr>
+</tbody>
+</table>
+
+## 接入准备
+
+### 权限要求
+
+<table>
+<thead>
+<tr><th>类型</th><th>标识</th><th>是否必须</th><th>平台</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td>系统权限</td><td>蓝牙权限</td><td>按条件</td><td>Android、iOS</td><td>使用蓝牙能力需要系统蓝牙权限</td></tr>
+</tbody>
+</table>
+
+### 授权行为
+
+- 依赖 openBluetoothAdapter 阶段已获得的系统蓝牙权限；权限被拒绝或在系统设置中撤销后事件不再回调，需引导用户在系统设置中开启蓝牙权限
+
+### 前置条件
+
+- 需先调用 readBLECharacteristicValue 读取或 notifyBLECharacteristicValueChange 开启订阅
+
+## 使用说明
+
+`readBLECharacteristicValue` 读到的数据和 `notifyBLECharacteristicValueChange` 开启后的通知都会从此事件回传。
+
+- 读取结果与订阅通知都会从此事件回传，`value` 以 ArrayBuffer 返回
+
+## 调用方式
+
+### 事件监听 API
+
+```typescript
+onBLECharacteristicValueChange(callback: BLECharacteristicValueChangeListener): () => void
+```
+
+## 入参
+
+无。
+
+## 调用示例
+
+```typescript
+import { onBLECharacteristicValueChange } from '@doubao-dev/framework/api';
+
+const off = onBLECharacteristicValueChange(({ deviceId, value }) => {
+  console.log(deviceId, value?.byteLength ?? 0);
+});
+
+off();
+```
+
+## 回调参数
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>event.characteristicId</code></td><td><code>string</code></td><td>是</td><td>特征值 ID。</td></tr>
+<tr><td><code>event.deviceId</code></td><td><code>string</code></td><td>是</td><td>蓝牙设备 ID。</td></tr>
+<tr><td><code>event.serviceId</code></td><td><code>string</code></td><td>是</td><td>服务 ID。</td></tr>
+<tr><td><code>event.value</code></td><td><code>ArrayBuffer</code></td><td>否</td><td>特征值最新的二进制值。</td></tr>
+</tbody>
+</table>
+
+## 返回值
+
+返回取消当前监听函数的函数。
+
+### 回调示例
+
+```json
+{
+  "deviceId": "device-id",
+  "serviceId": "service-id",
+  "characteristicId": "characteristic-id"
+}
+```
+
+## 相关类型
+
+<a id="bluetoothpowerlevel"></a>
+### BluetoothPowerLevel
+
+蓝牙扫描功耗等级。
+
+#### Type
+
+`'low' | 'medium' | 'high'`
+
+<a id="startbluetoothdevicesdiscoveryparams"></a>
+### StartBluetoothDevicesDiscoveryParams
+
+开始搜索蓝牙设备的请求参数。
+
+#### Properties
+
+• **allowDuplicatesKey?**: `boolean` - 是否允许重复上报同一设备
+• **interval?**: `number` - 上报设备的间隔，单位毫秒
+• **services?**: `string[]` - 按主服务 UUID 过滤搜索范围
+• **powerLevel?**: `BluetoothPowerLevel` - 扫描功耗等级
+
+<a id="getbluetoothadapterstateresult"></a>
+### GetBluetoothAdapterStateResult
+
+蓝牙适配器状态。
+
+#### Properties
+
+• **available**: `boolean` - 蓝牙适配器是否可用
+• **discovering**: `boolean` - 是否正在搜索蓝牙设备
+
+<a id="bluetoothbinaryfield"></a>
+### BluetoothBinaryField
+
+蓝牙广播二进制字段。
+
+#### Type
+
+`Record<string, ArrayBuffer>`
+
+<a id="bluetoothdevice"></a>
+### BluetoothDevice
+
+蓝牙设备信息。
+
+#### Properties
+
+• **deviceId**: `string` - 设备 ID
+• **name**: `string` - 设备名称
+• **localName?**: `string` - 广播中的本地名称
+• **RSSI**: `number` - RSSI 信号强度，单位 dBm
+• **advertisData?**: `ArrayBuffer` - 广播二进制数据
+• **advertisServiceUUIDs?**: `string[]` - 广播中的服务 UUID 列表
+• **serviceData?**: `BluetoothBinaryField` - 广播中的服务数据
+• **connectable?**: `boolean` - 是否可连接
+
+<a id="getbluetoothdevicesresult"></a>
+### GetBluetoothDevicesResult
+
+获取蓝牙设备列表的返回结果。
+
+#### Properties
+
+• **devices**: `BluetoothDevice[]` - 当前蓝牙模块已发现的设备列表
+
+<a id="getconnectedbluetoothdevicesparams"></a>
+### GetConnectedBluetoothDevicesParams
+
+获取已连接蓝牙设备的请求参数。
+
+#### Properties
+
+• **services**: `string[]` - 蓝牙主服务 UUID 列表
+
+<a id="connectedbluetoothdevice"></a>
+### ConnectedBluetoothDevice
+
+已连接蓝牙设备信息。
+
+#### Properties
+
+• **deviceId**: `string` - 设备 ID
+• **name**: `string` - 设备名称
+
+<a id="getconnectedbluetoothdevicesresult"></a>
+### GetConnectedBluetoothDevicesResult
+
+获取已连接蓝牙设备的返回结果。
+
+#### Properties
+
+• **devices**: `ConnectedBluetoothDevice[]` - 已连接设备列表
+
+<a id="makebluetoothpairparams"></a>
+### MakeBluetoothPairParams
+
+蓝牙配对请求参数。
+
+#### Properties
+
+• **deviceId**: `string` - 蓝牙设备 ID
+• **pin**: `string` - 配对 PIN 码
+• **timeout?**: `number` - 超时时间，单位毫秒
+
+<a id="isbluetoothdevicepairedparams"></a>
+### IsBluetoothDevicePairedParams
+
+查询蓝牙设备配对状态的请求参数。
+
+#### Properties
+
+• **deviceId**: `string` - 蓝牙设备 ID
+
+<a id="createbleconnectionparams"></a>
+### CreateBLEConnectionParams
+
+创建 BLE 连接的请求参数。
+
+#### Properties
+
+• **deviceId**: `string` - 蓝牙设备 ID
+• **timeout?**: `number` - 超时时间，单位毫秒
+
+<a id="closebleconnectionparams"></a>
+### CloseBLEConnectionParams
+
+关闭 BLE 连接的请求参数。
+
+#### Properties
+
+• **deviceId**: `string` - 蓝牙设备 ID
+
+<a id="bluetoothservice"></a>
+### BluetoothService
+
+蓝牙服务信息。
+
+#### Properties
+
+• **uuid**: `string` - 服务 UUID
+• **isPrimary**: `boolean` - 是否为主服务
+
+<a id="getbledeviceservicesparams"></a>
+### GetBLEDeviceServicesParams
+
+获取 BLE 服务列表的请求参数。
+
+#### Properties
+
+• **deviceId**: `string` - 蓝牙设备 ID
+
+<a id="getbledeviceservicesresult"></a>
+### GetBLEDeviceServicesResult
+
+获取 BLE 服务列表的返回结果。
+
+#### Properties
+
+• **services**: `BluetoothService[]` - 设备服务列表
+
+<a id="bluetoothcharacteristicproperties"></a>
+### BluetoothCharacteristicProperties
+
+蓝牙特征值支持的能力。
+
+#### Properties
+
+• **indicate**: `boolean` - 是否支持 indicate
+• **notify**: `boolean` - 是否支持 notify
+• **read**: `boolean` - 是否支持 read
+• **write**: `boolean` - 是否支持 write
+• **writeNoResponse**: `boolean` - 是否支持无响应写入
+• **writeDefault**: `boolean` - 是否支持带响应写入
+
+<a id="bluetoothcharacteristic"></a>
+### BluetoothCharacteristic
+
+蓝牙特征值信息。
+
+#### Properties
+
+• **uuid**: `string` - 特征值 UUID
+• **properties**: `BluetoothCharacteristicProperties` - 特征值能力
+
+<a id="getbledevicecharacteristicsparams"></a>
+### GetBLEDeviceCharacteristicsParams
+
+获取 BLE 特征值列表的请求参数。
+
+#### Properties
+
+• **deviceId**: `string` - 蓝牙设备 ID
+• **serviceId**: `string` - 服务 ID
+
+<a id="getbledevicecharacteristicsresult"></a>
+### GetBLEDeviceCharacteristicsResult
+
+获取 BLE 特征值列表的返回结果。
+
+#### Properties
+
+• **characteristics**: `BluetoothCharacteristic[]` - 特征值列表
+
+<a id="getbledevicerssiparams"></a>
+### GetBLEDeviceRSSIParams
+
+获取 BLE RSSI 的请求参数。
+
+#### Properties
+
+• **deviceId**: `string` - 蓝牙设备 ID
+
+<a id="getbledevicerssiresult"></a>
+### GetBLEDeviceRSSIResult
+
+获取 BLE RSSI 的返回结果。
+
+#### Properties
+
+• **RSSI**: `number` - RSSI 信号强度，单位 dBm
+
+<a id="bluetoothwritetype"></a>
+### BluetoothWriteType
+
+蓝牙写入模式。
+
+#### Type
+
+`'write' | 'writeNoResponse'`
+
+<a id="getblemtuparams"></a>
+### GetBLEMTUParams
+
+获取 BLE MTU 的请求参数。
+
+#### Properties
+
+• **deviceId**: `string` - 蓝牙设备 ID
+• **writeType?**: `BluetoothWriteType` - 写入模式
+
+<a id="getblemturesult"></a>
+### GetBLEMTUResult
+
+获取 BLE MTU 的返回结果。
+
+#### Properties
+
+• **mtu**: `number` - 当前 MTU
+
+<a id="bluetoothnotifytype"></a>
+### BluetoothNotifyType
+
+蓝牙特征值订阅类型。
+
+#### Type
+
+`'notification' | 'indication'`
+
+<a id="notifyblecharacteristicvaluechangeparams"></a>
+### NotifyBLECharacteristicValueChangeParams
+
+订阅 BLE 特征值变化的请求参数。
+
+#### Properties
+
+• **deviceId**: `string` - 蓝牙设备 ID
+• **serviceId**: `string` - 服务 ID
+• **characteristicId**: `string` - 特征值 ID
+• **state**: `boolean` - 是否启用订阅
+• **type?**: `BluetoothNotifyType` - 订阅类型
+
+<a id="readblecharacteristicvalueparams"></a>
+### ReadBLECharacteristicValueParams
+
+读取 BLE 特征值的请求参数。
+
+#### Properties
+
+• **deviceId**: `string` - 蓝牙设备 ID
+• **serviceId**: `string` - 服务 ID
+• **characteristicId**: `string` - 特征值 ID
+
+<a id="setblemtuparams"></a>
+### SetBLEMTUParams
+
+设置 BLE MTU 的请求参数。
+
+#### Properties
+
+• **deviceId**: `string` - 蓝牙设备 ID
+• **mtu**: `number` - 目标 MTU
+
+<a id="setblemturesult"></a>
+### SetBLEMTUResult
+
+设置 BLE MTU 的返回结果。
+
+#### Properties
+
+• **mtu**: `number` - 最终协商得到的 MTU
+
+<a id="writeblecharacteristicvalueparams"></a>
+### WriteBLECharacteristicValueParams
+
+写入 BLE 特征值的请求参数。
+
+#### Properties
+
+• **deviceId**: `string` - 蓝牙设备 ID
+• **serviceId**: `string` - 服务 ID
+• **characteristicId**: `string` - 特征值 ID
+• **value**: `ArrayBuffer` - 要写入的二进制数据
+• **writeType?**: `BluetoothWriteType` - 写入模式
+
+<a id="bluetoothdevicefounddevice"></a>
+### BluetoothDeviceFoundDevice
+
+蓝牙设备发现事件中的设备信息。
+
+#### Properties
+
+• **deviceId**: `string` - 设备 ID
+• **name**: `string` - 设备名称
+• **localName?**: `string` - 广播中的本地名称
+• **RSSI**: `number` - RSSI 信号强度，单位 dBm
+• **advertisData?**: `ArrayBuffer` - 广播二进制数据
+• **advertisServiceUUIDs?**: `string[]` - 广播中的服务 UUID 列表
+• **serviceData?**: `BluetoothBinaryField` - 广播中的服务数据
+• **connectable?**: `boolean` - 是否可连接
+
+<a id="bluetoothdevicefoundlistener"></a>
+### BluetoothDeviceFoundListener
+
+#### Type
+
+`(event: BluetoothDeviceFoundEvent) => void`
+
+<a id="bluetoothdevicefoundevent"></a>
+### BluetoothDeviceFoundEvent
+
+蓝牙设备发现事件。
+
+#### Properties
+
+• **devices**: `BluetoothDeviceFoundDevice[]` - 本次扫描上报的新发现设备列表
+
+<a id="bleconnectionstatechangeevent"></a>
+### BLEConnectionStateChangeEvent
+
+BLE 连接状态变化事件。
+
+#### Properties
+
+• **deviceId**: `string` - 蓝牙设备 ID
+• **connected**: `boolean` - 是否已连接
+
+<a id="blecharacteristicvaluechangelistener"></a>
+### BLECharacteristicValueChangeListener
+
+#### Type
+
+`(event: BLECharacteristicValueChangeEvent) => void`
+
+<a id="blecharacteristicvaluechangeevent"></a>
+### BLECharacteristicValueChangeEvent
+
+BLE 特征值变化事件。
+
+#### Properties
+
+• **deviceId**: `string` - 蓝牙设备 ID
+• **serviceId**: `string` - 服务 ID
+• **characteristicId**: `string` - 特征值 ID
+• **value?**: `ArrayBuffer` - 特征值最新的二进制值