@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/02-/347/263/273/347/273/237.md

@@ -0,0 +1,1376 @@
+# 豆包应用插件的端能力 API: 系统
+
+豆包客户端信息、窗口信息和系统设置。
+
+[返回目录](./groups.md) | [返回速查](./quick-reference.md)
+
+## 速查
+
+| API | 说明 |
+| --- | --- |
+| [getWindowInfoSync](#getwindowinfosync) | 获取窗口信息。<br><br>同步 API。 |
+| [getSystemSetting](#getsystemsetting) | 获取设备设置。 |
+| [getAppAuthorizeSetting](#getappauthorizesetting) | 获取豆包客户端的系统授权设置。 调用只读取当前系统授权状态，不会申请权限或触发系统授权弹窗。原有状态字段固定返回 authorized、denied 或 not determined，精细授权字段用于区分部分、只读、只写、前后台等能力。 |
+| [getAppBaseInfoSync](#getappbaseinfosync) | 获取应用基础信息。<br><br>同步 API。 |
+| [getWindowInfo](#getwindowinfo) | 获取窗口信息。 |
+| [getAppBaseInfo](#getappbaseinfo) | 获取应用基础信息。 |
+| [onThemeChange](#onthemechange) | 监听应用主题变化。 当用户在系统设置或豆包客户端内切换浅色、深色主题时触发。回调参数中的 theme 表示切换后的主题，可与 getAppBaseInfo 返回的 theme 字段配合使用。<br><br>返回取消监听函数。 |
+| [getSystemInfo](#getsysteminfo) | 获取系统信息。 |
+| [getSystemInfoSync](#getsysteminfosync) | 同步获取系统信息。<br><br>同步 API。 |
+
+## API 详情
+
+<a id="getwindowinfosync"></a>
+### getWindowInfoSync()
+
+# getWindowInfoSync
+
+获取窗口信息。
+
+## 扫码预览
+![扫码预览 getWindowInfoSync](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fbasic%252Fget-window-info%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.18`。
+
+## 支持平台
+
+<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>
+
+## 调用方式
+
+### 同步 API
+
+```typescript
+getWindowInfoSync(_params?: object): GetWindowInfoResult
+```
+
+## 入参
+
+无。
+
+## 调用示例
+
+```typescript
+import { getWindowInfoSync } from '@doubao-dev/framework/api';
+
+const result = getWindowInfoSync();
+
+console.log(result.windowWidth, result.windowHeight);
+console.log(result.safeArea?.top, result.screenTop);
+```
+
+## 返回值
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>pixelRatio</code></td><td><code>number</code></td><td>是</td><td>设备像素比</td></tr>
+<tr><td><code>safeArea</code></td><td><code>WindowSafeArea</code></td><td>否</td><td>安全区域</td></tr>
+<tr><td><code>safeArea.bottom</code></td><td><code>number</code></td><td>否</td><td>安全区域右下角纵坐标</td></tr>
+<tr><td><code>safeArea.height</code></td><td><code>number</code></td><td>否</td><td>安全区域高度</td></tr>
+<tr><td><code>safeArea.left</code></td><td><code>number</code></td><td>否</td><td>安全区域左上角横坐标</td></tr>
+<tr><td><code>safeArea.right</code></td><td><code>number</code></td><td>否</td><td>安全区域右下角横坐标</td></tr>
+<tr><td><code>safeArea.top</code></td><td><code>number</code></td><td>否</td><td>安全区域左上角纵坐标</td></tr>
+<tr><td><code>safeArea.width</code></td><td><code>number</code></td><td>否</td><td>安全区域宽度</td></tr>
+<tr><td><code>screenHeight</code></td><td><code>number</code></td><td>是</td><td>屏幕高度</td></tr>
+<tr><td><code>screenTop</code></td><td><code>number</code></td><td>是</td><td>窗口上边缘的 y 值</td></tr>
+<tr><td><code>screenWidth</code></td><td><code>number</code></td><td>是</td><td>屏幕宽度</td></tr>
+<tr><td><code>statusBarHeight</code></td><td><code>number</code></td><td>是</td><td>状态栏高度</td></tr>
+<tr><td><code>windowHeight</code></td><td><code>number</code></td><td>是</td><td>可使用窗口高度</td></tr>
+<tr><td><code>windowWidth</code></td><td><code>number</code></td><td>是</td><td>可使用窗口宽度</td></tr>
+</tbody>
+</table>
+
+### 返回示例
+
+```json
+{
+  "pixelRatio": 3,
+  "screenWidth": 393,
+  "screenHeight": 852,
+  "windowWidth": 393,
+  "windowHeight": 852,
+  "statusBarHeight": 59,
+  "safeArea": {
+    "left": 0,
+    "right": 393,
+    "top": 59,
+    "bottom": 818,
+    "width": 393,
+    "height": 759
+  },
+  "screenTop": 0
+}
+```
+
+<a id="getsystemsetting"></a>
+### getSystemSetting()
+
+# getSystemSetting
+
+获取设备设置。
+
+## 扫码预览
+![扫码预览 getSystemSetting](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fbasic%252Fget-system-setting%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>
+
+## 调用方式
+
+### 同步 API
+
+```typescript
+getSystemSetting(params?: object): GetSystemSettingResult
+```
+
+## 入参
+
+无。
+
+## 调用示例
+
+```typescript
+import { getSystemSetting } from '@doubao-dev/framework/api';
+
+const result = getSystemSetting();
+
+console.log(result.bluetoothEnabled, result.locationEnabled);
+console.log(result.wifiEnabled, result.deviceOrientation);
+```
+
+## 返回值
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>bluetoothEnabled</code></td><td><code>boolean</code></td><td>是</td><td>蓝牙的系统开关</td></tr>
+<tr><td><code>deviceOrientation</code></td><td><code>DeviceOrientation</code></td><td>是</td><td>设备方向</td></tr>
+<tr><td><code>locationEnabled</code></td><td><code>boolean</code></td><td>是</td><td>地理位置的系统开关</td></tr>
+<tr><td><code>wifiEnabled</code></td><td><code>boolean</code></td><td>是</td><td>Wi-Fi 的系统开关</td></tr>
+</tbody>
+</table>
+
+### 返回示例
+
+```json
+{
+  "bluetoothEnabled": true,
+  "locationEnabled": true,
+  "wifiEnabled": true,
+  "deviceOrientation": "portrait"
+}
+```
+
+## 错误处理
+
+同步调用失败时抛出错误。错误对象和通用错误码见 [通用错误处理](./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>
+</tbody>
+</table>
+
+## 平台差异
+
+- **Android**：wifiEnabled 表示系统 Wi-Fi 开关是否打开
+- **iOS**：wifiEnabled 表示当前是否正在通过 Wi-Fi 联网
+
+<a id="getappauthorizesetting"></a>
+### getAppAuthorizeSetting()
+
+# getAppAuthorizeSetting
+
+获取豆包客户端的系统授权设置。
+
+调用只读取当前系统授权状态，不会申请权限或触发系统授权弹窗。原有状态字段固定返回
+`authorized`、`denied` 或 `not determined`，精细授权字段用于区分部分、只读、只写、前后台等能力。
+
+## 扫码预览
+![扫码预览 getAppAuthorizeSetting](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fbasic%252Fget-app-authorize-setting%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.40`。
+
+## 支持平台
+
+<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>
+
+## 使用说明
+
+- 本接口查询豆包客户端的系统权限，不等同于查询当前应用插件的 scope 授权。
+- **iOS**：SDK 首次完成通知设置异步预热前，或应用重新激活后的刷新尚未完成时，四个通知字段可能仍为旧值或 not determined。
+- **iOS**：healthDataAuthorizationDetail 使用异步缓存；首次预热或应用重新激活刷新完成前可能返回 UNKNOWN。Apple 不公开精确读取授权，DENIED/GRANTED 为轻量查询推断。
+
+## 调用方式
+
+### 同步 API
+
+```typescript
+getAppAuthorizeSetting(params?: object): GetAppAuthorizeSettingResult
+```
+
+## 入参
+
+无。
+
+## 调用示例
+
+```typescript
+import { getAppAuthorizeSetting } from '@doubao-dev/framework/api';
+
+const result = getAppAuthorizeSetting();
+const detail = result.phoneCalendarAuthorizationDetail;
+const canWriteCalendar =
+  detail === 'full' ||
+  detail === 'write only' ||
+  (detail == null && result.phoneCalendarAuthorized === 'authorized');
+console.log(canWriteCalendar);
+console.log(result.healthDataAuthorizationDetail?.readStatus);
+```
+
+## 返回值
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>albumAuthorizationDetail</code></td><td><code>AlbumAuthorizationDetail | null</code></td><td>否</td><td>相册精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 `null`。<br><br>继承 BasicAuthorizationDetail 的全部取值，并增加：<br>- `limited`：只能访问用户选择的部分照片；支持 iOS 和 Android 14 及以上版本。<br>- `add only`：只能向相册添加照片，不能读取相册内容；仅 iOS 支持。</td></tr>
+<tr><td><code>albumAuthorized</code></td><td><code>AppAuthorizeStatus</code></td><td>是</td><td>相册授权状态；Android 固定返回 not determined</td></tr>
+<tr><td><code>bluetoothAuthorizationDetail</code></td><td><code>BluetoothAuthorizationDetail | null</code></td><td>否</td><td>蓝牙精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 `null`。<br><br>继承 BasicAuthorizationDetail 的全部取值，并增加：<br>- `partial`：只获得部分已声明的蓝牙子权限；仅 Android 支持。</td></tr>
+<tr><td><code>bluetoothAuthorized</code></td><td><code>AppAuthorizeStatus</code></td><td>是</td><td>蓝牙授权状态</td></tr>
+<tr><td><code>cameraAuthorizationDetail</code></td><td><code>BasicAuthorizationDetail | null</code></td><td>否</td><td>摄像头精细授权状态，取值与 BasicAuthorizationDetail 一致；旧客户端或无法可靠映射时不返回该字段或返回 `null`。</td></tr>
+<tr><td><code>cameraAuthorized</code></td><td><code>AppAuthorizeStatus</code></td><td>是</td><td>摄像头授权状态</td></tr>
+<tr><td><code>healthDataAuthorizationDetail</code></td><td><code>HealthDataAuthorizationDetail | null</code></td><td>否</td><td>HealthKit 逐类型读取授权状态；仅 iOS 新版本客户端返回。<br><br>Apple 不提供读取权限的精确查询接口。`status` 为 1 或 2 时采用轻量查询推断，<br>“已授权但没有数据”和“拒绝读取”仍可能无法可靠区分；业务应以实际读取结果为准。</td></tr>
+<tr><td><code>healthDataAuthorizationDetail.readStatus</code></td><td><code>HealthDataAuthorizationItem[]</code></td><td>否</td><td>iOS SDK 支持的全部健康类型及其读取状态。</td></tr>
+<tr><td><code>healthDataAuthorizationDetail.readStatus[].status</code></td><td><code>HealthDataAuthorizationStatus</code></td><td>否</td><td>当前类型的读取权限状态码。</td></tr>
+<tr><td><code>healthDataAuthorizationDetail.readStatus[].type</code></td><td><code>HealthDataType</code></td><td>否</td><td>健康数据类型。</td></tr>
+<tr><td><code>locationAuthorizationDetail</code></td><td><code>LocationAuthorizationDetail | null</code></td><td>否</td><td>定位精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 `null`。<br><br>继承 UnauthorizedDetail 的全部取值；获得权限时返回：<br>- `foreground approximate`：仅应用在前台时可以获取模糊定位。<br>- `foreground precise`：仅应用在前台时可以获取精确定位。<br>- `background approximate`：应用在前台或后台时均可以获取模糊定位。<br>- `background precise`：应用在前台或后台时均可以获取精确定位。</td></tr>
+<tr><td><code>locationAuthorized</code></td><td><code>AppAuthorizeStatus</code></td><td>是</td><td>定位授权状态</td></tr>
+<tr><td><code>locationReducedAccuracy</code></td><td><code>boolean</code></td><td>是</td><td>是否只能使用模糊定位；仅在 iOS 且定位已授权时具有精度含义，Android 固定返回 false</td></tr>
+<tr><td><code>microphoneAuthorizationDetail</code></td><td><code>BasicAuthorizationDetail | null</code></td><td>否</td><td>麦克风精细授权状态，取值与 BasicAuthorizationDetail 一致；旧客户端或无法可靠映射时不返回该字段或返回 `null`。</td></tr>
+<tr><td><code>microphoneAuthorized</code></td><td><code>AppAuthorizeStatus</code></td><td>是</td><td>麦克风授权状态</td></tr>
+<tr><td><code>notificationAlertAuthorized</code></td><td><code>AppAuthorizeStatus</code></td><td>是</td><td>通知提醒授权状态；Android 固定返回 not determined</td></tr>
+<tr><td><code>notificationAuthorizationDetail</code></td><td><code>NotificationAuthorizationDetail | null</code></td><td>否</td><td>通知精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 `null`。<br><br>继承 BasicAuthorizationDetail 的全部取值，并增加：<br>- `provisional`：iOS 临时静默授权；不会弹出授权框，通知只进入通知中心。</td></tr>
+<tr><td><code>notificationAuthorized</code></td><td><code>AppAuthorizeStatus</code></td><td>是</td><td>通知总授权状态</td></tr>
+<tr><td><code>notificationBadgeAuthorized</code></td><td><code>AppAuthorizeStatus</code></td><td>是</td><td>通知角标授权状态；Android 固定返回 not determined</td></tr>
+<tr><td><code>notificationSoundAuthorized</code></td><td><code>AppAuthorizeStatus</code></td><td>是</td><td>通知声音授权状态；Android 固定返回 not determined</td></tr>
+<tr><td><code>phoneCalendarAuthorizationDetail</code></td><td><code>PhoneCalendarAuthorizationDetail | null</code></td><td>否</td><td>系统日历精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 `null`。<br><br>继承 BasicAuthorizationDetail 的全部取值，并增加：<br>- `read only`：只能读取日历，不能新增、修改或删除日程；仅 Android 支持。<br>- `write only`：只能新增日程，不能读取现有日历数据。</td></tr>
+<tr><td><code>phoneCalendarAuthorized</code></td><td><code>AppAuthorizeStatus</code></td><td>是</td><td>系统日历授权状态</td></tr>
+</tbody>
+</table>
+
+### 返回示例
+
+```json
+{
+  "albumAuthorized": "authorized",
+  "bluetoothAuthorized": "denied",
+  "cameraAuthorized": "authorized",
+  "locationAuthorized": "authorized",
+  "locationReducedAccuracy": false,
+  "microphoneAuthorized": "authorized",
+  "notificationAuthorized": "authorized",
+  "notificationAlertAuthorized": "authorized",
+  "notificationBadgeAuthorized": "denied",
+  "notificationSoundAuthorized": "authorized",
+  "phoneCalendarAuthorized": "denied",
+  "albumAuthorizationDetail": "limited",
+  "bluetoothAuthorizationDetail": "full",
+  "cameraAuthorizationDetail": "full",
+  "locationAuthorizationDetail": "foreground precise",
+  "microphoneAuthorizationDetail": "full",
+  "notificationAuthorizationDetail": "provisional",
+  "phoneCalendarAuthorizationDetail": "write only",
+  "healthDataAuthorizationDetail": {
+    "readStatus": [
+      { "type": "heart_rate", "status": 2 },
+      { "type": "step_count", "status": 0 }
+    ]
+  }
+}
+```
+
+## 平台差异
+
+- **Android**：albumAuthorized 和通知分项固定返回 not determined，locationReducedAccuracy 固定返回 false 且不表示实际定位精度
+- **Android**：bluetoothAuthorized、cameraAuthorized、locationAuthorized、microphoneAuthorized、notificationAuthorized 和 phoneCalendarAuthorized 不区分尚未申请和已经拒绝，两种情况均返回 denied
+- **Android**：locationAuthorized 在粗略或精确定位任一权限已授权时返回 authorized；phoneCalendarAuthorized 仅在读、写日历权限均授权时返回 authorized
+- **Android**：精细字段区分 Android 14 部分相册、日历读写、定位前后台和精度，以及蓝牙部分子权限
+- **iOS**：相册 limited 映射为 authorized，通知 provisional 和 ephemeral 映射为 authorized
+- **iOS**：精细字段区分相册 limited/add only、日历 write only、定位前后台和精度，以及通知 provisional；ephemeral 暂不映射
+- **iOS**：healthDataAuthorizationDetail 返回 SDK 支持的全部健康类型，调用方可按自己申请读取权限时使用的 types 过滤；它不等同于 Apple 提供的精确读取授权结果
+
+<a id="getappbaseinfosync"></a>
+### getAppBaseInfoSync()
+
+# getAppBaseInfoSync
+
+获取应用基础信息。
+
+## 扫码预览
+![扫码预览 getAppBaseInfoSync](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fbasic%252Fget-app-base-info%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.18`。
+
+## 支持平台
+
+<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>
+
+## 使用说明
+
+- 当前不返回 `enableDebug`；如需获取调试状态，请使用 getSystemInfo 或 getSystemInfoSync。
+
+## 调用方式
+
+### 同步 API
+
+```typescript
+getAppBaseInfoSync(_params?: object): GetAppBaseInfoResult
+```
+
+## 入参
+
+无。
+
+## 调用示例
+
+```typescript
+import { getAppBaseInfoSync } from '@doubao-dev/framework/api';
+
+const result = getAppBaseInfoSync();
+
+console.log(result.language, result.SDKVersion, result.theme);
+console.log(result.host?.appId);
+```
+
+## 返回值
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>enableDebug</code></td><td><code>boolean</code></td><td>否</td><td>是否已打开调试</td></tr>
+<tr><td><code>host</code></td><td><code>AppBaseInfoHost</code></td><td>否</td><td>当前豆包客户端信息</td></tr>
+<tr><td><code>host.appId</code></td><td><code>string</code></td><td>否</td><td>当前豆包客户端的 appId</td></tr>
+<tr><td><code>language</code></td><td><code>string</code></td><td>是</td><td>当前语言</td></tr>
+<tr><td><code>SDKVersion</code></td><td><code>string</code></td><td>否</td><td>客户端基础库版本</td></tr>
+<tr><td><code>theme</code></td><td><code>&quot;light&quot; | &quot;dark&quot;</code></td><td>否</td><td>当前主题</td></tr>
+<tr><td><code>version</code></td><td><code>string</code></td><td>否</td><td>豆包客户端版本号</td></tr>
+</tbody>
+</table>
+
+### 返回示例
+
+```json
+{
+  "SDKVersion": "0.0.36",
+  "host": {
+    "appId": "doubao"
+  },
+  "language": "zh_CN",
+  "version": "8.0.0",
+  "theme": "light"
+}
+```
+
+<a id="getwindowinfo"></a>
+### getWindowInfo()
+
+# getWindowInfo
+
+获取窗口信息。
+
+## 扫码预览
+![扫码预览 getWindowInfo](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fbasic%252Fget-window-info%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.18`。
+
+## 支持平台
+
+<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>
+
+## 使用说明
+
+- 该接口封装 getWindowInfoSync 的结果；无需 Promise 形式时可直接使用 getWindowInfoSync。
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+getWindowInfo(_params?: object): Promise<GetWindowInfoResult>
+```
+
+## 入参
+
+无。
+
+## 调用示例
+
+```typescript
+import { getWindowInfo } from '@doubao-dev/framework/api';
+
+const result = await getWindowInfo();
+
+console.log(result.windowWidth, result.windowHeight);
+console.log(result.safeArea?.top, result.screenTop);
+```
+
+## 成功返回
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>pixelRatio</code></td><td><code>number</code></td><td>是</td><td>设备像素比</td></tr>
+<tr><td><code>safeArea</code></td><td><code>WindowSafeArea</code></td><td>否</td><td>安全区域</td></tr>
+<tr><td><code>safeArea.bottom</code></td><td><code>number</code></td><td>否</td><td>安全区域右下角纵坐标</td></tr>
+<tr><td><code>safeArea.height</code></td><td><code>number</code></td><td>否</td><td>安全区域高度</td></tr>
+<tr><td><code>safeArea.left</code></td><td><code>number</code></td><td>否</td><td>安全区域左上角横坐标</td></tr>
+<tr><td><code>safeArea.right</code></td><td><code>number</code></td><td>否</td><td>安全区域右下角横坐标</td></tr>
+<tr><td><code>safeArea.top</code></td><td><code>number</code></td><td>否</td><td>安全区域左上角纵坐标</td></tr>
+<tr><td><code>safeArea.width</code></td><td><code>number</code></td><td>否</td><td>安全区域宽度</td></tr>
+<tr><td><code>screenHeight</code></td><td><code>number</code></td><td>是</td><td>屏幕高度</td></tr>
+<tr><td><code>screenTop</code></td><td><code>number</code></td><td>是</td><td>窗口上边缘的 y 值</td></tr>
+<tr><td><code>screenWidth</code></td><td><code>number</code></td><td>是</td><td>屏幕宽度</td></tr>
+<tr><td><code>statusBarHeight</code></td><td><code>number</code></td><td>是</td><td>状态栏高度</td></tr>
+<tr><td><code>windowHeight</code></td><td><code>number</code></td><td>是</td><td>可使用窗口高度</td></tr>
+<tr><td><code>windowWidth</code></td><td><code>number</code></td><td>是</td><td>可使用窗口宽度</td></tr>
+</tbody>
+</table>
+
+### 返回示例
+
+```json
+{
+  "pixelRatio": 3,
+  "screenWidth": 393,
+  "screenHeight": 852,
+  "windowWidth": 393,
+  "windowHeight": 852,
+  "statusBarHeight": 59,
+  "safeArea": {
+    "left": 0,
+    "right": 393,
+    "top": 59,
+    "bottom": 818,
+    "width": 393,
+    "height": 759
+  },
+  "screenTop": 0
+}
+```
+
+<a id="getappbaseinfo"></a>
+### getAppBaseInfo()
+
+# getAppBaseInfo
+
+获取应用基础信息。
+
+## 扫码预览
+![扫码预览 getAppBaseInfo](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fbasic%252Fget-app-base-info%252Findex)
+
+## 使用限制
+
+> [!WARNING]
+> **iOS**：iOS 仅提供接口声明未注册实现，调用直接返回不支持；iOS 上的异步调用无法获得成功结果。
+
+## 支持版本
+
+前端库版本不低于 `0.0.18`。
+
+## 支持平台
+
+<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>
+
+## 使用说明
+
+- iOS 当前不支持异步调用，跨平台场景请改用 getAppBaseInfoSync。
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+getAppBaseInfo(params?: object): Promise<GetAppBaseInfoResult>
+```
+
+## 入参
+
+无。
+
+## 调用示例
+
+```typescript
+import { getAppBaseInfo } from '@doubao-dev/framework/api';
+
+const result = await getAppBaseInfo();
+
+console.log(result.language, result.SDKVersion, result.theme);
+console.log(result.host?.appId, result.enableDebug);
+```
+
+## 成功返回
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>enableDebug</code></td><td><code>boolean</code></td><td>否</td><td>是否已打开调试</td></tr>
+<tr><td><code>host</code></td><td><code>AppBaseInfoHost</code></td><td>否</td><td>当前豆包客户端信息</td></tr>
+<tr><td><code>host.appId</code></td><td><code>string</code></td><td>否</td><td>当前豆包客户端的 appId</td></tr>
+<tr><td><code>language</code></td><td><code>string</code></td><td>是</td><td>当前语言</td></tr>
+<tr><td><code>SDKVersion</code></td><td><code>string</code></td><td>否</td><td>客户端基础库版本</td></tr>
+<tr><td><code>theme</code></td><td><code>&quot;light&quot; | &quot;dark&quot;</code></td><td>否</td><td>当前主题</td></tr>
+<tr><td><code>version</code></td><td><code>string</code></td><td>否</td><td>豆包客户端版本号</td></tr>
+</tbody>
+</table>
+
+### 返回示例
+
+```json
+{
+  "SDKVersion": "0.0.36",
+  "host": {
+    "appId": "doubao"
+  },
+  "language": "zh_CN",
+  "version": "8.0.0",
+  "theme": "light"
+}
+```
+
+<a id="onthemechange"></a>
+### onThemeChange()
+
+# onThemeChange
+
+监听应用主题变化。
+
+当用户在系统设置或豆包客户端内切换浅色、深色主题时触发。回调参数中的 `theme` 表示切换后的主题，可与
+getAppBaseInfo 返回的 `theme` 字段配合使用。
+
+## 扫码预览
+![扫码预览 onThemeChange](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fbasic%252Fon-theme-change%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.32`。
+
+## 支持平台
+
+<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>
+
+## 使用说明
+
+- 调用返回的取消函数即可移除该监听；可与 getAppBaseInfo 返回的 theme 字段配合使用。
+
+## 调用方式
+
+### 事件监听 API
+
+```typescript
+onThemeChange(callback: ThemeChangeListener): () => void
+```
+
+## 入参
+
+无。
+
+## 调用示例
+
+```typescript
+import { onThemeChange } from '@doubao-dev/framework/api';
+
+const offThemeChange = onThemeChange(({ theme }) => {
+  console.log('当前主题:', theme);
+});
+
+offThemeChange();
+```
+
+## 回调参数
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>event.theme</code></td><td><code>AppTheme</code></td><td>是</td><td>切换后的应用主题</td></tr>
+</tbody>
+</table>
+
+## 返回值
+
+返回取消当前监听函数的函数。
+
+### 回调示例
+
+```json
+{
+  "theme": "dark"
+}
+```
+
+## 平台差异
+
+- **Android**：部分豆包 Android 版本可能不会触发主题变化事件
+
+<a id="getsysteminfo"></a>
+### getSystemInfo()
+
+# getSystemInfo
+
+获取系统信息。
+
+## 扫码预览
+![扫码预览 getSystemInfo](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fbasic%252Fget-system-info%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.34`。
+
+## 支持平台
+
+<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>
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+getSystemInfo(params?: object): Promise<GetSystemInfoResult>
+```
+
+## 入参
+
+无。
+
+## 调用示例
+
+```typescript
+import { getSystemInfo } from '@doubao-dev/framework/api';
+
+const result = await getSystemInfo();
+
+console.log(result.brand, result.model, result.system);
+console.log(result.screenWidth, result.screenHeight);
+```
+
+## 成功返回
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>abi</code></td><td><code>string</code></td><td>否</td><td>豆包客户端二进制接口类型（如 arm64-v8a），仅 Android 返回</td></tr>
+<tr><td><code>benchmarkLevel</code></td><td><code>number</code></td><td>否</td><td>设备性能等级，-1 表示未知</td></tr>
+<tr><td><code>brand</code></td><td><code>string</code></td><td>是</td><td>设备品牌</td></tr>
+<tr><td><code>deviceOrientation</code></td><td><code>&quot;portrait&quot; | &quot;landscape&quot;</code></td><td>否</td><td>设备方向</td></tr>
+<tr><td><code>enableDebug</code></td><td><code>boolean</code></td><td>否</td><td>是否已打开调试</td></tr>
+<tr><td><code>language</code></td><td><code>string</code></td><td>是</td><td>系统语言，格式为 language_region，如 zh_CN、en_US</td></tr>
+<tr><td><code>model</code></td><td><code>string</code></td><td>是</td><td>设备型号</td></tr>
+<tr><td><code>pixelRatio</code></td><td><code>number</code></td><td>是</td><td>设备像素比，物理像素 = 逻辑像素 × pixelRatio</td></tr>
+<tr><td><code>platform</code></td><td><code>string</code></td><td>是</td><td>客户端平台，取值为 &quot;ios&quot; 或 &quot;android&quot;</td></tr>
+<tr><td><code>safeArea</code></td><td><code>SystemInfoSafeArea</code></td><td>否</td><td>在竖屏正方向下的安全区域，单位为逻辑像素</td></tr>
+<tr><td><code>safeArea.bottom</code></td><td><code>number</code></td><td>否</td><td>安全区域右下角纵坐标</td></tr>
+<tr><td><code>safeArea.height</code></td><td><code>number</code></td><td>否</td><td>安全区域高度</td></tr>
+<tr><td><code>safeArea.left</code></td><td><code>number</code></td><td>否</td><td>安全区域左上角横坐标</td></tr>
+<tr><td><code>safeArea.right</code></td><td><code>number</code></td><td>否</td><td>安全区域右下角横坐标</td></tr>
+<tr><td><code>safeArea.top</code></td><td><code>number</code></td><td>否</td><td>安全区域左上角纵坐标</td></tr>
+<tr><td><code>safeArea.width</code></td><td><code>number</code></td><td>否</td><td>安全区域宽度</td></tr>
+<tr><td><code>screenHeight</code></td><td><code>number</code></td><td>是</td><td>屏幕高度，单位为逻辑像素</td></tr>
+<tr><td><code>screenWidth</code></td><td><code>number</code></td><td>是</td><td>屏幕宽度，单位为逻辑像素</td></tr>
+<tr><td><code>SDKVersion</code></td><td><code>string</code></td><td>否</td><td>客户端基础库版本</td></tr>
+<tr><td><code>statusBarHeight</code></td><td><code>number</code></td><td>是</td><td>状态栏高度，单位为逻辑像素</td></tr>
+<tr><td><code>system</code></td><td><code>string</code></td><td>是</td><td>操作系统及版本，如 &quot;Android 14&quot;、&quot;iOS 17.5&quot;</td></tr>
+<tr><td><code>theme</code></td><td><code>&quot;light&quot; | &quot;dark&quot;</code></td><td>否</td><td>系统当前主题</td></tr>
+<tr><td><code>version</code></td><td><code>string</code></td><td>否</td><td>豆包客户端版本号</td></tr>
+<tr><td><code>windowHeight</code></td><td><code>number</code></td><td>是</td><td>可使用窗口高度，单位为逻辑像素</td></tr>
+<tr><td><code>windowWidth</code></td><td><code>number</code></td><td>是</td><td>可使用窗口宽度，单位为逻辑像素</td></tr>
+</tbody>
+</table>
+
+### 返回示例
+
+```json
+{
+  "brand": "Xiaomi",
+  "model": "23127PN0CC",
+  "pixelRatio": 3,
+  "screenWidth": 393,
+  "screenHeight": 852,
+  "windowWidth": 393,
+  "windowHeight": 852,
+  "statusBarHeight": 59,
+  "language": "zh_CN",
+  "version": "8.0.0",
+  "system": "Android 14",
+  "platform": "android",
+  "SDKVersion": "0.0.36",
+  "theme": "light",
+  "benchmarkLevel": 30,
+  "safeArea": {
+    "left": 0,
+    "right": 393,
+    "top": 59,
+    "bottom": 818,
+    "width": 393,
+    "height": 759
+  },
+  "enableDebug": false,
+  "deviceOrientation": "portrait",
+  "abi": "arm64-v8a"
+}
+```
+
+## 错误处理
+
+错误对象和通用错误码见 [通用错误处理](./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>
+</tbody>
+</table>
+
+## 平台差异
+
+- **Android**：abi 返回豆包客户端二进制接口类型（如 arm64-v8a），iOS 不返回该字段
+
+<a id="getsysteminfosync"></a>
+### getSystemInfoSync()
+
+# getSystemInfoSync
+
+同步获取系统信息。
+
+## 支持版本
+
+前端库版本不低于 `0.0.34`。
+
+## 支持平台
+
+<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>
+
+## 调用方式
+
+### 同步 API
+
+```typescript
+getSystemInfoSync(_params?: object): GetSystemInfoResult
+```
+
+## 入参
+
+无。
+
+## 调用示例
+
+```typescript
+import { getSystemInfoSync } from '@doubao-dev/framework/api';
+
+const result = getSystemInfoSync();
+
+console.log(result.brand, result.model, result.system);
+console.log(result.screenWidth, result.screenHeight);
+```
+
+## 返回值
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>abi</code></td><td><code>string</code></td><td>否</td><td>豆包客户端二进制接口类型（如 arm64-v8a），仅 Android 返回</td></tr>
+<tr><td><code>benchmarkLevel</code></td><td><code>number</code></td><td>否</td><td>设备性能等级，-1 表示未知</td></tr>
+<tr><td><code>brand</code></td><td><code>string</code></td><td>是</td><td>设备品牌</td></tr>
+<tr><td><code>deviceOrientation</code></td><td><code>&quot;portrait&quot; | &quot;landscape&quot;</code></td><td>否</td><td>设备方向</td></tr>
+<tr><td><code>enableDebug</code></td><td><code>boolean</code></td><td>否</td><td>是否已打开调试</td></tr>
+<tr><td><code>language</code></td><td><code>string</code></td><td>是</td><td>系统语言，格式为 language_region，如 zh_CN、en_US</td></tr>
+<tr><td><code>model</code></td><td><code>string</code></td><td>是</td><td>设备型号</td></tr>
+<tr><td><code>pixelRatio</code></td><td><code>number</code></td><td>是</td><td>设备像素比，物理像素 = 逻辑像素 × pixelRatio</td></tr>
+<tr><td><code>platform</code></td><td><code>string</code></td><td>是</td><td>客户端平台，取值为 &quot;ios&quot; 或 &quot;android&quot;</td></tr>
+<tr><td><code>safeArea</code></td><td><code>SystemInfoSafeArea</code></td><td>否</td><td>在竖屏正方向下的安全区域，单位为逻辑像素</td></tr>
+<tr><td><code>safeArea.bottom</code></td><td><code>number</code></td><td>否</td><td>安全区域右下角纵坐标</td></tr>
+<tr><td><code>safeArea.height</code></td><td><code>number</code></td><td>否</td><td>安全区域高度</td></tr>
+<tr><td><code>safeArea.left</code></td><td><code>number</code></td><td>否</td><td>安全区域左上角横坐标</td></tr>
+<tr><td><code>safeArea.right</code></td><td><code>number</code></td><td>否</td><td>安全区域右下角横坐标</td></tr>
+<tr><td><code>safeArea.top</code></td><td><code>number</code></td><td>否</td><td>安全区域左上角纵坐标</td></tr>
+<tr><td><code>safeArea.width</code></td><td><code>number</code></td><td>否</td><td>安全区域宽度</td></tr>
+<tr><td><code>screenHeight</code></td><td><code>number</code></td><td>是</td><td>屏幕高度，单位为逻辑像素</td></tr>
+<tr><td><code>screenWidth</code></td><td><code>number</code></td><td>是</td><td>屏幕宽度，单位为逻辑像素</td></tr>
+<tr><td><code>SDKVersion</code></td><td><code>string</code></td><td>否</td><td>客户端基础库版本</td></tr>
+<tr><td><code>statusBarHeight</code></td><td><code>number</code></td><td>是</td><td>状态栏高度，单位为逻辑像素</td></tr>
+<tr><td><code>system</code></td><td><code>string</code></td><td>是</td><td>操作系统及版本，如 &quot;Android 14&quot;、&quot;iOS 17.5&quot;</td></tr>
+<tr><td><code>theme</code></td><td><code>&quot;light&quot; | &quot;dark&quot;</code></td><td>否</td><td>系统当前主题</td></tr>
+<tr><td><code>version</code></td><td><code>string</code></td><td>否</td><td>豆包客户端版本号</td></tr>
+<tr><td><code>windowHeight</code></td><td><code>number</code></td><td>是</td><td>可使用窗口高度，单位为逻辑像素</td></tr>
+<tr><td><code>windowWidth</code></td><td><code>number</code></td><td>是</td><td>可使用窗口宽度，单位为逻辑像素</td></tr>
+</tbody>
+</table>
+
+### 返回示例
+
+```json
+{
+  "brand": "Xiaomi",
+  "model": "23127PN0CC",
+  "pixelRatio": 3,
+  "screenWidth": 393,
+  "screenHeight": 852,
+  "windowWidth": 393,
+  "windowHeight": 852,
+  "statusBarHeight": 59,
+  "language": "zh_CN",
+  "version": "8.0.0",
+  "system": "Android 14",
+  "platform": "android",
+  "SDKVersion": "0.0.36",
+  "theme": "light",
+  "benchmarkLevel": 30,
+  "safeArea": {
+    "left": 0,
+    "right": 393,
+    "top": 59,
+    "bottom": 818,
+    "width": 393,
+    "height": 759
+  },
+  "enableDebug": false,
+  "deviceOrientation": "portrait",
+  "abi": "arm64-v8a"
+}
+```
+
+## 错误处理
+
+同步调用失败时抛出错误。错误对象和通用错误码见 [通用错误处理](./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>
+</tbody>
+</table>
+
+## 平台差异
+
+- **Android**：abi 返回豆包客户端二进制接口类型（如 arm64-v8a），iOS 不返回该字段
+
+## 相关类型
+
+<a id="windowsafearea"></a>
+### WindowSafeArea
+
+#### Properties
+
+• **left**: `number` - 安全区域左上角横坐标
+• **right**: `number` - 安全区域右下角横坐标
+• **top**: `number` - 安全区域左上角纵坐标
+• **bottom**: `number` - 安全区域右下角纵坐标
+• **width**: `number` - 安全区域宽度
+• **height**: `number` - 安全区域高度
+
+<a id="getwindowinforesult"></a>
+### GetWindowInfoResult
+
+#### Properties
+
+• **pixelRatio**: `number` - 设备像素比
+• **screenWidth**: `number` - 屏幕宽度
+• **screenHeight**: `number` - 屏幕高度
+• **windowWidth**: `number` - 可使用窗口宽度
+• **windowHeight**: `number` - 可使用窗口高度
+• **statusBarHeight**: `number` - 状态栏高度
+• **safeArea?**: `WindowSafeArea` - 安全区域
+• **screenTop**: `number` - 窗口上边缘的 y 值
+
+<a id="deviceorientation"></a>
+### DeviceOrientation
+
+#### Type
+
+`'portrait' | 'landscape'`
+
+<a id="getsystemsettingresult"></a>
+### GetSystemSettingResult
+
+#### Properties
+
+• **bluetoothEnabled**: `boolean` - 蓝牙的系统开关
+• **locationEnabled**: `boolean` - 地理位置的系统开关
+• **wifiEnabled**: `boolean` - Wi-Fi 的系统开关
+• **deviceOrientation**: `DeviceOrientation` - 设备方向
+
+<a id="healthdatatype"></a>
+### HealthDataType
+
+#### Type
+
+`BridgeHealthDataType`
+
+<a id="appauthorizestatus"></a>
+### AppAuthorizeStatus
+
+#### Type
+
+`'authorized' | 'denied' | 'not determined'`
+
+<a id="unauthorizeddetail"></a>
+### UnauthorizedDetail
+
+尚未获得权限时的精细状态。 取值说明： - not determined：系统明确表示用户尚未作出选择 - denied：当前没有权限；可能是用户拒绝、关闭权限，或平台无法进一步区分拒绝原因 - restricted：系统明确表示权限受设备管理、家长控制等策略限制，用户无法直接修改。
+
+#### Type
+
+`'not determined' | 'denied' | 'restricted'`
+
+<a id="basicauthorizationdetail"></a>
+### BasicAuthorizationDetail
+
+只有完整授权和未授权状态的权限所使用的通用精细状态。 继承 UnauthorizedDetail 的全部取值，并增加： - full：已获得该权限的完整访问能力。
+
+#### Type
+
+`UnauthorizedDetail | 'full'`
+
+<a id="albumauthorizationdetail"></a>
+### AlbumAuthorizationDetail
+
+相册精细授权状态。 继承 BasicAuthorizationDetail 的全部取值，并增加： - limited：只能访问用户选择的部分照片；支持 iOS 和 Android 14 及以上版本。 - add only：只能向相册添加照片，不能读取相册内容；仅 iOS 支持。
+
+#### Type
+
+`BasicAuthorizationDetail | 'limited' | 'add only'`
+
+<a id="phonecalendarauthorizationdetail"></a>
+### PhoneCalendarAuthorizationDetail
+
+系统日历精细授权状态。 继承 BasicAuthorizationDetail 的全部取值，并增加： - read only：只能读取日历，不能新增、修改或删除日程；仅 Android 支持。 - write only：只能新增日程，不能读取现有日历数据。
+
+#### Type
+
+`BasicAuthorizationDetail | 'read only' | 'write only'`
+
+<a id="locationauthorizationdetail"></a>
+### LocationAuthorizationDetail
+
+定位精细授权状态。 继承 UnauthorizedDetail 的全部取值；获得权限时返回： - foreground approximate：仅应用在前台时可以获取模糊定位。 - foreground precise：仅应用在前台时可以获取精确定位。 - background approximate：应用在前台或后台时均可以获取模糊定位。 - background precise：应用在前台或后台时均可以获取精确定位。
+
+#### Type
+
+`| UnauthorizedDetail
+  | 'foreground approximate'
+  | 'foreground precise'
+  | 'background approximate'
+  | 'background precise'`
+
+<a id="bluetoothauthorizationdetail"></a>
+### BluetoothAuthorizationDetail
+
+蓝牙精细授权状态。 继承 BasicAuthorizationDetail 的全部取值，并增加： - partial：只获得部分已声明的蓝牙子权限；仅 Android 支持。
+
+#### Type
+
+`BasicAuthorizationDetail | 'partial'`
+
+<a id="notificationauthorizationdetail"></a>
+### NotificationAuthorizationDetail
+
+通知精细授权状态。 继承 BasicAuthorizationDetail 的全部取值，并增加： - provisional：iOS 临时静默授权；不会弹出授权框，通知只进入通知中心。
+
+#### Type
+
+`BasicAuthorizationDetail | 'provisional'`
+
+<a id="healthdataauthorizationstatus"></a>
+### HealthDataAuthorizationStatus
+
+HealthKit 读取权限状态码。 - -1：未知或当前系统不支持该类型 - 0：系统仍需要展示授权请求 - 1：轻量查询推断为已拒绝 - 2：轻量查询未发现授权错误。
+
+#### Type
+
+`-1 | 0 | 1 | 2`
+
+<a id="healthdataauthorizationitem"></a>
+### HealthDataAuthorizationItem
+
+#### Properties
+
+• **type**: `HealthDataType` - 健康数据类型
+• **status**: `HealthDataAuthorizationStatus` - 当前类型的读取权限状态码
+
+<a id="healthdataauthorizationdetail"></a>
+### HealthDataAuthorizationDetail
+
+#### Properties
+
+• **readStatus**: `HealthDataAuthorizationItem[]` - iOS SDK 支持的全部健康类型及其读取状态
+
+<a id="getappauthorizesettingresult"></a>
+### GetAppAuthorizeSettingResult
+
+#### Properties
+
+• **albumAuthorized**: `AppAuthorizeStatus` - 相册授权状态；Android 固定返回 not determined
+• **bluetoothAuthorized**: `AppAuthorizeStatus` - 蓝牙授权状态
+• **cameraAuthorized**: `AppAuthorizeStatus` - 摄像头授权状态
+• **locationAuthorized**: `AppAuthorizeStatus` - 定位授权状态
+• **locationReducedAccuracy**: `boolean` - 是否只能使用模糊定位；仅在 iOS 且定位已授权时具有精度含义，Android 固定返回 false
+• **microphoneAuthorized**: `AppAuthorizeStatus` - 麦克风授权状态
+• **notificationAuthorized**: `AppAuthorizeStatus` - 通知总授权状态
+• **notificationAlertAuthorized**: `AppAuthorizeStatus` - 通知提醒授权状态；Android 固定返回 not determined
+• **notificationBadgeAuthorized**: `AppAuthorizeStatus` - 通知角标授权状态；Android 固定返回 not determined
+• **notificationSoundAuthorized**: `AppAuthorizeStatus` - 通知声音授权状态；Android 固定返回 not determined
+• **phoneCalendarAuthorized**: `AppAuthorizeStatus` - 系统日历授权状态
+• **albumAuthorizationDetail?**: `AlbumAuthorizationDetail | null` - 相册精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 null。 继承 BasicAuthorizationDetail 的全部取值，并增加： - limited：只能访问用户选择的部分照片；支持 iOS 和 Android 14 及以上版本。 - add only：只能向相册添加照片，不能读取相册内容；仅 iOS 支持
+• **bluetoothAuthorizationDetail?**: `BluetoothAuthorizationDetail | null` - 蓝牙精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 null。 继承 BasicAuthorizationDetail 的全部取值，并增加： - partial：只获得部分已声明的蓝牙子权限；仅 Android 支持
+• **cameraAuthorizationDetail?**: `CameraAuthorizationDetail | null` - 摄像头精细授权状态，取值与 BasicAuthorizationDetail 一致；旧客户端或无法可靠映射时不返回该字段或返回 null
+• **locationAuthorizationDetail?**: `LocationAuthorizationDetail | null` - 定位精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 null。 继承 UnauthorizedDetail 的全部取值；获得权限时返回： - foreground approximate：仅应用在前台时可以获取模糊定位。 - foreground precise：仅应用在前台时可以获取精确定位。 - background approximate：应用在前台或后台时均可以获取模糊定位。 - background precise：应用在前台或后台时均可以获取精确定位
+• **microphoneAuthorizationDetail?**: `MicrophoneAuthorizationDetail | null` - 麦克风精细授权状态，取值与 BasicAuthorizationDetail 一致；旧客户端或无法可靠映射时不返回该字段或返回 null
+• **notificationAuthorizationDetail?**: `NotificationAuthorizationDetail | null` - 通知精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 null。 继承 BasicAuthorizationDetail 的全部取值，并增加： - provisional：iOS 临时静默授权；不会弹出授权框，通知只进入通知中心
+• **phoneCalendarAuthorizationDetail?**: `PhoneCalendarAuthorizationDetail | null` - 系统日历精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 null。 继承 BasicAuthorizationDetail 的全部取值，并增加： - read only：只能读取日历，不能新增、修改或删除日程；仅 Android 支持。 - write only：只能新增日程，不能读取现有日历数据
+• **healthDataAuthorizationDetail?**: `HealthDataAuthorizationDetail | null` - HealthKit 逐类型读取授权状态；仅 iOS 新版本客户端返回。 Apple 不提供读取权限的精确查询接口。status 为 1 或 2 时采用轻量查询推断， “已授权但没有数据”和“拒绝读取”仍可能无法可靠区分；业务应以实际读取结果为准
+
+<a id="cameraauthorizationdetail"></a>
+### CameraAuthorizationDetail
+
+摄像头精细授权状态，取值与 BasicAuthorizationDetail 一致。
+
+#### Type
+
+`BasicAuthorizationDetail`
+
+<a id="microphoneauthorizationdetail"></a>
+### MicrophoneAuthorizationDetail
+
+麦克风精细授权状态，取值与 BasicAuthorizationDetail 一致。
+
+#### Type
+
+`BasicAuthorizationDetail`
+
+<a id="appbaseinfohost"></a>
+### AppBaseInfoHost
+
+#### Properties
+
+• **appId**: `string` - 当前豆包客户端的 appId
+
+<a id="getappbaseinforesult"></a>
+### GetAppBaseInfoResult
+
+#### Properties
+
+• **SDKVersion?**: `string` - 客户端基础库版本
+• **enableDebug?**: `boolean` - 是否已打开调试
+• **host?**: `AppBaseInfoHost` - 当前豆包客户端信息
+• **language**: `string` - 当前语言
+• **version?**: `string` - 豆包客户端版本号
+• **theme?**: `'light' | 'dark'` - 当前主题
+
+<a id="apptheme"></a>
+### AppTheme
+
+应用主题。
+
+#### Type
+
+`'light' | 'dark'`
+
+<a id="themechangelistener"></a>
+### ThemeChangeListener
+
+应用主题变化事件监听函数。
+
+#### Type
+
+`(event: ThemeChangeEvent) => void`
+
+<a id="themechangeevent"></a>
+### ThemeChangeEvent
+
+#### Properties
+
+• **theme**: `AppTheme` - 切换后的应用主题
+
+<a id="systeminfosafearea"></a>
+### SystemInfoSafeArea
+
+#### Properties
+
+• **left**: `number` - 安全区域左上角横坐标
+• **right**: `number` - 安全区域右下角横坐标
+• **top**: `number` - 安全区域左上角纵坐标
+• **bottom**: `number` - 安全区域右下角纵坐标
+• **width**: `number` - 安全区域宽度
+• **height**: `number` - 安全区域高度
+
+<a id="getsysteminforesult"></a>
+### GetSystemInfoResult
+
+#### Properties
+
+• **brand**: `string` - 设备品牌
+• **model**: `string` - 设备型号
+• **pixelRatio**: `number` - 设备像素比，物理像素 = 逻辑像素 × pixelRatio
+• **screenWidth**: `number` - 屏幕宽度，单位为逻辑像素
+• **screenHeight**: `number` - 屏幕高度，单位为逻辑像素
+• **windowWidth**: `number` - 可使用窗口宽度，单位为逻辑像素
+• **windowHeight**: `number` - 可使用窗口高度，单位为逻辑像素
+• **statusBarHeight**: `number` - 状态栏高度，单位为逻辑像素
+• **language**: `string` - 系统语言，格式为 language_region，如 zh_CN、en_US
+• **version?**: `string` - 豆包客户端版本号
+• **system**: `string` - 操作系统及版本，如 "Android 14"、"iOS 17.5"
+• **platform**: `string` - 客户端平台，取值为 "ios" 或 "android"
+• **SDKVersion?**: `string` - 客户端基础库版本
+• **theme?**: `'light' | 'dark'` - 系统当前主题
+• **benchmarkLevel?**: `number` - 设备性能等级，-1 表示未知
+• **safeArea?**: `SystemInfoSafeArea` - 在竖屏正方向下的安全区域，单位为逻辑像素
+• **enableDebug?**: `boolean` - 是否已打开调试
+• **deviceOrientation?**: `'portrait' | 'landscape'` - 设备方向
+• **abi?**: `string` - 豆包客户端二进制接口类型（如 arm64-v8a），仅 Android 返回