> For AI agents: the complete documentation index is available at /apps-plugin/docs/llms.txt, the full documentation bundle is available at /apps-plugin/docs/llms-full.txt.

# JS API 概览

## 存储

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="storage/clearStorage">clearStorage</a></td><td>清空本地缓存。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="storage/clearStorageSync">clearStorageSync</a></td><td>清空本地缓存。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="storage/getStorage">getStorage</a></td><td>从本地缓存读取数据。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="storage/getStorageInfo">getStorageInfo</a></td><td>获取本地缓存信息。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="storage/getStorageInfoSync">getStorageInfoSync</a></td><td>同步获取本地缓存信息。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="storage/getStorageSync">getStorageSync</a></td><td>从本地缓存同步读取数据。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="storage/removeStorage">removeStorage</a></td><td>删除本地缓存中指定 key 的数据。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="storage/removeStorageSync">removeStorageSync</a></td><td>删除本地缓存中指定 key 的数据。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="storage/setStorage">setStorage</a></td><td>将数据写入本地缓存。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="storage/setStorageSync">setStorageSync</a></td><td>将数据写入本地缓存。</td><td>支持</td><td>支持</td></tr>
</tbody>
</table>

## 定位

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="location/getLocation">getLocation</a></td><td>获取设备当前的地理位置信息。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="location/onLocationChange">onLocationChange</a></td><td>注册地理位置变化回调。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="location/onLocationChangeError">onLocationChangeError</a></td><td>注册位置更新异常回调。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="location/startLocationUpdate">startLocationUpdate</a></td><td>开始接收位置更新。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="location/stopLocationUpdate">stopLocationUpdate</a></td><td>停止接收位置更新。</td><td>支持</td><td>不支持</td></tr>
</tbody>
</table>

## 基础

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="basic/arrayBufferToBase64">arrayBufferToBase64</a></td><td>将 ArrayBuffer 转换为 Base64 字符串。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="basic/authorize">authorize</a></td><td>提前向用户发起指定 scope 的授权；scope.healthData 仅用于选择 iOS HealthKit 系统授权路径。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="basic/base64ToArrayBuffer">base64ToArrayBuffer</a></td><td>将 Base64 字符串转换为 ArrayBuffer。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="basic/canIUse">canIUse</a></td><td>检测当前环境是否支持指定 API 或能力。</td><td>-</td><td>-</td></tr>
<tr><td><a href="basic/getAccountInfo">getAccountInfo</a></td><td>异步获取账号信息。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="basic/getAccountInfoSync">getAccountInfoSync</a></td><td>同步获取账号信息。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="basic/getPerformance">getPerformance</a></td><td>获取当前应用插件的性能数据。

Entry 由客户端保存；`getEntries*()` 同步查询当前快照，observer 只接收新完成的 Entry。</td><td>支持</td><td>支持</td></tr>

<tr><td><a href="basic/getSetting">getSetting</a></td><td>获取用户当前的应用授权设置。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="basic/openSetting">openSetting</a></td><td>打开应用插件授权设置页面</td><td>支持</td><td>支持</td></tr>
</tbody>
</table>

## 基础/系统

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="basic/system/getAppAuthorizeSetting">getAppAuthorizeSetting</a></td><td>获取豆包客户端的系统授权设置。

调用只读取当前系统授权状态，不会申请权限或触发系统授权弹窗。原有状态字段固定返回
`authorized`、`denied` 或 `not determined`，精细授权字段用于区分部分、只读、只写、前后台等能力。</td><td>支持</td><td>支持</td></tr>

<tr><td><a href="basic/system/getAppBaseInfo">getAppBaseInfo</a></td><td>获取应用基础信息。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="basic/system/getAppBaseInfoSync">getAppBaseInfoSync</a></td><td>获取应用基础信息。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="basic/system/getSystemInfo">getSystemInfo</a></td><td>获取系统信息。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="basic/system/getSystemInfoSync">getSystemInfoSync</a></td><td>同步获取系统信息。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="basic/system/getSystemSetting">getSystemSetting</a></td><td>获取设备设置。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="basic/system/getWindowInfo">getWindowInfo</a></td><td>获取窗口信息。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="basic/system/getWindowInfoSync">getWindowInfoSync</a></td><td>获取窗口信息。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="basic/system/onThemeChange">onThemeChange</a></td><td>监听应用主题变化。

