@doubao-apps/ai 0.0.26 → 0.0.27

package/dist/skills/doubao-apps-dev/.ai/reference/open-api.md

@@ -1,8 +1,8 @@
-# Open API 速查
+# Open API
 
-> 公开可用的端能力 API。默认从 `@doubao-apps/framework/api` 导入；本文件根据 `packages/open-api/src` 的导出结构自动生成，只保留 API 名称、签名、用途、参数类型、结果类型和关键注意点。
+> 公开可用的端能力 API。默认从 `@doubao-apps/framework/api` 导入；本文件根据 `packages/open-api/src` 的导出结构自动生成，按模块列出 API 名称和说明。
 
-覆盖 115 个函数。详细信息请查看 [Open API 目录](open-api/README.md)，精确字段也可按参数/结果类型名查看 IDE 类型提示或 `@doubao-apps/framework/api` 类型定义。
+覆盖 119 个函数。详细参数、返回值、示例和相关类型请查看 [Open API 目录](open-api/README.md)，精确字段也可按参数/结果类型名查看 IDE 类型提示或 `@doubao-apps/framework/api` 类型定义。
 
 ## 使用方式
 
@@ -14,197 +14,313 @@ import { showToast, request, getStorage } from '@doubao-apps/framework/api';
 
 账号、授权、宿主基础信息、窗口信息和定位。
 
