Berechtigungen unter Wear OS anfordern

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">
</ph> Mehrere Berechtigungsbildschirme, einer nach dem anderen
Abbildung 1: Berechtigungsbildschirme werden nacheinander angezeigt.

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">
</ph> Die Wear App leitet den Nutzer an das Smartphone weiter, um die Berechtigung zu erteilen.
Abbildung 2: Bitten Sie den Nutzer an das Smartphone, die Berechtigung zu erteilen.

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.

<ph type="x-smartling-placeholder">
</ph> Die Telefon-App leitet den Nutzer an das Wearable weiter, um die Berechtigung zu erteilen.
Abbildung 3: Nutzer an das Wearable weiterleiten, damit dieser Berechtigung.

Die Telefon App fordert mehrere Berechtigungen gleichzeitig an

<ph type="x-smartling-placeholder">
</ph>
Abbildung 4: Ein Berechtigungsdialogfeld, in dem ein Companion-Geräteprofil verwendet wird, um mehrere Berechtigungen in einer Anfrage anfordern.

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">
</ph> Die App fordert dann eine Berechtigung an, wenn dies unbedingt erforderlich ist.
Abbildung 5: Frage im Kontext um Erlaubnis.

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.

<ph type="x-smartling-placeholder">
</ph> Wenn eine Berechtigung erforderlich ist, erklärt die App, warum sie notwendig ist.
Abbildung 6: Informieren Sie im Kontext.

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">
</ph> Lehnt der Nutzer die Berechtigung ab, wird neben der entsprechenden Funktion ein Schloss-Symbol angezeigt.
Abbildung 7: Schloss-Symbol, das anzeigt, dass eine Funktion aus folgenden Gründen gesperrt ist: Berechtigung verweigert.

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">
</ph> Das System bietet an, keine Berechtigung mehr anzufordern.
Abbildung 8: Der Nutzer kann auf eine Berechtigungsanfrage zugreifen das zuvor zweimal über die Einstellungen abgelehnt wurde.

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">
</ph> Der Nutzer kann die Berechtigungen über die App „Einstellungen“ ändern.
Abbildung 9: Der Nutzer kann die Berechtigungen über die App „Einstellungen“ ändern.