当用户在系统设置或豆包客户端内切换浅色、深色主题时触发。回调参数中的 `theme` 表示切换后的主题，可与
getAppBaseInfo 返回的 `theme` 字段配合使用。</td><td>支持</td><td>支持</td></tr>

</tbody>
</table>

## 界面

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
</tbody>
</table>

## 界面/交互

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="ui/interaction/disableAlertBeforeUnload">disableAlertBeforeUnload</a></td><td>关闭页面返回前提醒。</td><td>-</td><td>-</td></tr>
<tr><td><a href="ui/interaction/enableAlertBeforeUnload">enableAlertBeforeUnload</a></td><td>开启页面返回前提醒。
当用户在应用插件的非最底层页面点击左上角返回按钮、左上角首页按钮或客户端返回键时,弹起询问弹窗

返回询问对话框只会对调用的当前页面生效，通过手势滑动返回时不会弹起询问对话框</td><td>-</td><td>-</td></tr>

<tr><td><a href="ui/interaction/getMenuButtonBoundingClientRect">getMenuButtonBoundingClientRect</a></td><td>取菜单按钮（右上角胶囊按钮）的布局位置信息。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="ui/interaction/hideLoading">hideLoading</a></td><td>隐藏当前 loading。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="ui/interaction/hideToast">hideToast</a></td><td>隐藏当前 Toast。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="ui/interaction/showActionSheet">showActionSheet</a></td><td>显示操作菜单。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="ui/interaction/showBottomSheet">showBottomSheet</a></td><td>显示豆包底部弹窗。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="ui/interaction/showLoading">showLoading</a></td><td>显示 loading 提示框。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="ui/interaction/showModal">showModal</a></td><td>显示模态对话框。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="ui/interaction/showToast">showToast</a></td><td>显示 Toast 提示。</td><td>支持</td><td>支持</td></tr>
</tbody>
</table>

## 界面/输入

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="ui/input/hideKeyboard">hideKeyboard</a></td><td>收起当前键盘。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="ui/input/onKeyboardHeightChange">onKeyboardHeightChange</a></td><td>监听键盘高度变化事件。</td><td>支持</td><td>不支持</td></tr>
</tbody>
</table>

## 开放能力/登录

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="open/login/login">login</a></td><td>获取当前豆包用户的一次性登录凭证。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="open/login/loginWithDoubaoWidget">loginWithDoubaoWidget</a></td><td>在 Widget 中拉起平台登录和隐私协议授权交互。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="open/login/postLoginResult">postLoginResult</a></td><td>向豆包回传三方 MCP 授权登录结果。</td><td>支持</td><td>支持</td></tr>
</tbody>
</table>

## 开放能力/业务能力

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="open/business/callTool">callTool</a></td><td>调用当前应用的 Tool。

豆包会根据当前应用插件页面或会话 Widget 确定应用和版本，开发者只需传入 Tool 名称和参数。
Tool 正常结果通过 `toolResult` 返回，Tool 业务错误通过 `toolError` 返回，两者都会正常
resolve；调用前校验、鉴权或返回结构校验失败时 Promise reject。</td><td>支持</td><td>支持</td></tr>

<tr><td><a href="open/business/createTask">createTask</a></td><td>创建任务。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="open/business/expiredWidget">expiredWidget</a></td><td>更新过期的 Widget 为固定卡片。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="open/business/getPrivacySetting">getPrivacySetting</a></td><td>获取隐私设置状态。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="open/business/sendFollowUpMessage">sendFollowUpMessage</a></td><td>以用户身份发送后续消息，触发新一轮对话、API 调用或引导模型响应。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="open/business/updateModelContext">updateModelContext</a></td><td>向 Agent 捐赠上下文。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="open/business/updateWidget">updateWidget</a></td><td>更新指定 Widget 卡片实例的渲染数据。

