Activity.RequestPermissions Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| Nombre | Description |
|---|---|
| RequestPermissions(String[], Int32) |
Solicita permisos para conceder a esta aplicación. |
| RequestPermissions(String[], Int32, Int32) |
Solicita permisos para conceder a esta aplicación. |
RequestPermissions(String[], Int32)
Solicita permisos para conceder a esta aplicación.
[Android.Runtime.Register("requestPermissions", "([Ljava/lang/String;I)V", "", ApiSince=23)]
public void RequestPermissions(string[] permissions, int requestCode);
[<Android.Runtime.Register("requestPermissions", "([Ljava/lang/String;I)V", "", ApiSince=23)>]
member this.RequestPermissions : string[] * int -> unit
Parámetros
- permissions
- String[]
String: los permisos solicitados. Debe ser distinto de NULL y no estar vacío.
- requestCode
- Int32
int: código de solicitud específico de la aplicación para que coincida con un resultado notificado a onRequestPermissionsResult(int, String, int). Debe ser >= 0.
- Atributos
Comentarios
Solicita permisos para conceder a esta aplicación. Estos permisos deben solicitarse en el manifiesto, no deben concederse a la aplicación y deben tener un nivel de protección peligroso, independientemente de si se declaran en la plataforma o en una aplicación de terceros. Los permisos normales PermissionInfo.PROTECTION_NORMAL se conceden en tiempo de instalación si se solicitan en el manifiesto. Los permisos de firma PermissionInfo.PROTECTION_SIGNATURE se conceden en tiempo de instalación si se solicitan en el manifiesto y la firma de la aplicación coincide con la firma de la aplicación que declara los permisos.
Llame a shouldShowRequestPermissionRationale(String) antes de llamar a esta API para comprobar si el sistema recomienda mostrar una interfaz de usuario racional antes de solicitar un permiso.
Si la aplicación no tiene los permisos solicitados, el usuario se mostrará con la interfaz de usuario para aceptarlos. Una vez que el usuario haya aceptado o rechazado los permisos solicitados, recibirá una devolución de llamada en onRequestPermissionsResult(int, String, int) que notifica si se concedieron o no los permisos.
Tenga en cuenta que solicitar un permiso no garantiza que se conceda y la aplicación debe poder ejecutarse sin tener este permiso.
Este método puede iniciar una actividad que permita al usuario elegir qué permisos conceder y cuáles rechazar. Por lo tanto, debe estar preparado para que la actividad se pueda pausar y reanudar. Además, conceder algunos permisos puede requerir un reinicio de la aplicación. En tal caso, el sistema volverá a crear la pila de actividades antes de entregar el resultado a onRequestPermissionsResult(int, String, int).
Al comprobar si tiene un permiso, debe usar checkSelfPermission(String).
No se puede solicitar un permiso si la actividad establece noHistory en true porque, en este caso, la actividad no recibiría devoluciones de llamada de resultados, incluidas onRequestPermissionsResult(int, String, int).
El repositorio de ejemplos de permisos muestra cómo usar este método para solicitar permisos en tiempo de ejecución.
Consulte también:
Throws: IllegalArgumentException si requestCode es negativo.
Referencia de Android para android.app.Activity.requestPermissions.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.
Se aplica a
RequestPermissions(String[], Int32, Int32)
Solicita permisos para conceder a esta aplicación.
[Android.Runtime.Register("requestPermissions", "([Ljava/lang/String;II)V", "", ApiSince=35)]
public void RequestPermissions(string[] permissions, int requestCode, int deviceId);
[<Android.Runtime.Register("requestPermissions", "([Ljava/lang/String;II)V", "", ApiSince=35)>]
member this.RequestPermissions : string[] * int * int -> unit
Parámetros
- permissions
- String[]
String: los permisos solicitados. Debe ser distinto de NULL y no estar vacío.
- requestCode
- Int32
int: código de solicitud específico de la aplicación para que coincida con un resultado notificado a onRequestPermissionsResult(int, String, int). Debe ser >= 0.
- deviceId
- Int32
int: la aplicación solicita permisos para este dispositivo. El dispositivo principal o físico se asigna Context.DEVICE_ID_DEFAULT y a los dispositivos virtuales se les asignan identificadores de dispositivo únicos.
- Atributos
Comentarios
Solicita permisos para conceder a esta aplicación. Estos permisos deben solicitarse en el manifiesto, no deben concederse a la aplicación y deben tener un nivel de protección peligroso, independientemente de si se declaran en la plataforma o en una aplicación de terceros. Los permisos normales PermissionInfo.PROTECTION_NORMAL se conceden en tiempo de instalación si se solicitan en el manifiesto. Los permisos de firma PermissionInfo.PROTECTION_SIGNATURE se conceden en tiempo de instalación si se solicitan en el manifiesto y la firma de la aplicación coincide con la firma de la aplicación que declara los permisos.
Llame a shouldShowRequestPermissionRationale(String) antes de llamar a esta API para comprobar si el sistema recomienda mostrar una interfaz de usuario racional antes de solicitar un permiso.
Si la aplicación no tiene los permisos solicitados, el usuario se mostrará con la interfaz de usuario para aceptarlos. Una vez que el usuario haya aceptado o rechazado los permisos solicitados, recibirá una devolución de llamada en onRequestPermissionsResult(int, String, int) que notifica si se concedieron o no los permisos.
Tenga en cuenta que solicitar un permiso no garantiza que se conceda y la aplicación debe poder ejecutarse sin tener este permiso.
Este método puede iniciar una actividad que permita al usuario elegir qué permisos conceder y cuáles rechazar. Por lo tanto, debe estar preparado para que la actividad se pueda pausar y reanudar. Además, conceder algunos permisos puede requerir un reinicio de la aplicación. En tal caso, el sistema volverá a crear la pila de actividades antes de entregar el resultado a onRequestPermissionsResult(int, String, int).
Al comprobar si tiene un permiso, debe usar checkSelfPermission(String).
No se puede solicitar un permiso si la actividad establece noHistory en true porque, en este caso, la actividad no recibiría devoluciones de llamada de resultados, incluidas onRequestPermissionsResult(int, String, int).
El repositorio de ejemplos de permisos muestra cómo usar este método para solicitar permisos en tiempo de ejecución.
Consulte también:
Throws: IllegalArgumentException si requestCode es negativo.
Referencia de Android para android.app.Activity.requestPermissions.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.