-| API | 签名 | 用途 | 参数类型 | 结果类型 | 注意点 | 详情 |
-| --- | --- | --- | --- | --- | --- | --- |
-| `getAccountInfo` | `getAccountInfo(params?): Promise<GetAccountInfoResult>` | 异步获取账号信息 | `params?` | `Promise<GetAccountInfoResult>` | - | [详情](open-api/01-基础-账号-系统.md#getaccountinfo) |
-| `getAccountInfoSync` | `getAccountInfoSync(params?): GetAccountInfoResult` | 同步获取账号信息 | `params?` | `GetAccountInfoResult` | 同步 API | [详情](open-api/01-基础-账号-系统.md#getaccountinfosync) |
-| `authorize` | `authorize(params): Promise<object>` | 初始化授权 | `params: AuthorizeRequest` | `Promise<object>` | 按 scope 申请授权 | [详情](open-api/01-基础-账号-系统.md#authorize) |
-| `canIUse` | `canIUse(params): Promise<CanIUseResult>` | 检测当前宿主是否支持指定 API 或能力 | `params: CanIUseParams` | `Promise<CanIUseResult>` | 用于兼容性判断 | [详情](open-api/01-基础-账号-系统.md#caniuse) |
-| `getLocation` | `getLocation(params?): Promise<GetLocationResponse>` | 获取设备当前的地理位置信息 | `params?: GetLocationParams` | `Promise<GetLocationResponse>` | 可能涉及定位授权 | [详情](open-api/01-基础-账号-系统.md#getlocation) |
-| `login` | `login(params?): Promise<LoginResult>` | 发起登录并获取登录凭证 | `params?: LoginRequest` | `Promise<LoginResult>` | - | [详情](open-api/01-基础-账号-系统.md#login) |
-| `getWindowInfoSync` | `getWindowInfoSync(_param?): GetWindowInfoResult` | 获取窗口信息 | `_param?` | `GetWindowInfoResult` | 同步 API | [详情](open-api/01-基础-账号-系统.md#getwindowinfosync) |
-| `getSystemSetting` | `getSystemSetting(params?): GetSystemSettingResult` | 获取设备设置 | `params?` | `GetSystemSettingResult` | - | [详情](open-api/01-基础-账号-系统.md#getsystemsetting) |
-| `getAppBaseInfoSync` | `getAppBaseInfoSync(_params?): GetAppBaseInfoResult` | 获取应用基础信息 | `_params?` | `GetAppBaseInfoResult` | 同步 API | [详情](open-api/01-基础-账号-系统.md#getappbaseinfosync) |
-| `getWindowInfo` | `getWindowInfo(_params?): Promise<GetWindowInfoResult>` | 获取窗口信息 | `_params?` | `Promise<GetWindowInfoResult>` | - | [详情](open-api/01-基础-账号-系统.md#getwindowinfo) |
-| `getAppBaseInfo` | `getAppBaseInfo(params?): Promise<GetAppBaseInfoResult>` | 获取应用基础信息 | `params?` | `Promise<GetAppBaseInfoResult>` | - | [详情](open-api/01-基础-账号-系统.md#getappbaseinfo) |
-
-## Storage
+| API | 说明 |
+| --- | --- |
+| [getAccountInfo](open-api/01-基础-账号-系统.md#getaccountinfo) | 异步获取账号信息。 |
+| [getAccountInfoSync](open-api/01-基础-账号-系统.md#getaccountinfosync) | 同步获取账号信息。<br><br>同步 API。 |
+| [authorize](open-api/01-基础-账号-系统.md#authorize) | 初始化授权。<br><br>按 scope 申请授权。 |
+| [canIUse](open-api/01-基础-账号-系统.md#caniuse) | 检测当前宿主是否支持指定 API 或能力。<br><br>用于兼容性判断。 |
+| [getLocation](open-api/01-基础-账号-系统.md#getlocation) | 获取设备当前的地理位置信息。<br><br>可能涉及定位授权。 |
+| [login](open-api/01-基础-账号-系统.md#login) | 发起登录并获取登录凭证。 |
+| [getWindowInfoSync](open-api/01-基础-账号-系统.md#getwindowinfosync) | 获取窗口信息。<br><br>同步 API。 |
+| [getSystemSetting](open-api/01-基础-账号-系统.md#getsystemsetting) | 获取设备设置。 |
+| [getAppBaseInfoSync](open-api/01-基础-账号-系统.md#getappbaseinfosync) | 获取应用基础信息。<br><br>同步 API。 |
+| [getWindowInfo](open-api/01-基础-账号-系统.md#getwindowinfo) | 获取窗口信息。 |
+| [getAppBaseInfo](open-api/01-基础-账号-系统.md#getappbaseinfo) | 获取应用基础信息。 |
+
+## 存储
 
 本地缓存；带 Sync 后缀的是同步 API。
 
-| API | 签名 | 用途 | 参数类型 | 结果类型 | 注意点 | 详情 |
-| --- | --- | --- | --- | --- | --- | --- |
-| `setStorage` | `setStorage<TData>(params): Promise<object>` | 将数据写入本地缓存 | `params: SetStorageParams<TData>` | `Promise<object>` | data 会 JSON 序列化 | [详情](open-api/02-storage.md#setstorage) |
-| `setStorageSync` | `setStorageSync<TData>(params): object` | 将数据写入本地缓存 | `params: SetStorageParams<TData>` | `object` | data 会 JSON 序列化；同步 API | [详情](open-api/02-storage.md#setstoragesync) |
-| `getStorage` | `getStorage<TData>(params): Promise<GetStorageResult<TData>>` | 从本地缓存读取数据 | `params: GetStorageParams` | `Promise<GetStorageResult<TData>>` | data 会 JSON 反序列化 | [详情](open-api/02-storage.md#getstorage) |
-| `getStorageSync` | `getStorageSync<TData>(params): GetStorageResult<TData>` | 从本地缓存同步读取数据 | `params: GetStorageParams` | `GetStorageResult<TData>` | data 会 JSON 反序列化；同步 API | [详情](open-api/02-storage.md#getstoragesync) |
-| `removeStorage` | `removeStorage(params): Promise<object>` | 删除本地缓存中指定 key 的数据 | `params: RemoveStorageParams` | `Promise<object>` | - | [详情](open-api/02-storage.md#removestorage) |
-| `removeStorageSync` | `removeStorageSync(params?): object` | 删除本地缓存中指定 key 的数据 | `params?: RemoveStorageParams` | `object` | 同步 API | [详情](open-api/02-storage.md#removestoragesync) |
-| `clearStorage` | `clearStorage(params?): Promise<object>` | 清空本地缓存 | `params?: object` | `Promise<object>` | - | [详情](open-api/02-storage.md#clearstorage) |
-| `clearStorageSync` | `clearStorageSync(params?): object` | 清空本地缓存 | `params?: object` | `object` | 同步 API | [详情](open-api/02-storage.md#clearstoragesync) |
-| `getStorageInfo` | `getStorageInfo(params?): Promise<GetStorageInfoResult>` | 获取本地缓存信息 | `params?` | `Promise<GetStorageInfoResult>` | - | [详情](open-api/02-storage.md#getstorageinfo) |
-| `getStorageInfoSync` | `getStorageInfoSync(params?): GetStorageInfoResult` | 同步获取本地缓存信息 | `params?` | `GetStorageInfoResult` | 同步 API | [详情](open-api/02-storage.md#getstorageinfosync) |
-
-## Router
+| API | 说明 |
+| --- | --- |
+| [setStorage](open-api/02-存储.md#setstorage) | 将数据写入本地缓存。 |
+| [setStorageSync](open-api/02-存储.md#setstoragesync) | 将数据写入本地缓存。<br><br>同步 API。 |
+| [getStorage](open-api/02-存储.md#getstorage) | 从本地缓存读取数据。 |
+| [getStorageSync](open-api/02-存储.md#getstoragesync) | 从本地缓存同步读取数据。<br><br>同步 API。 |
+| [removeStorage](open-api/02-存储.md#removestorage) | 删除本地缓存中指定 key 的数据。 |
+| [removeStorageSync](open-api/02-存储.md#removestoragesync) | 删除本地缓存中指定 key 的数据。<br><br>同步 API。 |
+| [clearStorage](open-api/02-存储.md#clearstorage) | 清空本地缓存。 |
+| [clearStorageSync](open-api/02-存储.md#clearstoragesync) | 清空本地缓存。<br><br>同步 API。 |
+| [getStorageInfo](open-api/02-存储.md#getstorageinfo) | 获取本地缓存信息。 |
+| [getStorageInfoSync](open-api/02-存储.md#getstorageinfosync) | 同步获取本地缓存信息。<br><br>同步 API。 |
+
+## 路由
 
 应用内页面跳转和关闭。
 
-| API | 签名 | 用途 | 参数类型 | 结果类型 | 注意点 | 详情 |
-| --- | --- | --- | --- | --- | --- | --- |
-| `close` | `close(params?): Promise<object>` | 关闭栈顶页面 | `params?: CloseParams` | `Promise<object>` | 已废弃，使用 navigateBack | [详情](open-api/03-router.md#close) |
-| `navigateTo` | `navigateTo(params): Promise<object>` | 保留当前页面，跳转到应用内的某个页面 | `params: NavigateToParams` | `Promise<object>` | - | [详情](open-api/03-router.md#navigateto) |
-| `redirectTo` | `redirectTo(params): Promise<object>` | 关闭当前页面，跳转到应用内的某个页面 | `params: NavigateToParams` | `Promise<object>` | - | [详情](open-api/03-router.md#redirectto) |
-| `reLaunch` | `reLaunch(params): Promise<object>` | 关闭所有页面并跳转到应用内页面 | `params: NavigateToParams` | `Promise<object>` | - | [详情](open-api/03-router.md#relaunch) |
-| `navigateBack` | `navigateBack(params?): Promise<object>` | 关闭当前页面，返回上一页面或多级页面 | `params?: NavigateBackParams` | `Promise<object>` | - | [详情](open-api/03-router.md#navigateback) |
-| `exitApp` | `exitApp(): Promise<object>` | 退出当前所有页面 | `-` | `Promise<object>` | 会退出当前所有页面 | [详情](open-api/03-router.md#exitapp) |
+| API | 说明 |
+| --- | --- |
+| [close](open-api/03-路由.md#close) | 关闭栈顶页面。<br><br>已废弃，使用 navigateBack。 |
+| [navigateTo](open-api/03-路由.md#navigateto) | 保留当前页面，跳转到应用内的某个页面。 |
+| [redirectTo](open-api/03-路由.md#redirectto) | 关闭当前页面，跳转到应用内的某个页面。 |
+| [reLaunch](open-api/03-路由.md#relaunch) | 关闭所有页面并跳转到应用内页面。 |
+| [navigateBack](open-api/03-路由.md#navigateback) | 关闭当前页面，返回上一页面或多级页面。 |
+| [exitApp](open-api/03-路由.md#exitapp) | 退出当前所有页面。<br><br>会退出当前所有页面。 |
 
-## UI / 交互
+## 界面 / 交互
 
 Toast、Loading、Modal、ActionSheet 和返回前提醒。
 
-| API | 签名 | 用途 | 参数类型 | 结果类型 | 注意点 | 详情 |
-| --- | --- | --- | --- | --- | --- | --- |
-| `showModal` | `showModal(params): Promise<ShowModalResult>` | 显示模态对话框 | `params: ShowModalParams` | `Promise<ShowModalResult>` | - | [详情](open-api/04-ui-交互.md#showmodal) |
-| `showLoading` | `showLoading(params?): Promise<object>` | 显示 loading 提示框 | `params?: ShowLoadingParams` | `Promise<object>` | 需调用 hideLoading 关闭 | [详情](open-api/04-ui-交互.md#showloading) |
-| `hideToast` | `hideToast(params?): Promise<object>` | 隐藏当前 Toast | `params?: HideInteractionParams` | `Promise<object>` | - | [详情](open-api/04-ui-交互.md#hidetoast) |
-| `hideLoading` | `hideLoading(params?): Promise<object>` | 隐藏当前 loading | `params?: HideInteractionParams` | `Promise<object>` | - | [详情](open-api/04-ui-交互.md#hideloading) |
-| `showActionSheet` | `showActionSheet(params): Promise<ShowActionSheetResult>` | 显示操作菜单 | `params: ShowActionSheetParams` | `Promise<ShowActionSheetResult>` | - | [详情](open-api/04-ui-交互.md#showactionsheet) |
-| `getMenuButtonBoundingClientRect` | `getMenuButtonBoundingClientRect(params?): MenuButtonBoundingClientRect` | 获取菜单按钮的布局位置信息 | `params?` | `MenuButtonBoundingClientRect` | - | [详情](open-api/04-ui-交互.md#getmenubuttonboundingclientrect) |
-| `enableAlertBeforeUnload` | `enableAlertBeforeUnload(params): Promise<object>` | 开启页面返回前提醒 | `params: EnableAlertBeforeUnloadParams` | `Promise<object>` | 配合 disableAlertBeforeUnload 使用 | [详情](open-api/04-ui-交互.md#enablealertbeforeunload) |
-| `disableAlertBeforeUnload` | `disableAlertBeforeUnload(params?): Promise<object>` | 关闭页面返回前提醒 | `params?: Record<string, never>` | `Promise<object>` | - | [详情](open-api/04-ui-交互.md#disablealertbeforeunload) |
-| `showToast` | `showToast(params): Promise<object>` | 显示 Toast 提示 | `params: ShowToastParams` | `Promise<object>` | duration 和 icon 可控制提示表现 | [详情](open-api/04-ui-交互.md#showtoast) |
+| API | 说明 |
+| --- | --- |
+| [showModal](open-api/04-界面-交互.md#showmodal) | 显示模态对话框。 |
+| [showLoading](open-api/04-界面-交互.md#showloading) | 显示 loading 提示框。<br><br>需调用 hideLoading 关闭。 |
+| [hideToast](open-api/04-界面-交互.md#hidetoast) | 隐藏当前 Toast。 |
+| [hideLoading](open-api/04-界面-交互.md#hideloading) | 隐藏当前 loading。 |
+| [showActionSheet](open-api/04-界面-交互.md#showactionsheet) | 显示操作菜单。 |
+| [getMenuButtonBoundingClientRect](open-api/04-界面-交互.md#getmenubuttonboundingclientrect) | 获取菜单按钮的布局位置信息。 |
+| [enableAlertBeforeUnload](open-api/04-界面-交互.md#enablealertbeforeunload) | 开启页面返回前提醒。<br><br>配合 disableAlertBeforeUnload 使用。 |
+| [disableAlertBeforeUnload](open-api/04-界面-交互.md#disablealertbeforeunload) | 关闭页面返回前提醒。 |
+| [showToast](open-api/04-界面-交互.md#showtoast) | 显示 Toast 提示。<br><br>duration 和 icon 可控制提示表现。 |
 
-## UI / 输入
+## 界面 / 输入
 
 键盘和输入框选区能力。
 
-| API | 签名 | 用途 | 参数类型 | 结果类型 | 注意点 | 详情 |
-| --- | --- | --- | --- | --- | --- | --- |
-| `onKeyboardHeightChange` | `onKeyboardHeightChange(handler): () => void` | 监听键盘高度变化事件 | `handler` | `() => void` | 返回取消监听函数 | [详情](open-api/05-ui-输入.md#onkeyboardheightchange) |
-| `hideKeyboard` | `hideKeyboard(params?): Promise<object>` | 收起键盘 | `params?` | `Promise<object>` | - | [详情](open-api/05-ui-输入.md#hidekeyboard) |
-| `getSelectedTextRange` | `getSelectedTextRange(params?): Promise<GetSelectedTextRangeResult>` | 获取当前输入框的选区范围 | `params?` | `Promise<GetSelectedTextRangeResult>` | - | [详情](open-api/05-ui-输入.md#getselectedtextrange) |
+| API | 说明 |
+| --- | --- |
+| [onKeyboardHeightChange](open-api/05-界面-输入.md#onkeyboardheightchange) | 监听键盘高度变化事件。<br><br>返回取消监听函数。 |
 
-## Network
+## 网络
 
-网络请求、网络类型和本机局域网 IP。
+网络请求
 
-| API | 签名 | 用途 | 参数类型 | 结果类型 | 注意点 | 详情 |
-| --- | --- | --- | --- | --- | --- | --- |
-| `request` | `request(params): Promise<RequestResponse>` | 发起网络请求 | `params: RequestParams` | `Promise<RequestResponse>` | 返回 statusCode、header 和 data | [详情](open-api/06-network.md#request) |
-| `getNetworkType` | `getNetworkType(params?): Promise<GetNetworkTypeResult>` | 获取当前网络类型 | `params?: GetNetworkTypeParams` | `Promise<GetNetworkTypeResult>` | - | [详情](open-api/06-network.md#getnetworktype) |
-| `onNetworkStatusChange` | `onNetworkStatusChange(handler): () => void` | 监听网络状态变化事件 | `handler` | `() => void` | 返回取消监听函数 | [详情](open-api/06-network.md#onnetworkstatuschange) |
-| `getLocalIPAddress` | `getLocalIPAddress(params?): Promise<GetLocalIPAddressResult>` | 获取局域网 IP 地址 | `params?` | `Promise<GetLocalIPAddressResult>` | - | [详情](open-api/06-network.md#getlocalipaddress) |
+| API | 说明 |
+| --- | --- |
+| [request](open-api/06-网络.md#request) | 发起网络请求。<br><br>返回 statusCode、header 和 data。 |
 
-## Media
+## 媒体
 
 图片选择、预览、保存、压缩和信息读取。
 
-| API | 签名 | 用途 | 参数类型 | 结果类型 | 注意点 | 详情 |
-| --- | --- | --- | --- | --- | --- | --- |
-| `saveImageToPhotosAlbum` | `saveImageToPhotosAlbum(params): Promise<object>` | 保存图片到系统相册 | `params: SaveImageToPhotosAlbumParams` | `Promise<object>` | - | [详情](open-api/07-media.md#saveimagetophotosalbum) |
-| `previewImage` | `previewImage(params): Promise<object>` | 预览图片 | `params: PreviewImageParams` | `Promise<object>` | - | [详情](open-api/07-media.md#previewimage) |
-| `getImageInfo` | `getImageInfo(params): Promise<GetImageInfoResult>` | 获取图片信息 | `params: GetImageInfoParams` | `Promise<GetImageInfoResult>` | - | [详情](open-api/07-media.md#getimageinfo) |
-| `chooseImage` | `chooseImage(params?): Promise<ChooseImageResult>` | 选择图片 | `params?: ChooseImageParams` | `Promise<ChooseImageResult>` | - | [详情](open-api/07-media.md#chooseimage) |
-| `compressImage` | `compressImage(params): Promise<CompressImageResult>` | 压缩图片 | `params: CompressImageParams` | `Promise<CompressImageResult>` | - | [详情](open-api/07-media.md#compressimage) |
+| API | 说明 |
+| --- | --- |
+| [saveImageToPhotosAlbum](open-api/07-媒体.md#saveimagetophotosalbum) | 保存图片到系统相册。 |
+| [previewImage](open-api/07-媒体.md#previewimage) | 预览图片。 |
+| [getImageInfo](open-api/07-媒体.md#getimageinfo) | 获取图片信息。 |
+| [chooseImage](open-api/07-媒体.md#chooseimage) | 选择图片。 |
+| [compressImage](open-api/07-媒体.md#compressimage) | 压缩图片。 |
 
-## Open / 业务能力
+## 开放能力 / 业务能力
 
 开放业务能力、支付、隐私设置、上下文和外部应用打开。
 
-| API | 签名 | 用途 | 参数类型 | 结果类型 | 注意点 | 详情 |
-| --- | --- | --- | --- | --- | --- | --- |
-| `getOrderPayment` | `getOrderPayment(params): Promise<GetOrderPaymentResult>` | 查询订单支付结果 | `params: GetOrderPaymentParams` | `Promise<GetOrderPaymentResult>` | - | [详情](open-api/08-open-业务能力.md#getorderpayment) |
-| `postLoginResult` | `postLoginResult(params): Promise<object>` | 回传 MCP 授权登录凭证 | `params: PostLoginResultRequest` | `Promise<object>` | - | [详情](open-api/08-open-业务能力.md#postloginresult) |
-| `getPrivacySetting` | `getPrivacySetting(params?): Promise<PrivacySettingResult>` | 获取隐私设置状态 | `params?` | `Promise<PrivacySettingResult>` | - | [详情](open-api/08-open-业务能力.md#getprivacysetting) |
-| `requestOrder` | `requestOrder(params): Promise<RequestOrderResult>` | 发起订单支付流程 | `params: RequestOrderParams` | `Promise<RequestOrderResult>` | - | [详情](open-api/08-open-业务能力.md#requestorder) |
-| `loginWithDoubaoWidget` | `loginWithDoubaoWidget(params): Promise<LoginWithWidgetResult>` | 发起豆包 Widget 登录 | `params: LoginWithWidgetRequest` | `Promise<LoginWithWidgetResult>` | - | [详情](open-api/08-open-业务能力.md#loginwithdoubaowidget) |
-| `sendQueryMessage` | `sendQueryMessage(params): void` | 以用户身份发送一条消息 | `params: SendQueryMessageParams` | `void` | 返回 void，不是 Promise | [详情](open-api/08-open-业务能力.md#sendquerymessage) |
-| `updateModelContext` | `updateModelContext(params?): Promise<object>` | 向 Agent 捐赠上下文 | `params?: UpdateModelContextParams` | `Promise<object>` | - | [详情](open-api/08-open-业务能力.md#updatemodelcontext) |
-| `setAdditionalContext` | `setAdditionalContext(params): Promise<object>` | 设置全局上下文供大模型理解 | `params: SetAdditionalContextParams` | `Promise<object>` | 设置全局上下文 | [详情](open-api/08-open-业务能力.md#setadditionalcontext) |
-| `dispatchActionDirective` | `dispatchActionDirective(params): Promise<object>` | 描述用户行为，约束模型行为及指定执行路径 | `params: DispatchActionDirectiveParams` | `Promise<object>` | - | [详情](open-api/08-open-业务能力.md#dispatchactiondirective) |
-| `updateWidget` | `updateWidget(params): Promise<object>` | 更新指定卡片 | `params: UpdateWidgetParams` | `Promise<object>` | - | [详情](open-api/08-open-业务能力.md#updatewidget) |
-| `openApp` | `openApp(params): Promise<OpenAppResult>` | 通过 deep link 等方式打开外部应用 | `params: OpenAppRequest` | `Promise<OpenAppResult>` | - | [详情](open-api/08-open-业务能力.md#openapp) |
-
-## Device / Bluetooth
+| API | 说明 |
+| --- | --- |
+| [getOrderPayment](open-api/08-开放能力-业务能力.md#getorderpayment) | 查询订单支付结果。 |
+| [postLoginResult](open-api/08-开放能力-业务能力.md#postloginresult) | 回传 MCP 授权登录凭证。 |
+| [getPrivacySetting](open-api/08-开放能力-业务能力.md#getprivacysetting) | 获取隐私设置状态。 |
+| [requestOrder](open-api/08-开放能力-业务能力.md#requestorder) | 发起订单支付流程。 |
+| [loginWithDoubaoWidget](open-api/08-开放能力-业务能力.md#loginwithdoubaowidget) | 发起豆包 Widget 登录。 |
+| [sendQueryMessage](open-api/08-开放能力-业务能力.md#sendquerymessage) | 以用户身份发送一条消息。<br><br>返回 void，不是 Promise。 |
+| [updateModelContext](open-api/08-开放能力-业务能力.md#updatemodelcontext) | 向 Agent 捐赠上下文。 |
+| [setAdditionalContext](open-api/08-开放能力-业务能力.md#setadditionalcontext) | 设置全局上下文供大模型理解。<br><br>设置全局上下文。 |
+| [dispatchActionDirective](open-api/08-开放能力-业务能力.md#dispatchactiondirective) | 描述用户行为，约束模型行为及指定执行路径。 |
+| [updateWidget](open-api/08-开放能力-业务能力.md#updatewidget) | 更新指定卡片。 |
+| [expiredWidget](open-api/08-开放能力-业务能力.md#expiredwidget) | 更新过期的 widget 为固定卡片。 |
+| [openApp](open-api/08-开放能力-业务能力.md#openapp) | 通过 deep link 等方式打开外部应用。 |
+
+## 设备 / 蓝牙
 
 蓝牙和 BLE 能力；通常先打开适配器，再扫描、连接和读写。
 
-| API | 签名 | 用途 | 参数类型 | 结果类型 | 注意点 | 详情 |
-| --- | --- | --- | --- | --- | --- | --- |
-| `openBluetoothAdapter` | `openBluetoothAdapter(params?): Promise<object>` | 打开蓝牙适配器 | `params?: OpenBluetoothAdapterParams` | `Promise<object>` | 蓝牙流程入口 | [详情](open-api/09-device-bluetooth.md#openbluetoothadapter) |
-| `startBluetoothDevicesDiscovery` | `startBluetoothDevicesDiscovery(params?): Promise<object>` | 开始搜索附近的蓝牙设备 | `params?: StartBluetoothDevicesDiscoveryParams` | `Promise<object>` | 通常先调用 openBluetoothAdapter | [详情](open-api/09-device-bluetooth.md#startbluetoothdevicesdiscovery) |
-| `stopBluetoothDevicesDiscovery` | `stopBluetoothDevicesDiscovery(params?): Promise<object>` | 停止搜索附近的蓝牙设备 | `params?` | `Promise<object>` | - | [详情](open-api/09-device-bluetooth.md#stopbluetoothdevicesdiscovery) |
-| `getBluetoothAdapterState` | `getBluetoothAdapterState(params?): Promise<GetBluetoothAdapterStateResult>` | 获取蓝牙适配器状态 | `params?` | `Promise<GetBluetoothAdapterStateResult>` | - | [详情](open-api/09-device-bluetooth.md#getbluetoothadapterstate) |
-| `getBluetoothDevices` | `getBluetoothDevices(params?): Promise<GetBluetoothDevicesResult>` | 获取当前蓝牙模块发现的设备列表 | `params?` | `Promise<GetBluetoothDevicesResult>` | 通常先调用 startBluetoothDevicesDiscovery | [详情](open-api/09-device-bluetooth.md#getbluetoothdevices) |
-| `getConnectedBluetoothDevices` | `getConnectedBluetoothDevices(params): Promise<GetConnectedBluetoothDevicesResult>` | 获取已连接的蓝牙设备列表 | `params: GetConnectedBluetoothDevicesParams` | `Promise<GetConnectedBluetoothDevicesResult>` | - | [详情](open-api/09-device-bluetooth.md#getconnectedbluetoothdevices) |
-| `makeBluetoothPair` | `makeBluetoothPair(params): Promise<object>` | 发起蓝牙配对 | `params: MakeBluetoothPairParams` | `Promise<object>` | - | [详情](open-api/09-device-bluetooth.md#makebluetoothpair) |
-| `isBluetoothDevicePaired` | `isBluetoothDevicePaired(params): Promise<object>` | 查询蓝牙设备是否已经配对 | `params: IsBluetoothDevicePairedParams` | `Promise<object>` | - | [详情](open-api/09-device-bluetooth.md#isbluetoothdevicepaired) |
-| `closeBluetoothAdapter` | `closeBluetoothAdapter(params?): Promise<object>` | 关闭蓝牙适配器 | `params?` | `Promise<object>` | 会关闭蓝牙模块 | [详情](open-api/09-device-bluetooth.md#closebluetoothadapter) |
-| `createBLEConnection` | `createBLEConnection(params): Promise<object>` | 创建 BLE 连接 | `params: CreateBLEConnectionParams` | `Promise<object>` | 需要传入 deviceId | [详情](open-api/09-device-bluetooth.md#createbleconnection) |
-| `closeBLEConnection` | `closeBLEConnection(params): Promise<object>` | 关闭 BLE 连接 | `params: CloseBLEConnectionParams` | `Promise<object>` | - | [详情](open-api/09-device-bluetooth.md#closebleconnection) |
-| `getBLEDeviceServices` | `getBLEDeviceServices(params): Promise<GetBLEDeviceServicesResult>` | 获取 BLE 服务列表 | `params: GetBLEDeviceServicesParams` | `Promise<GetBLEDeviceServicesResult>` | 通常先调用 createBLEConnection | [详情](open-api/09-device-bluetooth.md#getbledeviceservices) |
-| `getBLEDeviceCharacteristics` | `getBLEDeviceCharacteristics(params): Promise<GetBLEDeviceCharacteristicsResult>` | 获取 BLE 特征值列表 | `params: GetBLEDeviceCharacteristicsParams` | `Promise<GetBLEDeviceCharacteristicsResult>` | 通常先获取 BLE 服务列表 | [详情](open-api/09-device-bluetooth.md#getbledevicecharacteristics) |
-| `getBLEDeviceRSSI` | `getBLEDeviceRSSI(params): Promise<GetBLEDeviceRSSIResult>` | 获取 BLE 设备 RSSI | `params: GetBLEDeviceRSSIParams` | `Promise<GetBLEDeviceRSSIResult>` | - | [详情](open-api/09-device-bluetooth.md#getbledevicerssi) |
-| `getBLEMTU` | `getBLEMTU(params): Promise<GetBLEMTUResult>` | 获取 BLE MTU | `params: GetBLEMTUParams` | `Promise<GetBLEMTUResult>` | - | [详情](open-api/09-device-bluetooth.md#getblemtu) |
-| `notifyBLECharacteristicValueChange` | `notifyBLECharacteristicValueChange(params): Promise<object>` | 订阅 BLE 特征值变化 | `params: NotifyBLECharacteristicValueChangeParams` | `Promise<object>` | 订阅指定特征值变化 | [详情](open-api/09-device-bluetooth.md#notifyblecharacteristicvaluechange) |
-| `readBLECharacteristicValue` | `readBLECharacteristicValue(params): Promise<object>` | 读取 BLE 特征值 | `params: ReadBLECharacteristicValueParams` | `Promise<object>` | 需要传入 serviceId 和 characteristicId | [详情](open-api/09-device-bluetooth.md#readblecharacteristicvalue) |
-| `setBLEMTU` | `setBLEMTU(params): Promise<SetBLEMTUResult>` | 设置 BLE MTU | `params: SetBLEMTUParams` | `Promise<SetBLEMTUResult>` | - | [详情](open-api/09-device-bluetooth.md#setblemtu) |
-| `writeBLECharacteristicValue` | `writeBLECharacteristicValue(params): Promise<object>` | 写入 BLE 特征值 | `params: WriteBLECharacteristicValueParams` | `Promise<object>` | value 需要是 ArrayBuffer。 ## Enumerations ### ActionDirectiveType | [详情](open-api/09-device-bluetooth.md#writeblecharacteristicvalue) |
-
-## Device / Wi-Fi
+| API | 说明 |
+| --- | --- |
+| [openBluetoothAdapter](open-api/09-设备-蓝牙.md#openbluetoothadapter) | 打开蓝牙适配器。<br><br>蓝牙流程入口。 |
+| [startBluetoothDevicesDiscovery](open-api/09-设备-蓝牙.md#startbluetoothdevicesdiscovery) | 开始搜索附近的蓝牙设备。<br><br>通常先调用 openBluetoothAdapter。 |
+| [stopBluetoothDevicesDiscovery](open-api/09-设备-蓝牙.md#stopbluetoothdevicesdiscovery) | 停止搜索附近的蓝牙设备。 |
+| [getBluetoothAdapterState](open-api/09-设备-蓝牙.md#getbluetoothadapterstate) | 获取蓝牙适配器状态。 |
+| [getBluetoothDevices](open-api/09-设备-蓝牙.md#getbluetoothdevices) | 获取当前蓝牙模块发现的设备列表。<br><br>通常先调用 startBluetoothDevicesDiscovery。 |
+| [getConnectedBluetoothDevices](open-api/09-设备-蓝牙.md#getconnectedbluetoothdevices) | 获取已连接的蓝牙设备列表。 |
+| [makeBluetoothPair](open-api/09-设备-蓝牙.md#makebluetoothpair) | 发起蓝牙配对。 |
+| [isBluetoothDevicePaired](open-api/09-设备-蓝牙.md#isbluetoothdevicepaired) | 查询蓝牙设备是否已经配对。 |
+| [closeBluetoothAdapter](open-api/09-设备-蓝牙.md#closebluetoothadapter) | 关闭蓝牙适配器。<br><br>会关闭蓝牙模块。 |
+| [createBLEConnection](open-api/09-设备-蓝牙.md#createbleconnection) | 创建 BLE 连接。<br><br>需要传入 deviceId。 |
+| [closeBLEConnection](open-api/09-设备-蓝牙.md#closebleconnection) | 关闭 BLE 连接。 |
+| [getBLEDeviceServices](open-api/09-设备-蓝牙.md#getbledeviceservices) | 获取 BLE 服务列表。<br><br>通常先调用 createBLEConnection。 |
+| [getBLEDeviceCharacteristics](open-api/09-设备-蓝牙.md#getbledevicecharacteristics) | 获取 BLE 特征值列表。<br><br>通常先获取 BLE 服务列表。 |
+| [getBLEDeviceRSSI](open-api/09-设备-蓝牙.md#getbledevicerssi) | 获取 BLE 设备 RSSI。 |
+| [getBLEMTU](open-api/09-设备-蓝牙.md#getblemtu) | 获取 BLE MTU。 |
+| [notifyBLECharacteristicValueChange](open-api/09-设备-蓝牙.md#notifyblecharacteristicvaluechange) | 订阅 BLE 特征值变化。<br><br>订阅指定特征值变化。 |
+| [readBLECharacteristicValue](open-api/09-设备-蓝牙.md#readblecharacteristicvalue) | 读取 BLE 特征值。<br><br>需要传入 serviceId 和 characteristicId。 |
+| [setBLEMTU](open-api/09-设备-蓝牙.md#setblemtu) | 设置 BLE MTU。 |
+| [writeBLECharacteristicValue](open-api/09-设备-蓝牙.md#writeblecharacteristicvalue) | 写入 BLE 特征值。<br><br>value 需要是 ArrayBuffer。 |
+
+## 设备 / Wi-Fi
 
 Wi-Fi 模块能力；通常先 startWifi，再获取列表或连接。
 
-| API | 签名 | 用途 | 参数类型 | 结果类型 | 注意点 | 详情 |
-| --- | --- | --- | --- | --- | --- | --- |
-| `startWifi` | `startWifi(params?): Promise<object>` | 初始化 Wi-Fi 模块 | `params?` | `Promise<object>` | Wi-Fi 流程入口 | [详情](open-api/10-device-wi-fi.md#startwifi) |
-| `stopWifi` | `stopWifi(params?): Promise<object>` | 关闭 Wi-Fi 模块 | `params?` | `Promise<object>` | - | [详情](open-api/10-device-wi-fi.md#stopwifi) |
-| `setWifiList` | `setWifiList(params): Promise<object>` | 设置 Wi-Fi 预设列表 | `params: SetWifiListParams` | `Promise<object>` | 用于预设 Wi-Fi 列表 | [详情](open-api/10-device-wi-fi.md#setwifilist) |
-| `connectWifi` | `connectWifi(params): Promise<object>` | 连接指定 Wi-Fi | `params: ConnectWifiParams` | `Promise<object>` | 通常先调用 startWifi | [详情](open-api/10-device-wi-fi.md#connectwifi) |
-| `getConnectedWifi` | `getConnectedWifi(params?): Promise<GetConnectedWifiResult>` | 获取当前已连接 Wi-Fi 信息 | `params?: GetConnectedWifiParams` | `Promise<GetConnectedWifiResult>` | - | [详情](open-api/10-device-wi-fi.md#getconnectedwifi) |
-| `getWifiList` | `getWifiList(params?): Promise<GetWifiListResult>` | 获取 Wi-Fi 列表 | `params?` | `Promise<GetWifiListResult>` | 通常先调用 startWifi | [详情](open-api/10-device-wi-fi.md#getwifilist) |
-
-## Device / 传感器
-
-加速度、罗盘、陀螺仪、设备方向和 iBeacon。
-
-| API | 签名 | 用途 | 参数类型 | 结果类型 | 注意点 | 详情 |
-| --- | --- | --- | --- | --- | --- | --- |
-| `startAccelerometer` | `startAccelerometer(params?): Promise<object>` | 开始监听加速度 | `params?: StartAccelerometerParams` | `Promise<object>` | 需配对调用 stopAccelerometer | [详情](open-api/11-device-传感器.md#startaccelerometer) |
-| `stopAccelerometer` | `stopAccelerometer(params?): Promise<object>` | 停止监听加速度 | `params?` | `Promise<object>` | - | [详情](open-api/11-device-传感器.md#stopaccelerometer) |
-| `startBeaconDiscovery` | `startBeaconDiscovery(params): Promise<object>` | 开始搜索附近的 iBeacon | `params: StartBeaconDiscoveryParams` | `Promise<object>` | 需配对调用 stopBeaconDiscovery | [详情](open-api/11-device-传感器.md#startbeacondiscovery) |
-| `stopBeaconDiscovery` | `stopBeaconDiscovery(params?): Promise<object>` | 停止搜索附近的 iBeacon | `params?` | `Promise<object>` | - | [详情](open-api/11-device-传感器.md#stopbeacondiscovery) |
-| `getBeacons` | `getBeacons(params?): Promise<GetBeaconsResult>` | 获取已搜索到的 iBeacon 列表 | `params?` | `Promise<GetBeaconsResult>` | - | [详情](open-api/11-device-传感器.md#getbeacons) |
-| `startCompass` | `startCompass(params?): Promise<object>` | 开始监听罗盘 | `params?` | `Promise<object>` | 需配对调用 stopCompass | [详情](open-api/11-device-传感器.md#startcompass) |
-| `stopCompass` | `stopCompass(params?): Promise<object>` | 停止监听罗盘 | `params?` | `Promise<object>` | - | [详情](open-api/11-device-传感器.md#stopcompass) |
-| `onCompassChange` | `onCompassChange(handler): () => void` | 监听罗盘数据变化事件 | `handler` | `() => void` | 返回取消监听函数 | [详情](open-api/11-device-传感器.md#oncompasschange) |
-| `startDeviceMotionListening` | `startDeviceMotionListening(params?): Promise<object>` | 开始监听设备方向变化 | `params?: StartDeviceMotionListeningParams` | `Promise<object>` | 需配对调用 stopDeviceMotionListening | [详情](open-api/11-device-传感器.md#startdevicemotionlistening) |
-| `stopDeviceMotionListening` | `stopDeviceMotionListening(params?): Promise<object>` | 停止监听设备方向变化 | `params?` | `Promise<object>` | - | [详情](open-api/11-device-传感器.md#stopdevicemotionlistening) |
-| `startGyroscope` | `startGyroscope(params?): Promise<object>` | 开始监听陀螺仪 | `params?: StartGyroscopeParams` | `Promise<object>` | 需配对调用 stopGyroscope | [详情](open-api/11-device-传感器.md#startgyroscope) |
-| `stopGyroscope` | `stopGyroscope(params?): Promise<object>` | 停止监听陀螺仪 | `params?` | `Promise<object>` | - | [详情](open-api/11-device-传感器.md#stopgyroscope) |
-
-## Device / 本地能力
-
-剪贴板、电话、联系人、日历、扫码、屏幕、震动等系统能力。
-
-| API | 签名 | 用途 | 参数类型 | 结果类型 | 注意点 | 详情 |
-| --- | --- | --- | --- | --- | --- | --- |
-| `sendSms` | `sendSms(params?): Promise<object>` | 拉起系统短信发送面板 | `params?: SendSmsParams` | `Promise<object>` | - | [详情](open-api/12-device-本地能力.md#sendsms) |
-| `checkIsOpenAccessibility` | `checkIsOpenAccessibility(params?): Promise<CheckIsOpenAccessibilityResult>` | 检测无障碍能力是否开启 | `params?` | `Promise<CheckIsOpenAccessibilityResult>` | - | [详情](open-api/12-device-本地能力.md#checkisopenaccessibility) |
-| `getBatteryInfo` | `getBatteryInfo(params?): Promise<GetBatteryInfoResult>` | 获取电池信息 | `params?` | `Promise<GetBatteryInfoResult>` | - | [详情](open-api/12-device-本地能力.md#getbatteryinfo) |
-| `addPhoneCalendar` | `addPhoneCalendar(params): Promise<object>` | 向系统日历添加事件 | `params: AddPhoneCalendarParams` | `Promise<object>` | - | [详情](open-api/12-device-本地能力.md#addphonecalendar) |
-| `addPhoneRepeatCalendar` | `addPhoneRepeatCalendar(params): Promise<object>` | 向系统日历添加重复事件 | `params: AddPhoneRepeatCalendarParams` | `Promise<object>` | - | [详情](open-api/12-device-本地能力.md#addphonerepeatcalendar) |
-| `getClipboardData` | `getClipboardData(params?): Promise<GetClipboardDataResult>` | 获取剪贴板内容 | `params?` | `Promise<GetClipboardDataResult>` | - | [详情](open-api/12-device-本地能力.md#getclipboarddata) |
-| `setClipboardData` | `setClipboardData(params): Promise<object>` | 设置系统剪贴板内容 | `params: SetClipboardDataParams` | `Promise<object>` | - | [详情](open-api/12-device-本地能力.md#setclipboarddata) |
-| `chooseContact` | `chooseContact(params?): Promise<ChooseContactResult>` | 选择手机联系人 | `params?` | `Promise<ChooseContactResult>` | - | [详情](open-api/12-device-本地能力.md#choosecontact) |
-| `addPhoneContact` | `addPhoneContact(params): Promise<object>` | 添加手机联系人 | `params: AddPhoneContactParams` | `Promise<object>` | - | [详情](open-api/12-device-本地能力.md#addphonecontact) |
-| `getRandomValues` | `getRandomValues(params): Promise<GetRandomValuesResult>` | 获取安全随机数 | `params: GetRandomValuesParams` | `Promise<GetRandomValuesResult>` | - | [详情](open-api/12-device-本地能力.md#getrandomvalues) |
-| `makePhoneCall` | `makePhoneCall(params): Promise<object>` | 拨打电话 | `params: MakePhoneCallParams` | `Promise<object>` | - | [详情](open-api/12-device-本地能力.md#makephonecall) |
-| `scanCode` | `scanCode(params?): Promise<ScanCodeResult>` | 调起扫码能力 | `params?: ScanCodeParams` | `Promise<ScanCodeResult>` | - | [详情](open-api/12-device-本地能力.md#scancode) |
-| `getScreenBrightness` | `getScreenBrightness(params?): Promise<GetScreenBrightnessResult>` | 获取屏幕亮度 | `params?` | `Promise<GetScreenBrightnessResult>` | - | [详情](open-api/12-device-本地能力.md#getscreenbrightness) |
-| `setVisualEffectOnCapture` | `setVisualEffectOnCapture(params?): Promise<object>` | 设置截屏或录屏时的视觉表现 | `params?: SetVisualEffectOnCaptureParams` | `Promise<object>` | 控制截屏或录屏时的视觉效果 | [详情](open-api/12-device-本地能力.md#setvisualeffectoncapture) |
-| `setScreenBrightness` | `setScreenBrightness(params): Promise<object>` | 设置屏幕亮度 | `params: SetScreenBrightnessParams` | `Promise<object>` | - | [详情](open-api/12-device-本地能力.md#setscreenbrightness) |
-| `setKeepScreenOn` | `setKeepScreenOn(params): Promise<object>` | 设置屏幕常亮状态 | `params: SetKeepScreenOnParams` | `Promise<object>` | - | [详情](open-api/12-device-本地能力.md#setkeepscreenon) |
-| `onUserCaptureScreen` | `onUserCaptureScreen(handler): () => void` | 监听用户主动截屏事件 | `handler` | `() => void` | 返回取消监听函数 | [详情](open-api/12-device-本地能力.md#onusercapturescreen) |
-| `vibrateShort` | `vibrateShort(params?): Promise<object>` | 触发短震动 | `params?: VibrateShortParams` | `Promise<object>` | - | [详情](open-api/12-device-本地能力.md#vibrateshort) |
-| `vibrateLong` | `vibrateLong(params?): Promise<object>` | 触发长震动 | `params?` | `Promise<object>` | - | [详情](open-api/12-device-本地能力.md#vibratelong) |
+| API | 说明 |
+| --- | --- |
+| [startWifi](open-api/10-设备-wi-fi.md#startwifi) | 初始化 Wi-Fi 模块。<br><br>Wi-Fi 流程入口。 |
+| [stopWifi](open-api/10-设备-wi-fi.md#stopwifi) | 关闭 Wi-Fi 模块。 |
+| [setWifiList](open-api/10-设备-wi-fi.md#setwifilist) | 设置 Wi-Fi 预设列表。<br><br>用于预设 Wi-Fi 列表。 |
+| [connectWifi](open-api/10-设备-wi-fi.md#connectwifi) | 连接指定 Wi-Fi。<br><br>通常先调用 startWifi。 |
+| [getConnectedWifi](open-api/10-设备-wi-fi.md#getconnectedwifi) | 获取当前已连接 Wi-Fi 信息。 |
+| [getWifiList](open-api/10-设备-wi-fi.md#getwifilist) | 获取 Wi-Fi 列表。<br><br>通常先调用 startWifi。 |
+
+## 设备 / 加速度计
+
+加速度计监听能力。
+
+| API | 说明 |
+| --- | --- |
+| [startAccelerometer](open-api/11-设备-加速度计.md#startaccelerometer) | 开始监听加速度。<br><br>需配对调用 stopAccelerometer。 |
+| [stopAccelerometer](open-api/11-设备-加速度计.md#stopaccelerometer) | 停止监听加速度。 |
+| [onAccelerometerChange](open-api/11-设备-加速度计.md#onaccelerometerchange) | 监听加速度数据变化事件。<br><br>返回取消监听函数。 |
+
+## 设备 / iBeacon
+
+iBeacon 搜索和结果读取能力。
+
+| API | 说明 |
+| --- | --- |
+| [startBeaconDiscovery](open-api/12-设备-ibeacon.md#startbeacondiscovery) | 开始搜索附近的 iBeacon。<br><br>需配对调用 stopBeaconDiscovery。 |
+| [stopBeaconDiscovery](open-api/12-设备-ibeacon.md#stopbeacondiscovery) | 停止搜索附近的 iBeacon。 |
+| [getBeacons](open-api/12-设备-ibeacon.md#getbeacons) | 获取已搜索到的 iBeacon 列表。 |
+
+## 设备 / 罗盘
+
+罗盘监听能力。
+
+| API | 说明 |
+| --- | --- |
+| [startCompass](open-api/13-设备-罗盘.md#startcompass) | 开始监听罗盘。<br><br>需配对调用 stopCompass。 |
+| [stopCompass](open-api/13-设备-罗盘.md#stopcompass) | 停止监听罗盘。 |
+| [onCompassChange](open-api/13-设备-罗盘.md#oncompasschange) | 监听罗盘数据变化事件。<br><br>返回取消监听函数。 |
+
+## 设备 / 设备方向
+
+设备方向监听能力。
+
+| API | 说明 |
+| --- | --- |
+| [startDeviceMotionListening](open-api/14-设备-设备方向.md#startdevicemotionlistening) | 开始监听设备方向变化。<br><br>需配对调用 stopDeviceMotionListening。 |
+| [stopDeviceMotionListening](open-api/14-设备-设备方向.md#stopdevicemotionlistening) | 停止监听设备方向变化。 |
+
+## 设备 / 陀螺仪
+
+陀螺仪监听能力。
+
+| API | 说明 |
+| --- | --- |
+| [startGyroscope](open-api/15-设备-陀螺仪.md#startgyroscope) | 开始监听陀螺仪。<br><br>需配对调用 stopGyroscope。 |
+| [stopGyroscope](open-api/15-设备-陀螺仪.md#stopgyroscope) | 停止监听陀螺仪。 |
+| [onGyroscopeChange](open-api/15-设备-陀螺仪.md#ongyroscopechange) | 监听陀螺仪数据变化事件。<br><br>返回取消监听函数。 |
+
+## UI / 输入
+
+键盘和输入框选区能力。
+
+| API | 说明 |
+| --- | --- |
+| [hideKeyboard](open-api/16-ui-输入.md#hidekeyboard) | 收起键盘。 |
+| [getSelectedTextRange](open-api/16-ui-输入.md#getselectedtextrange) | 获取当前输入框的选区范围。 |
+
+## 设备 / 网络
+
+网络类型和本机局域网 IP。
+
+| API | 说明 |
+| --- | --- |
+| [getLocalIPAddress](open-api/17-设备-网络.md#getlocalipaddress) | 获取局域网 IP 地址。 |
+| [getNetworkType](open-api/17-设备-网络.md#getnetworktype) | 获取当前网络类型。 |
+| [onNetworkStatusChange](open-api/17-设备-网络.md#onnetworkstatuschange) | 监听网络状态变化事件。<br><br>返回取消监听函数。 |
+
+## 设备 / 短信
+
+拉起系统短信发送面板。
+
+| API | 说明 |
+| --- | --- |
+| [sendSms](open-api/18-设备-短信.md#sendsms) | 拉起系统短信发送面板。 |
+
+## 设备 / 无障碍
+
+检测无障碍能力开关状态。
+
+| API | 说明 |
+| --- | --- |
+| [checkIsOpenAccessibility](open-api/19-设备-无障碍.md#checkisopenaccessibility) | 检测无障碍能力是否开启。 |
+
+## 设备 / 电池
+
+电池信息读取与变化监听。
+
+| API | 说明 |
+| --- | --- |
+| [getBatteryInfo](open-api/20-设备-电池.md#getbatteryinfo) | 获取电池信息。 |
+| [onBatteryInfoChange](open-api/20-设备-电池.md#onbatteryinfochange) | 监听电池信息变化事件。<br><br>返回取消监听函数。 |
+
+## 设备 / 日历
+
+向系统日历添加事件和重复事件。
+
+| API | 说明 |
+| --- | --- |
+| [addPhoneCalendar](open-api/21-设备-日历.md#addphonecalendar) | 向系统日历添加事件。 |
+| [addPhoneRepeatCalendar](open-api/21-设备-日历.md#addphonerepeatcalendar) | 向系统日历添加重复事件。 |
+
+## 设备 / 剪贴板
+
+读取和设置系统剪贴板内容。
+
+| API | 说明 |
+| --- | --- |
+| [getClipboardData](open-api/22-设备-剪贴板.md#getclipboarddata) | 获取剪贴板内容。 |
+| [setClipboardData](open-api/22-设备-剪贴板.md#setclipboarddata) | 设置系统剪贴板内容。 |
+
+## 设备 / 联系人
+
+选择和添加手机联系人。
+
+| API | 说明 |
+| --- | --- |
+| [chooseContact](open-api/23-设备-联系人.md#choosecontact) | 选择手机联系人。 |
+| [addPhoneContact](open-api/23-设备-联系人.md#addphonecontact) | 添加手机联系人。 |
+
+## 设备 / 加密
+
+安全随机数能力。
+
+| API | 说明 |
+| --- | --- |
+| [getRandomValues](open-api/24-设备-加密.md#getrandomvalues) | 获取安全随机数。 |
+
+## 设备 / 电话
+
+拨打电话。
+
+| API | 说明 |
+| --- | --- |
+| [makePhoneCall](open-api/25-设备-电话.md#makephonecall) | 拨打电话。 |
+
+## 设备 / 扫码
+
+调起扫码并读取扫码结果。
+
+| API | 说明 |
+| --- | --- |
+| [scanCode](open-api/26-设备-扫码.md#scancode) | 调起扫码能力。 |
+
+## 设备 / 屏幕
+
+屏幕亮度、常亮和截屏/录屏相关能力。
+
+| API | 说明 |
+| --- | --- |
+| [getScreenBrightness](open-api/27-设备-屏幕.md#getscreenbrightness) | 获取屏幕亮度。 |
+| [setVisualEffectOnCapture](open-api/27-设备-屏幕.md#setvisualeffectoncapture) | 设置截屏或录屏时的视觉表现。<br><br>控制截屏或录屏时的视觉效果。 |
+| [setScreenBrightness](open-api/27-设备-屏幕.md#setscreenbrightness) | 设置屏幕亮度。 |
+| [setKeepScreenOn](open-api/27-设备-屏幕.md#setkeepscreenon) | 设置屏幕常亮状态。 |
+| [onUserCaptureScreen](open-api/27-设备-屏幕.md#onusercapturescreen) | 监听用户主动截屏事件。<br><br>返回取消监听函数。 |
+
+## 设备 / 震动
+
+触发短震动和长震动。
+
+| API | 说明 |
+| --- | --- |
+| [vibrateShort](open-api/28-设备-震动.md#vibrateshort) | 触发短震动。 |
+| [vibrateLong](open-api/28-设备-震动.md#vibratelong) | 触发长震动。 |