用于卡片内操作后刷新卡片展示、把服务端最新结果写回卡片，或由 Page 根据传入的
`widgetInstanceId` 更新原卡片；需要替换卡片类型时可同时传入新的 `widgetId`。

`widgetData` 与 `toolResult` 二选一。传入 `toolResult` 时不能切换 `widgetId`，
结构化结果必须符合当前应用的 Entity 协议。切换 `widgetId` 时不能关闭重新创建。</td><td>支持</td><td>支持</td></tr>

</tbody>
</table>

## 开放能力/支付

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="open/payment/createSignOrder">createSignOrder</a></td><td>创建三方纯签约流程所需的签约单。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="open/payment/dypay">dypay</a></td><td>发起抖音支付流程。</td><td>-</td><td>-</td></tr>
<tr><td><a href="open/payment/getOrderPayment">getOrderPayment</a></td><td>使用预下单返回的平台交易订单号拉起用户收银台。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="open/payment/getOrderPaymentWithSign">getOrderPaymentWithSign</a></td><td>使用预下单号和签约参数拉起支付并签约收银台。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="open/payment/requestOrder">requestOrder</a></td><td>交易预下单，获取拉起收银台所需的平台交易订单号。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="open/payment/sign">sign</a></td><td>使用三方纯签约的签约单号拉起用户签约页面。</td><td>支持</td><td>支持</td></tr>
</tbody>
</table>

## 路由

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="router/exitApp">exitApp</a></td><td>退出当前所有页面。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="router/navigateBack">navigateBack</a></td><td>关闭当前页面，返回上一页面或多级页面。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="router/navigateTo">navigateTo</a></td><td>保留当前页面，跳转到应用内的某个页面。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="router/navigateToDouyinMiniProgram">navigateToDouyinMiniProgram</a></td><td>在豆包内打开指定版本的抖音应用插件。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="router/openPage">openPage</a></td><td>打开应用内页面。

在主对话流卡片中调用时会重新打开全页并忽略 `mode`；在全页或全页内 Chat UI 的卡片中调用时按照
`mode` 操作页面栈。</td><td>-</td><td>-</td></tr>

<tr><td><a href="router/openPageInChat">openPageInChat</a></td><td>在当前关联的主对话流中以半屏形式打开应用内页面。

调用后不会创建或操作全页页面栈。需要进入全页应用插件或操作已有页面栈时，请使用 openPage。</td><td>支持</td><td>支持</td></tr>

<tr><td><a href="router/redirectTo">redirectTo</a></td><td>关闭当前页面，跳转到应用内的某个页面。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="router/reLaunch">reLaunch</a></td><td>关闭所有页面并跳转到应用内页面。</td><td>支持</td><td>不支持</td></tr>
</tbody>
</table>

## 媒体

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="media/chooseImage">chooseImage</a></td><td>选择图片。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="media/compressImage">compressImage</a></td><td>压缩图片。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="media/createInnerAudioContext">createInnerAudioContext</a></td><td>创建一个内部音频上下文。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="media/getBackgroundAudioManager">getBackgroundAudioManager</a></td><td>获取全局唯一的背景音频管理器。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="media/getImageInfo">getImageInfo</a></td><td>获取图片信息。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="media/getRecorderManager">getRecorderManager</a></td><td>获取全局唯一的录音管理器。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="media/previewImage">previewImage</a></td><td>预览图片。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="media/saveImageToPhotosAlbum">saveImageToPhotosAlbum</a></td><td>保存图片到系统相册。

需要先确保应用已具备写入系统相册的权限。</td><td>支持</td><td>不支持</td></tr>

</tbody>
</table>

