uni-app
uni-app x
uniCloud
HBuilder
uni 小程序 sdk
uni-app x
uni-app
uni-app x
uniCloud
HBuilder
uni 小程序 sdk
简体中文
API
uni.getAppAuthorizeSetting()
getAppAuthorizeSetting 兼容性
返回值
示例
参见
通用类型
GeneralCallbackResult

# uni.getAppAuthorizeSetting()

获取 APP 授权设置。

# getAppAuthorizeSetting 兼容性

Web Android iOS
x 3.9 4.11

# 返回值

类型
GetAppAuthorizeSettingResult
名称 类型 必备 默认值 兼容性 描述
albumAuthorized string 是 -
允许 App 使用相册的开关
合法值 兼容性 描述
authorized - 已经获得授权，无需再次请求授权
denied - 请求授权被拒绝，无法再次请求授权。Android平台：需要申请相册相关权限；iOS平台：此情况需要引导用户打开系统设置，在设置页中打开权限
not determined - 尚未请求授权，会在App下一次调用系统相应权限时请求；（仅 iOS 会出现。此种情况下引导用户打开系统设置，不展示开关）
config error - Android平台：表示没有配置相册相关权限，权限配置详情；iOS平台：当前应用没有配置相册权限描述
bluetoothAuthorized string 是 -
允许 App 使用蓝牙的开关
合法值 兼容性 描述
authorized - 已经获得授权，无需再次请求授权
denied - 请求授权被拒绝，无法再次请求授权。Android平台：需要申请相册相关权限；iOS平台：此情况需要引导用户打开系统设置，在设置页中打开权限
not determined - 尚未请求授权，会在App下一次调用系统相应权限时请求；（仅 iOS 会出现。此种情况下引导用户打开系统设置，不展示开关）
config error - Android平台：表示没有配置蓝牙相关权限，权限配置详情；iOS平台：当前应用没有配置蓝牙权限描述
cameraAuthorized string 是 -
允许 App 使用摄像头的开关
合法值 兼容性 描述
authorized - 已经获得授权，无需再次请求授权
denied - 请求授权被拒绝，无法再次请求授权。Android平台：需要申请相册相关权限；iOS平台：此情况需要引导用户打开系统设置，在设置页中打开权限
not determined - 尚未请求授权，会在App下一次调用系统相应权限时请求；（仅 iOS 会出现。此种情况下引导用户打开系统设置，不展示开关）
config error - Android平台：表示没有配置 android.permission.CAMERA 权限，权限配置详情；iOS平台：当前应用没有配置相机权限描述
locationAuthorized string 是 -
允许 App 使用定位的开关
合法值 兼容性 描述
authorized - 已经获得授权，无需再次请求授权
denied - 请求授权被拒绝，无法再次请求授权。Android平台：需要申请相册相关权限；iOS平台：此情况需要引导用户打开系统设置，在设置页中打开权限
not determined - 尚未请求授权，会在App下一次调用系统相应权限时请求；（仅 iOS 会出现。此种情况下引导用户打开系统设置，不展示开关）
config error - Android平台：表示没有配置 android.permission.ACCESS_COARSE_LOCATION 权限，权限配置详情；iOS平台：当前应用没有配置定位权限描述
locationAccuracy string 否 -
定位准确度。
合法值 兼容性 描述
reduced - 模糊定位
full - 精准定位
unsupported - 不支持（包括用户拒绝定位权限和没有包含定位权限描述）
locationReducedAccuracy boolean 否 -
定位准确度（推荐使用 locationAccuracy 属性）。true 表示模糊定位，false 表示精确定位（仅 iOS 支持）
microphoneAuthorized string 是 -
允许 App 使用麦克风的开关
合法值 兼容性 描述
authorized - 已经获得授权，无需再次请求授权
denied - 请求授权被拒绝，无法再次请求授权。Android平台：需要申请相册相关权限；iOS平台：此情况需要引导用户打开系统设置，在设置页中打开权限
not determined - 尚未请求授权，会在App下一次调用系统相应权限时请求；（仅 iOS 会出现。此种情况下引导用户打开系统设置，不展示开关）
config error - Android平台：表示没有配置 android.permission.RECORD_AUDIO 权限，权限配置详情；iOS平台：当前应用没有配置麦克风权限描述
notificationAuthorized string 是 -
允许 App 通知的开关
合法值 兼容性 描述
authorized - 已经获得授权，无需再次请求授权
denied - 请求授权被拒绝，无法再次请求授权。Android平台：需要申请相册相关权限；iOS平台：此情况需要引导用户打开系统设置，在设置页中打开权限
not determined - 尚未请求授权，会在App下一次调用系统相应权限时请求；（仅 iOS 会出现。此种情况下引导用户打开系统设置，不展示开关）
config error - Android平台没有该值；iOS平台：没有包含推送权限描述
notificationAlertAuthorized string 否 -
允许 App 通知带有提醒的开关（仅 iOS 支持）
合法值 兼容性 描述
authorized - 已经获得授权，无需再次请求授权
denied - 请求授权被拒绝，无法再次请求授权。Android平台：需要申请相册相关权限；iOS平台：此情况需要引导用户打开系统设置，在设置页中打开权限
not determined - 尚未请求授权，会在App下一次调用系统相应权限时请求；（仅 iOS 会出现。此种情况下引导用户打开系统设置，不展示开关）
config error - 当前应用没有配置推送权限描述
notificationBadgeAuthorized string 否 -
允许 App 通知带有标记的开关（仅 iOS 支持）
合法值 兼容性 描述
authorized - 已经获得授权，无需再次请求授权
denied - 请求授权被拒绝，无法再次请求授权。Android平台：需要申请相册相关权限；iOS平台：此情况需要引导用户打开系统设置，在设置页中打开权限
not determined - 尚未请求授权，会在App下一次调用系统相应权限时请求；（仅 iOS 会出现。此种情况下引导用户打开系统设置，不展示开关）
config error - 当前应用没有配置推送权限描述
notificationSoundAuthorized string 否 -
允许 App 通知带有声音的开关（仅 iOS 支持）
合法值 兼容性 描述
authorized - 已经获得授权，无需再次请求授权
denied - 请求授权被拒绝，无法再次请求授权。Android平台：需要申请相册相关权限；iOS平台：此情况需要引导用户打开系统设置，在设置页中打开权限
not determined - 尚未请求授权，会在App下一次调用系统相应权限时请求；（仅 iOS 会出现。此种情况下引导用户打开系统设置，不展示开关）
config error - 当前应用没有配置推送权限描述
phoneCalendarAuthorized string 否 -
允许读写日历的开关（仅微信小程序支持）
合法值 兼容性 描述
authorized - 已经获得授权，无需再次请求授权
denied - 请求授权被拒绝，无法再次请求授权；（此情况需要引导用户打开系统设置，在设置页中打开权限）
not determined - 尚未请求授权，会在App下一次调用系统相应权限时请求；（仅 iOS 会出现。此种情况下引导用户打开系统设置，不展示开关）

