跳到主要内容
版本:Next

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: '已授予'
  • DENIED: '已拒绝'
  • NEVER_ASK_AGAIN: '不再询问'

参考

方法

check()

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

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

参数:

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

request()

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

提示用户启用某项权限,并返回一个 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要请求的权限数组。