uni.getAppAuthorizeSetting()

# uni.getAppAuthorizeSetting()

获取 APP 授权设置

平台差异说明

App	H5	微信小程序	支付宝小程序	百度小程序	抖音小程序、飞书小程序	钉钉小程序	QQ小程序	快手小程序	京东小程序	元服务
HBuilderX (3.5.2+)	x	基础库 (2.20.1+)	x	x	x	x	x	x	x	x

# getAppAuthorizeSetting 兼容性

HarmonyOS
HBuilderX 4.31

返回参数说明

属性	类型	说明	平台差异说明
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'	允许使用定位的开关
locationAccuracy	String	定位准确度。`"reduced"` 表示模糊定位；`"full"` 表示精准定位；`"unsupported"` 表示不支持	App 端仅 iOS 支持
microphoneAuthorized	'authorized'/'denied'/'not determined'/'config error'	允许使用麦克风的开关
notificationAuthorized	'authorized'/'denied'/'not determined'/'config error'	允许通知的开关
notificationAlertAuthorized	'authorized'/'denied'/'not determined'/'config error'	允许通知带有提醒的开关	App 端仅 iOS（10.0+）支持
notificationBadgeAuthorized	'authorized'/'denied'/'not determined'/'config error'	允许通知带有标记的开关	App 端仅 iOS（10.0+）支持
notificationSoundAuthorized	'authorized'/'denied'/'not determined'/'config error'	允许通知带有声音的开关	App 端仅 iOS（10.0+）支持
phoneCalendarAuthorized	'authorized'/'denied'/'not determined'	允许读写日历的开关	App 端不支持

# 返回值

类型

GetAppAuthorizeSettingResult

名称

类型

必填

默认值

兼容性

描述

albumAuthorized

string

是

允许 App 使用相册的开关

bluetoothAuthorized

string

是

允许 App 使用蓝牙的开关

cameraAuthorized

string

是

允许 App 使用摄像头的开关

locationAuthorized

string

是

允许 App 使用定位的开关

locationAccuracy

string

否

定位准确度。

locationReducedAccuracy

boolean

否

定位准确度（推荐使用 locationAccuracy 属性）。true 表示模糊定位，false 表示精确定位（仅 iOS 支持）

microphoneAuthorized

string

是

允许 App 使用麦克风的开关

notificationAuthorized

string

是

允许 App 通知的开关

notificationAlertAuthorized

string

否

允许 App 通知带有提醒的开关（仅 iOS 支持）

notificationBadgeAuthorized

string

否

允许 App 通知带有标记的开关（仅 iOS 支持）

notificationSoundAuthorized

string

否

允许 App 通知带有声音的开关（仅 iOS 支持）

phoneCalendarAuthorized

string

否

允许读写日历的开关（仅微信小程序支持）

readPhoneCalendarAuthorized

string

否

允许读日历的开关（仅鸿蒙支持）

writePhoneCalendarAuthorized

string

否

允许写日历的开关（仅鸿蒙支持）

pasteboardAuthorized

string

否

允许读取剪切版（仅鸿蒙支持）

App 端需要获取更多权限状态可参考插件: App权限判断和提示

# 不推荐使用的返回参数，仅为兼容保留

Tips：

'authorized'：表示已经获得授权，无需再次请求授权；
'denied'：表示请求授权被拒绝，无法再次请求授权；（此情况需要引导用户打开系统设置，在设置页中打开权限）
'not determined'：表示尚未请求授权，会在App下一次调用系统相应权限时请求；（仅 iOS 会出现。此种情况下引导用户打开系统设置，不展示开关）
'config error'：只有在 App 端时返回
- bluetoothAuthorized：
  - Android平台不会返回 config error
  - iOS平台：表示没有在 manifest.json -> App模块配置 中配置 BlueTooth(低功耗蓝牙) 模块
- cameraAuthorized：
  - Android平台：表示没有授予 android.permission.CAMERA 权限
  - iOS平台不会返回 config error
- locationAuthorized：
  - Android平台：表示没有授予 android.permission.ACCESS_COARSE_LOCATION 权限
  - iOS平台：表示没有在 manifest.json -> App模块配置 中配置 Geolocation(定位) 模块
- microphoneAuthorized：
  - Android平台：表示没有授予 android.permission.RECORD_AUDIO 权限
  - iOS平台不会返回 config error
- notificationAuthorized、notificationAlertAuthorized、notificationBadgeAuthorized、notificationSoundAuthorized：
  - Android平台不支持
  - iOS平台：表示没有在 manifest.json -> App模块配置 中配置 Push(推送) 模块

示例

const appAuthorizeSetting = uni.getAppAuthorizeSetting()

console.log(appAuthorizeSetting.albumAuthorized)
console.log(appAuthorizeSetting.bluetoothAuthorized)
console.log(appAuthorizeSetting.cameraAuthorized)
console.log(appAuthorizeSetting.locationAuthorized)
console.log(appAuthorizeSetting.locationReducedAccuracy)
console.log(appAuthorizeSetting.microphoneAuthorized)
console.log(appAuthorizeSetting.notificationAlertAuthorized)
console.log(appAuthorizeSetting.notificationAuthorized)
console.log(appAuthorizeSetting.notificationBadgeAuthorized)
console.log(appAuthorizeSetting.notificationSoundAuthorized)
console.log(appAuthorizeSetting.phoneCalendarAuthorized)