# 示例

hello uni-app x

该 API 不支持 Web，请运行 hello uni-app x 到 App 平台体验

扫码体验（手机浏览器跳转到App直达页）
 
<template>
  <page-head :title="title"></page-head>
  <view class="uni-common-mt">
    <view class="uni-list">
      <view class="uni-list-cell">
        <view class="uni-pd">
          <view class="uni-label" style="width:180px;">是否授权使用相册</view>
        </view>
        <view class="uni-list-cell-db">
          <input type="text" :disabled="true" placeholder="未获取" :value="albumAuthorized" />
        </view>
      </view>
      <view class="uni-list-cell">
        <view class="uni-pd">
          <view class="uni-label" style="width:180px;">是否授权使用蓝牙</view>
        </view>
        <view class="uni-list-cell-db">
          <input type="text" :disabled="true" placeholder="未获取" :value="bluetoothAuthorized" />
        </view>
      </view>
      <view class="uni-list-cell">
        <view class="uni-pd">
          <view class="uni-label" style="width:180px;">是否授权使用摄像头</view>
        </view>
        <view class="uni-list-cell-db">
          <input type="text" :disabled="true" placeholder="未获取" :value="cameraAuthorized" />
        </view>
      </view>
      <view class="uni-list-cell">
        <view class="uni-pd">
          <view class="uni-label" style="width:180px;">是否授权使用定位</view>
        </view>
        <view class="uni-list-cell-db">
          <input type="text" :disabled="true" placeholder="未获取" :value="locationAuthorized" />
        </view>
      </view>
      <view class="uni-list-cell">
        <view class="uni-pd">
          <view class="uni-label" style="width:180px;">定位准确度</view>
        </view>
        <view class="uni-list-cell-db">
          <input type="text" :disabled="true" placeholder="未获取" :value="locationAccuracy" />
        </view>
      </view>
      <view class="uni-list-cell">
        <view class="uni-pd">
          <view class="uni-label" style="width:180px;">是否授权使用麦克风</view>
        </view>
        <view class="uni-list-cell-db">
          <input type="text" :disabled="true" placeholder="未获取" :value="microphoneAuthorized" />
        </view>
      </view>

      <view class="uni-list-cell">
        <view class="uni-pd">
          <view class="uni-label" style="width:180px;">是否授权通知</view>
        </view>
        <view class="uni-list-cell-db">
          <input type="text" :disabled="true" placeholder="未获取" :value="notificationAuthorized" />
        </view>
      </view>
      <!-- #ifdef APP-IOS -->
      <view class="uni-list-cell">
        <view class="uni-pd">
          <view class="uni-label" style="width:180px;">是否允许通知带有提醒</view>
        </view>
        <view class="uni-list-cell-db">
          <input type="text" :disabled="true" placeholder="未获取" :value="notificationAlertAuthorized" />
        </view>
      </view>

      <view class="uni-list-cell">
        <view class="uni-pd">
          <view class="uni-label" style="width:180px;">是否允许通知带有标记</view>
        </view>
        <view class="uni-list-cell-db">
          <input type="text" :disabled="true" placeholder="未获取" :value="notificationBadgeAuthorized" />
        </view>
      </view>
      <view class="uni-list-cell">
        <view class="uni-pd">
          <view class="uni-label" style="width:180px;">是否允许通知带有声音</view>
        </view>
        <view class="uni-list-cell-db">
          <input type="text" :disabled="true" placeholder="未获取" :value="notificationSoundAuthorized" />
        </view>
      </view>
      <!-- #endif -->
    </view>
    <view class="uni-padding-wrap">
      <view class="uni-btn-v">
        <button type="primary" @tap="getAppAuthorizeSetting">获取App授权设置</button>
      </view>
    </view>
  </view>
