跳到主要内容

PermissionsAndroid

PermissionsAndroid 提供了对 Android M 新权限模型的访问。"普通"权限会在应用安装时默认授予，只要它们出现在 AndroidManifest.xml 中即可。但是，"危险"权限需要显示对话框提示。对于这些权限，你应该使用此模块。

在 SDK 版本 23 之前的设备上，如果权限出现在清单中，系统会自动授予这些权限，因此 check 应始终返回 true，而 request 应始终解析为 PermissionsAndroid.RESULTS.GRANTED。

如果用户之前关闭了你提示请求的某项权限，操作系统会建议你的应用说明需要该权限的原因。可选的 rationale 参数仅在必要时显示对话框提示，否则将显示正常的权限提示。

示例​

需要提示用户的权限​

可作为 PermissionsAndroid.PERMISSIONS 下的常量使用：

  • READ_CALENDAR：'android.permission.READ_CALENDAR'
  • WRITE_CALENDAR：'android.permission.WRITE_CALENDAR'
  • CAMERA：'android.permission.CAMERA'
  • READ_CONTACTS：'android.permission.READ_CONTACTS'
  • WRITE_CONTACTS：'android.permission.WRITE_CONTACTS'
  • GET_ACCOUNTS：'android.permission.GET_ACCOUNTS'
  • ACCESS_FINE_LOCATION：'android.permission.ACCESS_FINE_LOCATION'
  • ACCESS_COARSE_LOCATION：'android.permission.ACCESS_COARSE_LOCATION'
  • ACCESS_BACKGROUND_LOCATION：'android.permission.ACCESS_BACKGROUND_LOCATION'
  • RECORD_AUDIO：'android.permission.RECORD_AUDIO'
  • READ_PHONE_STATE：'android.permission.READ_PHONE_STATE'
  • CALL_PHONE：'android.permission.CALL_PHONE'
  • READ_CALL_LOG：'android.permission.READ_CALL_LOG'
  • WRITE_CALL_LOG：'android.permission.WRITE_CALL_LOG'
  • ADD_VOICEMAIL：'com.android.voicemail.permission.ADD_VOICEMAIL'
  • USE_SIP：'android.permission.USE_SIP'
  • PROCESS_OUTGOING_CALLS：'android.permission.PROCESS_OUTGOING_CALLS'
  • BODY_SENSORS：'android.permission.BODY_SENSORS'
  • SEND_SMS：'android.permission.SEND_SMS'
  • RECEIVE_SMS：'android.permission.RECEIVE_SMS'
  • READ_SMS：'android.permission.READ_SMS'
  • RECEIVE_WAP_PUSH：'android.permission.RECEIVE_WAP_PUSH'
  • RECEIVE_MMS：'android.permission.RECEIVE_MMS'
  • READ_EXTERNAL_STORAGE：'android.permission.READ_EXTERNAL_STORAGE'
  • WRITE_EXTERNAL_STORAGE：'android.permission.WRITE_EXTERNAL_STORAGE'
  • BLUETOOTH_CONNECT：'android.permission.BLUETOOTH_CONNECT'
  • BLUETOOTH_SCAN：'android.permission.BLUETOOTH_SCAN'
  • BLUETOOTH_ADVERTISE：'android.permission.BLUETOOTH_ADVERTISE'
  • ACCESS_MEDIA_LOCATION：'android.permission.ACCESS_MEDIA_LOCATION'
  • ACCEPT_HANDOVER：'android.permission.ACCEPT_HANDOVER'
  • ACTIVITY_RECOGNITION：'android.permission.ACTIVITY_RECOGNITION'
  • ANSWER_PHONE_CALLS：'android.permission.ANSWER_PHONE_CALLS'
  • READ_PHONE_NUMBERS：'android.permission.READ_PHONE_NUMBERS'
  • UWB_RANGING：'android.permission.UWB_RANGING'
  • BODY_SENSORS_BACKGROUND：'android.permission.BODY_SENSORS_BACKGROUND'
  • READ_MEDIA_IMAGES：'android.permission.READ_MEDIA_IMAGES'
  • READ_MEDIA_VIDEO：'android.permission.READ_MEDIA_VIDEO'
  • READ_MEDIA_AUDIO：'android.permission.READ_MEDIA_AUDIO'
  • POST_NOTIFICATIONS：'android.permission.POST_NOTIFICATIONS'
  • NEARBY_WIFI_DEVICES：'android.permission.NEARBY_WIFI_DEVICES'
  • READ_VOICEMAIL：'com.android.voicemail.permission.READ_VOICEMAIL'，
  • WRITE_VOICEMAIL：'com.android.voicemail.permission.WRITE_VOICEMAIL'，

请求权限时的结果字符串​

可作为 PermissionsAndroid.RESULTS 下的常量使用：

  • GRANTED：'granted'
  • DENIED：'denied'
  • NEVER_ASK_AGAIN：'never_ask_again'

参考

方法​

check()​

React TSX
static check(permission: Permission): Promise<boolean>;

返回一个 Promise，该 Promise 解析为一个布尔值，用于表示指定权限是否已被授予。

参数：

名称类型必填描述
permissionstring是要检查的权限。

request()​

React TSX
static request(
  permission: Permission,
  rationale?: Rationale,
): Promise<PermissionStatus>;

提示用户启用某项权限，并返回一个 Promise。该 Promise 解析为一个字符串值（请参阅上面的结果字符串），用于表示用户是否允许或拒绝该请求，或者是否不希望再次收到询问。

如果提供了 rationale，此函数会向操作系统检查是否有必要显示一个对话框来解释为何需要该权限（https://developer.android.com/training/permissions/requesting.html#explain），然后显示系统权限对话框。

参数：

名称类型必填描述
permissionstring是要请求的权限。
rationaleobject否请参阅下面的 rationale。

Rationale：

名称类型必填描述
titlestring是对话框的标题。
messagestring是对话框的消息。
buttonPositivestring是正向按钮的文本。
buttonNegativestring否负向按钮的文本。
buttonNeutralstring否中性按钮的文本。

requestMultiple()​

React TSX
static requestMultiple(
  permissions: Permission[],
): Promise<{[key in Permission]: PermissionStatus}>;

在同一个对话框中提示用户启用多项权限，并返回一个对象，其中权限为键，字符串为值（请参阅上面的结果字符串），用于表示用户是否允许或拒绝该请求，或者是否不希望再次收到询问。

参数：

名称类型必填描述
permissionsarray是要请求的权限数组。