## 设备/电池

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="device/battery/getBatteryInfo">getBatteryInfo</a></td><td>获取电池信息。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/battery/onBatteryInfoChange">onBatteryInfoChange</a></td><td>监听电池信息变化事件。</td><td>支持</td><td>不支持</td></tr>
</tbody>
</table>

## 设备/电话

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="device/phone/makePhoneCall">makePhoneCall</a></td><td>拨打电话。</td><td>支持</td><td>支持</td></tr>
</tbody>
</table>

## 设备/短信

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="device/sms/sendSms">sendSms</a></td><td>拉起系统短信发送面板。</td><td>支持</td><td>支持</td></tr>
</tbody>
</table>

## 设备/基础信息

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="device/info/getDeviceInfo">getDeviceInfo</a></td><td>获取设备基础信息。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="device/info/getDeviceInfoSync">getDeviceInfoSync</a></td><td>同步获取设备基础信息。</td><td>支持</td><td>支持</td></tr>
</tbody>
</table>

## 设备/加密

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="device/crypto/getRandomValues">getRandomValues</a></td><td>获取安全随机数。</td><td>支持</td><td>不支持</td></tr>
</tbody>
</table>

## 设备/加速度计

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="device/accelerometer/onAccelerometerChange">onAccelerometerChange</a></td><td>监听加速度数据变化事件。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/accelerometer/startAccelerometer">startAccelerometer</a></td><td>开始监听加速度。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/accelerometer/stopAccelerometer">stopAccelerometer</a></td><td>停止监听加速度。</td><td>支持</td><td>不支持</td></tr>
</tbody>
</table>

## 设备/剪贴板

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="device/clipboard/getClipboardData">getClipboardData</a></td><td>获取剪贴板内容。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="device/clipboard/setClipboardData">setClipboardData</a></td><td>设置系统剪贴板内容。</td><td>支持</td><td>支持</td></tr>
</tbody>
</table>

## 设备/蓝牙

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="device/bluetooth/closeBLEConnection">closeBLEConnection</a></td><td>关闭 BLE 连接。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/bluetooth/closeBluetoothAdapter">closeBluetoothAdapter</a></td><td>关闭蓝牙适配器。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/bluetooth/createBLEConnection">createBLEConnection</a></td><td>创建 BLE 连接。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/bluetooth/getBLEDeviceCharacteristics">getBLEDeviceCharacteristics</a></td><td>获取 BLE 特征值列表。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/bluetooth/getBLEDeviceRSSI">getBLEDeviceRSSI</a></td><td>获取 BLE 设备 RSSI。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/bluetooth/getBLEDeviceServices">getBLEDeviceServices</a></td><td>获取 BLE 服务列表。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/bluetooth/getBLEMTU">getBLEMTU</a></td><td>获取 BLE MTU。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/bluetooth/getBluetoothAdapterState">getBluetoothAdapterState</a></td><td>获取蓝牙适配器状态。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/bluetooth/getBluetoothDevices">getBluetoothDevices</a></td><td>获取当前蓝牙模块发现的设备列表。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/bluetooth/getConnectedBluetoothDevices">getConnectedBluetoothDevices</a></td><td>获取已连接的蓝牙设备列表。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/bluetooth/isBluetoothDevicePaired">isBluetoothDevicePaired</a></td><td>查询蓝牙设备是否已经配对。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/bluetooth/makeBluetoothPair">makeBluetoothPair</a></td><td>发起蓝牙配对。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/bluetooth/notifyBLECharacteristicValueChange">notifyBLECharacteristicValueChange</a></td><td>订阅 BLE 特征值变化。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/bluetooth/onBLECharacteristicValueChange">onBLECharacteristicValueChange</a></td><td>注册 BLE 特征值变化回调。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/bluetooth/onBLEConnectionStateChange">onBLEConnectionStateChange</a></td><td>注册 BLE 连接状态变化回调。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/bluetooth/onBluetoothAdapterStateChange">onBluetoothAdapterStateChange</a></td><td>注册蓝牙适配器状态变化回调。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/bluetooth/onBluetoothDeviceFound">onBluetoothDeviceFound</a></td><td>注册发现蓝牙设备回调。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/bluetooth/openBluetoothAdapter">openBluetoothAdapter</a></td><td>打开蓝牙适配器。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/bluetooth/readBLECharacteristicValue">readBLECharacteristicValue</a></td><td>读取 BLE 特征值。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/bluetooth/setBLEMTU">setBLEMTU</a></td><td>设置 BLE MTU。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/bluetooth/startBluetoothDevicesDiscovery">startBluetoothDevicesDiscovery</a></td><td>开始搜索附近的蓝牙设备。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/bluetooth/stopBluetoothDevicesDiscovery">stopBluetoothDevicesDiscovery</a></td><td>停止搜索附近的蓝牙设备。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/bluetooth/writeBLECharacteristicValue">writeBLECharacteristicValue</a></td><td>写入 BLE 特征值。</td><td>支持</td><td>不支持</td></tr>
</tbody>
</table>