</template>
<script>
  export default {
    data() {
      return {
        title: 'getAppAuthorizeSetting',
        cameraAuthorized: "",
        albumAuthorized: "",
        locationAuthorized: "",
        locationAccuracy: "",
        microphoneAuthorized: "",
        bluetoothAuthorized: "",
        notificationAuthorized: "",
        notificationAlertAuthorized: "",
        notificationBadgeAuthorized: "",
        notificationSoundAuthorized: ""
      }
    },
    onUnload: function () {
    },
    methods: {
      getAppAuthorizeSetting: function () {
        const res = uni.getAppAuthorizeSetting();
        this.albumAuthorized = res.albumAuthorized;
        this.bluetoothAuthorized = res.bluetoothAuthorized;
        this.cameraAuthorized = res.cameraAuthorized;
        this.locationAuthorized = res.locationAuthorized;
        this.locationAccuracy = res.locationAccuracy ?? "unsupported";
        this.microphoneAuthorized = res.microphoneAuthorized;
        this.notificationAuthorized = res.notificationAuthorized;
        // #ifdef APP-IOS
        this.notificationAlertAuthorized = res.notificationAlertAuthorized;
        this.notificationBadgeAuthorized = res.notificationBadgeAuthorized;
        this.notificationSoundAuthorized = res.notificationSoundAuthorized;
        // #endif

      }
    }
  }
</script>

<style>
  .uni-pd {
    padding-left: 15px;
  }
</style>

# 参见

如需跳转到权限设置界面，参考utsAndroid.gotoSystemPermissionActivity

注意：

Android和iOS的权限设计并不相同，比如iOS有相册权限，而Android不同版本的相册权限逻辑不一样，低版本没有单独的相册权限，归入本地文件读写权限（非沙盒文件），高版本又独立出来。还有很多权限只有一个平台才有。

权限的命名各平台也不相同，所以本API返回的权限名称不是Android和iOS原始的命名，只是一个示意名称。

本API只返回部分权限，Android平台的权限非常多，在Android上获取所有未授权权限，另见UTSAndroid.getSystemPermissionDenied，这里的权限名称就是Android原始的权限名称了。

# 通用类型

# GeneralCallbackResult

名称 类型 必备 默认值 兼容性 描述
errMsg string 是 - - 错误信息
本页导读
uni.getAppAuthorizeSetting()
getAppAuthorizeSetting 兼容性
返回值
示例
参见
通用类型
GeneralCallbackResult