Activity.RequestPermissions Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| Name | Beschreibung |
|---|---|
| RequestPermissions(String[], Int32) |
Fordert Berechtigungen an, die dieser Anwendung erteilt werden sollen. |
| RequestPermissions(String[], Int32, Int32) |
Fordert Berechtigungen an, die dieser Anwendung erteilt werden sollen. |
RequestPermissions(String[], Int32)
Fordert Berechtigungen an, die dieser Anwendung erteilt werden sollen.
[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 -> unitParameter
- permissions
- String[]
Die angeforderten Berechtigungen. Darf nicht null und nicht leer sein.
- requestCode
- Int32
Anwendungsspezifischer Anforderungscode, der mit einem Ergebnis übereinstimmt, das #onRequestPermissionsResultgemeldet wurde.
Sollte = 0 sein >.
- Attribute
Hinweise
Fordert Berechtigungen an, die dieser Anwendung erteilt werden sollen. Diese Berechtigungen müssen in Ihrem Manifest angefordert werden, sie sollten Ihrer App nicht erteilt werden, und sie sollten über Schutzebene android.content.pm.PermissionInfo#PROTECTION_DANGEROUS dangerousverfügen, unabhängig davon, ob sie von der Plattform oder einer Drittanbieter-App deklariert werden.
Normale Berechtigungen android.content.pm.PermissionInfo#PROTECTION_NORMAL werden zur Installationszeit erteilt, wenn sie im Manifest angefordert werden. Signaturberechtigungen android.content.pm.PermissionInfo#PROTECTION_SIGNATURE werden zur Installationszeit erteilt, wenn sie im Manifest angefordert werden, und die Signatur Ihrer App stimmt mit der Signatur der App überein, die die Berechtigungen deklariert.
Rufen Sie vor dem Aufrufen #shouldShowRequestPermissionRationale dieser API auf, um zu überprüfen, ob das System empfiehlt, eine Rationale-UI anzuzeigen, bevor Sie nach einer Berechtigung fragen.
Wenn Ihre App nicht über die angeforderten Berechtigungen verfügt, wird dem Benutzer die Benutzeroberfläche zur Annahme angezeigt. Nachdem der Benutzer die angeforderten Berechtigungen akzeptiert oder abgelehnt hat, erhalten Sie einen Rückruf zur #onRequestPermissionsResult Meldung, ob die Berechtigungen erteilt wurden oder nicht.
Beachten Sie, dass das Anfordern einer Berechtigung nicht garantiert, dass sie erteilt wird und Ihre App ohne diese Berechtigung ausgeführt werden kann.
Diese Methode kann eine Aktivität starten, mit der der Benutzer auswählen kann, welche Berechtigungen erteilt werden sollen und welche abgelehnt werden sollen. Daher sollten Sie darauf vorbereitet sein, dass Ihre Aktivität angehalten und fortgesetzt werden kann. Darüber hinaus erfordert das Erteilen einiger Berechtigungen möglicherweise einen Neustart der Anwendung. In einem solchen Fall erstellt das System den Aktivitätsstapel neu, bevor das Ergebnis an #onRequestPermissionsResult.
Überprüfen Sie, ob Sie über eine Berechtigung verfügen, die Sie verwenden #checkSelfPermission(String)sollten.
Sie können keine Berechtigung anfordern, wenn Ihre Aktivität festgelegt wird android.R.styleable#AndroidManifestActivity_noHistory noHistorytrue , da in diesem Fall die Aktivität keine Ergebnisrückrufe einschließlich #onRequestPermissionsResultempfangen würde.
Das Repository für Berechtigungsbeispiele veranschaulicht, wie Diese Methode zum Anfordern von Berechtigungen zur Laufzeit verwendet wird.
Java Dokumentation für android.app.Activity.requestPermissions(java.lang.String[], int).
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.
Gilt für:
RequestPermissions(String[], Int32, Int32)
Fordert Berechtigungen an, die dieser Anwendung erteilt werden sollen.
[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 -> unitParameter
- permissions
- String[]
Die angeforderten Berechtigungen. Darf nicht null und nicht leer sein.
- requestCode
- Int32
Anwendungsspezifischer Anforderungscode, der mit einem Ergebnis übereinstimmt, das #onRequestPermissionsResultgemeldet wurde.
Sollte = 0 sein >.
- deviceId
- Int32
Die App fordert Berechtigungen für dieses Gerät an. Das primäre/physische Gerät wird zugewiesen Context#DEVICE_ID_DEFAULT, und virtuellen Geräten werden eindeutige Geräte-IDs zugewiesen.
- Attribute
Hinweise
Fordert Berechtigungen an, die dieser Anwendung erteilt werden sollen. Diese Berechtigungen müssen in Ihrem Manifest angefordert werden, sie sollten Ihrer App nicht erteilt werden, und sie sollten über Schutzebene android.content.pm.PermissionInfo#PROTECTION_DANGEROUS dangerousverfügen, unabhängig davon, ob sie von der Plattform oder einer Drittanbieter-App deklariert werden.
Normale Berechtigungen android.content.pm.PermissionInfo#PROTECTION_NORMAL werden zur Installationszeit erteilt, wenn sie im Manifest angefordert werden. Signaturberechtigungen android.content.pm.PermissionInfo#PROTECTION_SIGNATURE werden zur Installationszeit erteilt, wenn sie im Manifest angefordert werden, und die Signatur Ihrer App stimmt mit der Signatur der App überein, die die Berechtigungen deklariert.
Rufen Sie vor dem Aufrufen #shouldShowRequestPermissionRationale dieser API auf, um zu überprüfen, ob das System empfiehlt, eine Rationale-UI anzuzeigen, bevor Sie nach einer Berechtigung fragen.
Wenn Ihre App nicht über die angeforderten Berechtigungen verfügt, wird dem Benutzer die Benutzeroberfläche zur Annahme angezeigt. Nachdem der Benutzer die angeforderten Berechtigungen akzeptiert oder abgelehnt hat, erhalten Sie einen Rückruf zur #onRequestPermissionsResult Meldung, ob die Berechtigungen erteilt wurden oder nicht.
Beachten Sie, dass das Anfordern einer Berechtigung nicht garantiert, dass sie erteilt wird und Ihre App ohne diese Berechtigung ausgeführt werden kann.
Diese Methode kann eine Aktivität starten, mit der der Benutzer auswählen kann, welche Berechtigungen erteilt werden sollen und welche abgelehnt werden sollen. Daher sollten Sie darauf vorbereitet sein, dass Ihre Aktivität angehalten und fortgesetzt werden kann. Darüber hinaus erfordert das Erteilen einiger Berechtigungen möglicherweise einen Neustart der Anwendung. In einem solchen Fall erstellt das System den Aktivitätsstapel neu, bevor das Ergebnis an #onRequestPermissionsResult.
Überprüfen Sie, ob Sie über eine Berechtigung verfügen, die Sie verwenden #checkSelfPermission(String)sollten.
Sie können keine Berechtigung anfordern, wenn Ihre Aktivität festgelegt wird android.R.styleable#AndroidManifestActivity_noHistory noHistorytrue , da in diesem Fall die Aktivität keine Ergebnisrückrufe einschließlich #onRequestPermissionsResultempfangen würde.
Das Repository für Berechtigungsbeispiele veranschaulicht, wie Diese Methode zum Anfordern von Berechtigungen zur Laufzeit verwendet wird.
Java Dokumentation für android.app.Activity.requestPermissions(java.lang.String[], int, int).
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.