## 设备/罗盘

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="device/compass/onCompassChange">onCompassChange</a></td><td>监听罗盘数据变化事件。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/compass/startCompass">startCompass</a></td><td>开始监听罗盘。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/compass/stopCompass">stopCompass</a></td><td>停止监听罗盘。</td><td>支持</td><td>不支持</td></tr>
</tbody>
</table>

## 设备/屏幕

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="device/screen/disableUserScreenRecord">disableUserScreenRecord</a></td><td>禁止用户录屏。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/screen/enableUserScreenRecord">enableUserScreenRecord</a></td><td>允许用户录屏。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/screen/getScreenBrightness">getScreenBrightness</a></td><td>获取屏幕亮度。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/screen/onUserCaptureScreen">onUserCaptureScreen</a></td><td>监听用户主动截屏事件。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/screen/onUserScreenRecord">onUserScreenRecord</a></td><td>监听用户录屏事件。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/screen/setKeepScreenOn">setKeepScreenOn</a></td><td>设置屏幕常亮状态。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/screen/setScreenBrightness">setScreenBrightness</a></td><td>设置屏幕亮度。</td><td>支持</td><td>不支持</td></tr>
</tbody>
</table>

## 设备/日历

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="device/calendar/addPhoneCalendar">addPhoneCalendar</a></td><td>向系统日历添加事件。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="device/calendar/addPhoneRepeatCalendar">addPhoneRepeatCalendar</a></td><td>向系统日历添加重复事件。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="device/calendar/deletePhoneCalendar">deletePhoneCalendar</a></td><td>按标题和原始时间删除全部匹配的系统日历事件。</td><td>支持</td><td>支持</td></tr>
</tbody>
</table>

## 设备/扫码

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="device/scan/scanCode">scanCode</a></td><td>调起扫码能力。</td><td>支持</td><td>支持</td></tr>
</tbody>
</table>

## 设备/设备方向

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="device/device-motion/onDeviceMotionChange">onDeviceMotionChange</a></td><td>监听设备方向变化事件。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/device-motion/startDeviceMotionListening">startDeviceMotionListening</a></td><td>开始监听设备方向变化。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/device-motion/stopDeviceMotionListening">stopDeviceMotionListening</a></td><td>停止监听设备方向变化。</td><td>支持</td><td>不支持</td></tr>
</tbody>
</table>

## 设备/陀螺仪

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="device/gyroscope/onGyroscopeChange">onGyroscopeChange</a></td><td>监听陀螺仪数据变化事件。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/gyroscope/startGyroscope">startGyroscope</a></td><td>开始监听陀螺仪。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/gyroscope/stopGyroscope">stopGyroscope</a></td><td>停止监听陀螺仪。</td><td>支持</td><td>不支持</td></tr>
</tbody>
</table>

## 设备/网络

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="device/network/getNetworkType">getNetworkType</a></td><td>获取当前网络类型。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/network/onNetworkStatusChange">onNetworkStatusChange</a></td><td>监听网络状态变化事件。</td><td>支持</td><td>不支持</td></tr>
</tbody>
</table>

