Das in Android 12 eingeführte Begleitgeräteprofil ist eine Funktion, die es Begleit-Apps ermöglicht, eine Reihe von Berechtigungen anzufordern, die für den Typ des Begleitgeräts, beispielsweise einer Smartwatch, spezifisch sind. Die Verwendung eines Begleitgeräteprofils vereinfacht den Registrierungsprozess, indem Apps den Benutzern auf ihren Mobilgeräten eine einzige Aufforderung anzeigen können, um einen definierten Satz von Berechtigungen anzufordern, anstatt mehrere Aufforderungen, bei denen Berechtigungen einzeln angefordert werden. Dies kann eine effizientere Einrichtung und bessere Opt-in-Raten für Begleit-Apps ermöglichen.
Um Begleitgeräteprofile verwenden zu können, müssen Begleit-Apps die folgenden Anforderungen erfüllen:
- Verwalten Sie ein Begleitgerät (z. B. eine Smartwatch).
- Verfügen Sie über App-Funktionen oder rufen Sie Android-APIs auf, die alle für das Begleitgeräteprofil definierten Berechtigungen erfordern.
Jedes Begleitgeräteprofil entspricht einer Android-Rolle. Weitere Informationen zu den Berechtigungen und der entsprechenden Android-Rolle jedes Profils finden Sie unter Begleitgeräteprofile für Drittanbieter-Apps .
Weitere Informationen zu Begleitgeräten finden Sie unter Kopplung von Begleitgeräten .
Geräteverhalten
In diesem Abschnitt wird das Geräteverhalten beschrieben, wenn Begleitgeräteprofile verwendet werden.
Wenn ein Benutzer die Anfrage einer App zum Erstellen einer Zuordnung zu einem Begleitgerät akzeptiert, weist der CompanionDeviceManager
(CDM)-Dienst der Begleit-App die Geräteprofilrolle (z. B. Beobachten) zu und gewährt alle für diese angegebene Profilrolle definierten Berechtigungen. Abbildung 1 zeigt ein Beispiel einer App, die Berechtigungen für das Geräteprofil COMPANION_DEVICE_WATCH
anfordert.
Abbildung 1. Dialogfeld zum Anfordern von Berechtigungen für das Watch-Geräteprofil.
Wenn ein Benutzer die Paketdaten in den Einstellungen löscht oder alle Geräte in der Begleit-App entfernt, widerruft CDM das Profil, solange die App nicht im Vordergrund ausgeführt wird und kein Vordergrunddienst ausgeführt wird. Durch das Widerrufen des Profils werden auch alle definierten Berechtigungen für das Profil widerrufen.
Nachdem ein Benutzer die Anfrage einer App zur Erteilung von Berechtigungen für ein bestimmtes Geräteprofil akzeptiert hat, kann der Benutzer einzelne gewährte Berechtigungen widerrufen. Wenn ein Benutzer eine Berechtigung widerruft, bleibt die App mit dem Begleitgerät verknüpft, bestimmte Funktionen sind jedoch möglicherweise nicht mehr verfügbar. Wenn die Berechtigung für die Funktion der App erforderlich ist, muss die App die Berechtigung über eine normale Berechtigungsanfrage anfordern.
Begleitgeräteprofile für Apps von Drittanbietern
Profil ansehen
Das Uhrenprofil wird in Android 12 eingeführt.
In der folgenden Tabelle werden die definierten Berechtigungen für das Geräteprofil COMPANION_DEVICE_WATCH
und die Anforderungen für deren Verwendung beschrieben.
Berechtigungen | Anforderungen an Begleit-App und Geräte |
---|---|
BenachrichtigungenBIND_NOTIFICATION_LISTENER_SERVICE |
|
Phone |
|
SMS |
|
Contacts |
|
Calendar |
|
Nearby devices |
|
eSIM provisioning |
|
Managing ongoing calls |
|
Brillenprofil
Das Brillenprofil wird in Android 14 eingeführt.
In der folgenden Tabelle werden die definierten Berechtigungen für das Geräteprofil COMPANION_DEVICE_GLASSES
und die Anforderungen für deren Verwendung beschrieben.
Berechtigungen | Anforderungen an Begleit-App und Geräte |
---|---|
BenachrichtigungenBIND_NOTIFICATION_LISTENER_SERVICE POST_NOTIFICATIONS |
|
Phone |
|
SMS |
|
Contacts |
|
Microphone |
|
Nearby devices |
|
Managing ongoing calls |
|
Implementierung
Gehen Sie für Drittentwickler, die eine Begleit-App implementieren, die das DEVICE_PROFILE_WATCH
-Profil anfordert, wie folgt vor:
Rufen Sie die
setDeviceProfile
-Methode auf.Übergeben Sie ein Profil (z. B.
DEVICE_PROFILE_WATCH
beim ErstellenAssociationRequest
.
Gerätehersteller überspringen die Anzeige des Benutzereinwilligungsdialogs
Für Gerätehersteller, die eine Begleit-App mit einem bestimmten Gerät implementieren, verwenden Sie die folgenden erforderlichen Android-Systemkonfigurationen, um die Begleit-App zu zertifizieren, wodurch die App die Anzeige des Benutzereinwilligungsdialogs für Benutzer überspringen kann.
Rufen Sie das Zertifikat mit dem folgenden Befehl ab:
keytool -printcert -jarfile PATH/TO/APK
Ersetzen Sie den Paketnamen und das Zertifikat wie in der folgenden Beispieleingabe in der Konfigurationsdatei gezeigt:
<!-- A list of packages managing companion device(s) by the same manufacturers as the main device. It will not create the association without prompting if the association has been called multiple times in a short period. Note that config_companionDeviceManagerPackage and config_companionDeviceCerts are parallel arrays. --> <string-array name="config_companionDevicePackages" translatable="false"> <item>YOUR_COMPANION_APP_PACKAGE_NAME</item> </string-array> <!-- A list of SHA256 Certificates managing companion device(s) by the same manufacturers as the main device. It will fall back to showing a prompt if the association has been called multiple times in a short period. Note that config_companionDeviceCerts and config_companionDeviceManagerPackage are parallel arrays. Example: "1A:2B:3C:4D" --> <string-array name="config_companionDeviceCerts" translatable="false"> <item>YOUR_COMPANION_APP_CERTIFICATE</item> </string-array>
Verwenden Sie
AssociationRequest
um eine Zuordnungsanfrage an ein einzelnes Begleitgerät zu stellen.
Validierung
Um das Verhalten der Profilfunktion des Begleitgeräts zu testen, verwenden Sie die CTS-Tests in cts/tests/tests/companion/
.