From b6e58be9c1235d06f5c12b782d9fe54c75ceeb9e Mon Sep 17 00:00:00 2001 From: DCloud_LXH <283700113@qq.com> Date: Mon, 18 Jul 2022 17:54:17 +0800 Subject: [PATCH] =?UTF-8?q?chore:=20getAppAuthorizeSetting=E3=80=81getSyst?= =?UTF-8?q?emSetting?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/api/system/getappauthorizesetting.md | 9 +++++++-- docs/api/system/getsystemsetting.md | 8 ++++---- 2 files changed, 11 insertions(+), 6 deletions(-) diff --git a/docs/api/system/getappauthorizesetting.md b/docs/api/system/getappauthorizesetting.md index 33bbd4d57..843d26226 100644 --- a/docs/api/system/getappauthorizesetting.md +++ b/docs/api/system/getappauthorizesetting.md @@ -11,7 +11,7 @@ |属性|类型|说明|平台差异说明| |:-|:-|:-|:-| -|albumAuthorized|'authorized'/'denied'/'not determined'/'config error'|允许使用相册的开关|App 端仅 iOS 支持| +|albumAuthorized|'authorized'/'denied'/'not determined'|允许使用相册的开关|App 端仅 iOS 支持| |bluetoothAuthorized|'authorized'/'denied'/'not determined'/'config error'|允许使用蓝牙的开关|App 端仅 iOS 支持| |cameraAuthorized|'authorized'/'denied'/'not determined'/'config error'|允许使用摄像头的开关|| |locationAuthorized|'authorized'/'denied'/'not determined'/'config error'|允许使用定位的开关|| @@ -31,7 +31,12 @@ - `'authorized'`：表示已经获得授权，无需再次请求授权； - `'denied'`：表示请求授权被拒绝，无法再次请求授权；（此情况需要引导用户打开系统设置，在设置页中打开权限） - `'non determined'`：表示尚未请求授权，会在App下一次调用系统相应权限时请求；（仅 iOS 会出现。此种情况下引导用户打开系统设置，不展示开关） -- `'config error'`：在 `Android平台` 表示没有对应的权限。在 `iOS平台` 表示没有在 `manifest.json -> App模块配置` 勾选对应的配置 +- `'config error'`： + - bluetoothAuthorized：iOS平台没有在 `manifest.json -> App模块配置` 中配置 `BlueTooth(低功耗蓝牙)` 模块则会返回该值 + - cameraAuthorized：Android平台没有授予 `android.permission.CAMERA` 权限则会返回该值 + - locationAuthorized：Android平台没有授予 `android.permission.ACCESS_COARSE_LOCATION` 权限则会返回该值。iOS平台没有在 `manifest.json -> App模块配置` 中配置 `Geolocation(定位)` 模块则会返回该值 + - microphoneAuthorized：Android平台没有授予 `android.permission.RECORD_AUDIO` 权限则会返回该值 + - notificationAuthorized、notificationAlertAuthorized、notificationBadgeAuthorized、notificationSoundAuthorized：iOS平台没有在 `manifest.json -> App模块配置` 中配置 `Push(推送)` 模块则会返回该值 **示例** diff --git a/docs/api/system/getsystemsetting.md b/docs/api/system/getsystemsetting.md index d06357024..da303e5ce 100644 --- a/docs/api/system/getsystemsetting.md +++ b/docs/api/system/getsystemsetting.md @@ -12,16 +12,16 @@ |属性|类型|说明| |:-|:-|:-| -|bluetoothEnabled|boolean|蓝牙的系统开关。在没有 `bluetoothError` 时该值准确| +|bluetoothEnabled|boolean|蓝牙的系统开关。当值为 `false` 时，App端有可能是配置不正确导致，此时会返回 `bluetoothError` 属性描述错误| |bluetoothError|String/undefined|App平台模块错误时返回，配置正确时不返回此属性。详情见下| -|locationEnabled|boolean|地理位置的系统开关| +|locationEnabled|boolean|地理位置的系统开关。当值为 `false` 时，App端：Android平台是准确的；iOS平台有可能是配置不正确导致，此时会返回 `locationError` 属性描述错误| |locationError|String/undefined|App平台模块错误时返回，配置正确时不返回此属性。详情见下| |wifiEnabled|boolean|Wi-Fi 的系统开关| |deviceOrientation|string|设备方向。`竖屏：portrait`，`横屏：landscape`| **Tips** -- `bluetoothError`：`Android平台` 没有蓝牙权限是返回值为 `"Missing permissions required by BluetoothAdapter.isEnabled: android.permission.BLUETOOTH"`，`iOS平台` 没有配置蓝牙模块返回值为 `"Missing bluetooth module in manifest.json"` -- `locationError`：`iOS平台` 没有定位权限 `"Missing geolocation module in manifest.json"` +- `bluetoothError`：Android平台值为 `"Missing permissions required by BluetoothAdapter.isEnabled: android.permission.BLUETOOTH"` 表示没有 `android.permission.BLUETOOTH` 权限；iOS平台值为 `"Missing bluetooth module in manifest.json"` ，表示没有在 `manifest.json -> App模块配置` 中配置 `BlueTooth(低功耗蓝牙)` 模块 +- `locationError`：Android平台不会返回此值；iOS平台值为 `"Missing geolocation module in manifest.json"` 表示没有在 `manifest.json -> App模块配置` 中配置 `Geolocation(定位)` 模块 **示例** -- GitLab