## 设备/无障碍

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="device/accessibility/checkIsOpenAccessibility">checkIsOpenAccessibility</a></td><td>检测无障碍能力是否开启。</td><td>支持</td><td>-</td></tr>
</tbody>
</table>

## 设备/震动

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="device/vibration/vibrateLong">vibrateLong</a></td><td>触发长震动。</td><td>支持</td><td>支持</td></tr>
<tr><td><a href="device/vibration/vibrateShort">vibrateShort</a></td><td>触发短震动。</td><td>支持</td><td>支持</td></tr>
</tbody>
</table>

## 设备/iBeacon

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="device/ibeacon/getBeacons">getBeacons</a></td><td>获取已搜索到的 iBeacon 列表。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/ibeacon/startBeaconDiscovery">startBeaconDiscovery</a></td><td>开始搜索附近的 iBeacon。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/ibeacon/stopBeaconDiscovery">stopBeaconDiscovery</a></td><td>停止搜索附近的 iBeacon。</td><td>支持</td><td>不支持</td></tr>
</tbody>
</table>

## 设备/Wi-Fi

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="device/wifi/connectWifi">connectWifi</a></td><td>连接指定 Wi-Fi。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/wifi/getConnectedWifi">getConnectedWifi</a></td><td>获取当前已连接 Wi-Fi 信息。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/wifi/getWifiList">getWifiList</a></td><td>获取 Wi-Fi 列表。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/wifi/onWifiConnected">onWifiConnected</a></td><td>监听连接上 Wi-Fi 的事件。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/wifi/setWifiList">setWifiList</a></td><td>设置 Wi-Fi 预设列表（iOS 特有）。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/wifi/startWifi">startWifi</a></td><td>初始化 Wi-Fi 模块。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="device/wifi/stopWifi">stopWifi</a></td><td>关闭 Wi-Fi 模块。</td><td>支持</td><td>不支持</td></tr>
</tbody>
</table>

## 数据分析

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="data-analysis/reportEvent">reportEvent</a></td><td>上报数据分析事件。</td><td>支持</td><td>支持</td></tr>
</tbody>
</table>

## 网络

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="network/connectSocket">connectSocket</a></td><td>创建一个 WebSocket 连接，并返回可操作该连接的 SocketTask。

该 API 会同步返回 `SocketTask`，但连接创建本身是异步过程。调用方应先在返回的
`SocketTask` 上注册事件回调，再等待 `onOpen` 表示连接可用。后续发送消息使用
`SocketTask.send`，关闭连接使用 `SocketTask.close`。</td><td>支持</td><td>不支持</td></tr>

<tr><td><a href="network/downloadFile">downloadFile</a></td><td>下载文件，并返回可取消、可监听进度的 DownloadTask。</td><td>支持</td><td>不支持</td></tr>
<tr><td><a href="network/request">request</a></td><td>发起网络请求。

`request` 本身不接受泛型参数；如需业务数据类型，请读取 `result.data` 后再做类型收窄或断言。</td><td>支持</td><td>支持</td></tr>

<tr><td><a href="network/uploadFile">uploadFile</a></td><td>上传本地文件，并返回可用于监听进度和中断上传的 UploadTask。</td><td>支持</td><td>不支持</td></tr>
</tbody>
</table>

## 文件系统

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="file-system/getFileSystemManager">getFileSystemManager</a></td><td>获取文件系统管理器。</td><td>支持</td><td>不支持</td></tr>
</tbody>
</table>

## 自定义通信

<table>
<thead>
<tr><th>API</th><th>说明</th><th>页面</th><th>卡片</th></tr>
</thead>
<tbody>
<tr><td><a href="custom/createCustomEvent">createCustomEvent</a></td><td>创建一组用于发送和监听自定义事件的函数。</td><td>支持</td><td>支持</td></tr>
</tbody>
</table>
