Das Anfordern von Berechtigungen unter Wear OS ähnelt dem Anfordern von Berechtigungen in mobilen Apps mit einigen zusätzlichen Anwendungsfällen auf. In diesem Dokument wird vorausgesetzt, dass Sie wie Android-Berechtigungen funktionieren. Ist dies nicht der Fall, lesen Sie nach, wie die Berechtigungen für Android-Geräte.
Wie bei einer mobilen App muss der Nutzer einer Wear-App die folgenden Berechtigungen erteilen: auf bestimmte Funktionen zugreifen. Bieten Sie in Ihren Wear-Apps aussagekräftige Funktionen verfügbar, ohne Berechtigungen.
Berechtigungsszenarien
Beim Anfordern von Anfragen können verschiedene Szenarien auftreten, gefährlichen Berechtigungen auf Wear OS:
Die Wear-App fordert Berechtigungen für eine App an, die auf dem Wearable ausgeführt wird .
Die Wear-App fordert Berechtigungen für eine App an, die auf dem Smartphone ausgeführt wird.
Die Telefon-App fordert Berechtigungen für eine App an, die auf dem Wearable ausgeführt wird .
Die Telefon-App fordert mehrere Berechtigungen an, die nur verwendet werden können, während die Wearable ist verbunden.
Wenn du all diese Szenarien in einer funktionierenden App sehen möchtest, sieh in der ExcersizeSampleCompose auf GitHub.
In den folgenden Abschnitten werden diese Szenarien erläutert. Detailliertere Informationen Informationen zum Anfordern von Berechtigungen finden Sie in der Berechtigungsanfrage Muster hinzufügen.
Wear App fordert Wearable-Berechtigung an
Wenn die Wear-App eine Berechtigung für eine App anfordert, die auf dem Wearable ausgeführt wird Gerät wird vom System ein Dialogfeld angezeigt, in dem der Nutzer zur Eingabe dieser Berechtigung aufgefordert wird. Fordern Sie in Ihrer App nur dann Berechtigungen an, wenn der Nutzer den Grund für die zum Ausführen eines bestimmten Vorgangs benötigt.
Lesen Sie die Prinzipien für Berechtigungen.
damit Sie Ihren Nutzern die bestmögliche Erfahrung bieten können. Denken Sie auch daran,
um zu prüfen,
shouldShowRequestPermissionRationale()
und weitere Informationen angeben
nach Bedarf.
Wenn für eine App oder ein Zifferblatt mehrere Berechtigungen gleichzeitig erforderlich sind, -Anfragen erscheinen nacheinander.
<ph type="x-smartling-placeholder">![Mehrere Berechtigungsbildschirme, einer nach dem anderen](https://developer.android.google.cn/static/images/training/wear/multiple_permissions.png?authuser=7&hl=de)
Wear App fordert Smartphone-Berechtigung an
Wenn die Wear-App die Berechtigung für ein Smartphone anfordert, z. B. für eine Wearable-App Zugriff auf Fotos oder andere sensible Daten über die mobile Version der App, Die Wear-App muss den Nutzer an das Smartphone weiterleiten, um die Berechtigung zu akzeptieren. Hier sehen Sie Telefon-App kann dem Nutzer mithilfe einer Aktivität zusätzliche Informationen liefern. Fügen Sie der Aktivität zwei Schaltflächen hinzu: eine zum Gewähren der Berechtigung und eine für das Leugnen des Problems.
<ph type="x-smartling-placeholder">![Die Wear App leitet den Nutzer an das Smartphone weiter, um die Berechtigung zu erteilen.](https://developer.android.google.cn/static/images/training/wear/open_on_phone.png?authuser=7&hl=de)
Telefon-App fordert Wearable-Berechtigung an
Wenn der Nutzer eine Telefon-App verwendet und die App eine Wearable-Berechtigung benötigt, z. B.
Zum Beispiel, um Musik vorab zu laden, falls die Telefon-App unterbrochen wird.
sendet den Nutzer an das Wearable-Gerät, um die Berechtigung zu akzeptieren. Das Wearable
Version der App verwendet die
requestPermissions()
zum Auslösen des Dialogfelds für Systemberechtigungen.
![Die Telefon-App leitet den Nutzer an das Wearable weiter, um die Berechtigung zu erteilen.](https://developer.android.google.cn/static/images/training/wear/phone_requests_wear.png?authuser=7&hl=de)
Die Telefon App fordert mehrere Berechtigungen gleichzeitig an
<ph type="x-smartling-placeholder">![](https://developer.android.google.cn/static/images/training/wear/companion-device-profile.png?authuser=7&hl=de)
Partner-Apps auf Android 12 (API-Level 31) und höher können Begleitgeräte verwenden Profilen beim Verbinden mit einer Smartwatch. Ein Profil vereinfacht die Registrierung Prozess, indem die Erteilung eines gerätetypspezifischen Satzes von Berechtigungen bündelt wird in einem Schritt zusammengefasst.
Die gebündelten Berechtigungen werden der Companion-App gewährt, sobald das Gerät
stellt eine Verbindung her und gilt nur so lange, wie das Gerät verknüpft ist. Löschen der App oder
Wenn Sie die Verknüpfung entfernen, werden auch die Berechtigungen entfernt. Weitere Informationen finden Sie unter
AssociationRequest.Builder.setDeviceProfile()
.
Berechtigungsanfragemuster
Es gibt verschiedene Muster für die Anforderung von Berechtigungen von Nutzern. Reihenfolge Priorität haben, sind sie:
Fragen Sie im Kontext, wenn die Berechtigung offensichtlich für eine Person erforderlich ist. bestimmte Funktionen, aber nicht notwendig, damit die App als Ganzes funktioniert.
Informieren Sie die Nutzer im Kontext, wenn der Grund für die Beantragung der Berechtigung nicht und die Berechtigung ist nicht notwendig, damit die gesamte App funktioniert.
Diese Muster werden in den folgenden Abschnitten erläutert.
Frage im Kontext stellen
Berechtigungen anfordern, wenn dem Nutzer klar ist, warum die Berechtigung erforderlich ist um eine bestimmte Operation auszuführen. Die Wahrscheinlichkeit, dass Nutzer eine Berechtigung erteilen, ist höher, verstehen, was mit der Funktion verbunden ist, die sie nutzen möchten.
Beispielsweise kann es sein, dass eine App den Standort des Nutzers benötigt, um Orte in der Nähe anzuzeigen. von Interesse sein. Wenn der Nutzer auf Orte in der Nähe tippt, kann die App sofort um die Berechtigung zur Standortermittlung, Beziehung zwischen der Suche nach Orten in der Nähe und dem Bedarf Berechtigung. Aufgrund der Offenheit dieser Beziehung ist es für die App, um zusätzliche Informationsbildschirme anzuzeigen.
<ph type="x-smartling-placeholder">![Die App fordert dann eine Berechtigung an, wenn dies unbedingt erforderlich ist.](https://developer.android.google.cn/static/images/training/wear/ask_in_context.png?authuser=7&hl=de)
Im Kontext informieren
Abbildung 6 zeigt ein Beispiel für kontextbezogene Bildung. Die App benötigt keine Berechtigungen zum Starten des Timers, aber ein Inline-Hinweis dass dieser Teil der Aktivität – die Standorterkennung – gesperrt ist. Wenn Nutzende auf das Symbol Hinweis: Ein Bildschirm für eine Berechtigungsanfrage wird angezeigt, über den der Nutzer den Standort entsperren kann. -Erkennung.
Verwenden Sie die Methode
shouldShowRequestPermissionRationale()
, damit Ihre App besser entscheiden kann, ob sie weitere Informationen zur Verfügung stellen soll. Für
Weitere Informationen finden Sie unter App anfordern
Berechtigungen Alternativ können Sie
wie die Sprecherbeispielanwendung auf GitHub mit der
Informationen.
![Wenn eine Berechtigung erforderlich ist, erklärt die App, warum sie notwendig ist.](https://developer.android.google.cn/static/images/training/wear/educate_in_context.png?authuser=7&hl=de)
Umgang mit Ablehnung
Wenn der Nutzer eine angeforderte Berechtigung ablehnt, die für eine bestimmte blockieren Sie sie nicht daran, die Aktivität fortzusetzen. Wenn bestimmte Teile des Die Aktivität wird durch die verweigerte Berechtigung deaktiviert, bietet visuelle, umsetzbare Feedback geben.
Abbildung 7 zeigt die Verwendung eines Schloss-Symbols, um anzuzeigen, dass eine Funktion gesperrt ist. weil der Nutzer keine Berechtigung zur Verwendung gewährt hat.
<ph type="x-smartling-placeholder">![Lehnt der Nutzer die Berechtigung ab, wird neben der entsprechenden Funktion ein Schloss-Symbol angezeigt.](https://developer.android.google.cn/static/images/training/wear/deny.png?authuser=7&hl=de)
Wenn ein zuvor abgelehntes Berechtigungsdialogfeld für Wearables ein zweites Mal angezeigt wird, die Option Ablehnen, nicht mehr anzeigen enthält. Wenn die Nutzenden diese Option wählen, kann er diese Berechtigung in Zukunft nur noch über über die Einstellungen des Wearables.
<ph type="x-smartling-placeholder">![Das System bietet an, keine Berechtigung mehr anzufordern.](https://developer.android.google.cn/static/images/training/wear/ask_again.png?authuser=7&hl=de)
Weitere Informationen zum Umgang mit der Ablehnung von Berechtigungen
Berechtigungen für Dienste
Nur eine Aktivität kann die
requestPermissions()
Wenn der Nutzer also über einen Dienst mit Ihrer App interagiert, z. B.
über ein Zifferblatt – der Dienst muss eine Aktivität öffnen, bevor der
Berechtigung. Bieten Sie in dieser Aktivität zusätzliche Informationen dazu an, warum die
Berechtigung ist erforderlich.
Fordere im Allgemeinen keine Berechtigungen für ein Zifferblatt an. Implementieren Sie stattdessen Zusatzfunktion hinzufügen und den auswählen, welche Daten über die Zusatzfunktion angezeigt werden sollen.
Einstellungen
Nutzer können die Berechtigungen für eine Wear-App jederzeit in den Einstellungen ändern. Wenn der Parameter
eine Aktion auszuführen, die eine Berechtigung erfordert, rufen Sie zunächst die
checkSelfPermission()
, um festzustellen, ob die App die Berechtigung zum Ausführen des Vorgangs hat.
Führen Sie diese Prüfung auch dann durch, wenn der Nutzer wurde die Berechtigung erteilt, da der Nutzer sie später möglicherweise widerrufen hat.
<ph type="x-smartling-placeholder">![Der Nutzer kann die Berechtigungen über die App „Einstellungen“ ändern.](https://developer.android.google.cn/static/images/training/wear/for_settings.png?authuser=7&hl=de)
Empfehlungen für dich
- Hinweis: Der Linktext wird angezeigt, wenn JavaScript deaktiviert ist.
- Laufzeitberechtigungen anfordern
- Bluetooth-Berechtigungen
- Im Hintergrund kommunizieren