Das mit Android 12 eingeführte Companion-Geräteprofil eine Funktion, die es Companion-Apps ermöglicht, eine Reihe von Berechtigungen anzufordern, den Typ des Begleitgeräts, z. B. eine Smartwatch. Companion verwenden wird der Registrierungsprozess vereinfacht, da Apps ein eine einzige Aufforderung an Nutzer auf ihren Mobilgeräten, statt mit mehreren Aufforderungen, die Berechtigungen einzeln anzufordern. Dies ermöglicht eine einfachere Einrichtung und bessere Opt-in-Raten. für Companion-Apps.
Damit Companion-Geräteprofile verwendet werden können, müssen Companion-Apps folgende Anforderungen erfüllen Anforderungen:
- Begleitgerät verwalten, z. B. eine Smartwatch
- Sie haben App-Funktionen oder rufen Android-APIs auf, die alle Berechtigungen, die für das Companion-Geräteprofil definiert wurden.
Jedes Companion-Geräteprofil entspricht einer Android-Rolle. Weitere Informationen Informationen zu den Berechtigungen und der entsprechenden Android-Rolle der einzelnen Nutzer Weitere Informationen zu Companion-Geräteprofilen für Drittanbieter-Apps
Weitere Informationen zu Begleitgeräten findest du unter Kopplung von Companion-Geräten
Geräteverhalten
In diesem Abschnitt wird das Geräteverhalten beschrieben, wenn Companion-Geräteprofile verwendet werden.
Wenn ein Nutzer die Anfrage einer App zum Erstellen einer Verknüpfung mit einem Companion akzeptiert
Gerät, das
CompanionDeviceManager
weist der CDM-Dienst die Geräteprofilrolle (z. B. Smartwatch) dem
Companion
App, die alle für diese Profilrolle definierten Berechtigungen gewährt.
Abbildung 1 zeigt ein Beispiel einer App, die Berechtigungen für die
COMPANION_DEVICE_WATCH
Geräteprofil.
Abbildung 1: Dialogfeld, in dem Berechtigungen für das Smartwatch-Geräteprofil angefordert werden.
Ein Nutzer löscht die Paketdaten in den Einstellungen oder entfernt alle Geräte in der Companion-App aktiviert haben, widerruft CDM das Profil, während das Die App wird nicht im Vordergrund ausgeführt und hat auch keinen Vordergrund ausgeführt wird. Durch das Widerrufen des Profils werden auch alle definierten Berechtigungen für das Profil.
Nachdem ein Nutzer die Anfrage einer App zum Erteilen von Berechtigungen für eine bestimmte Geräteprofil verwenden, kann der Nutzer einzelne Berechtigungen widerrufen, die er erteilt hat. Wenn eine Berechtigung von einem Nutzer widerrufen wird, bleibt die App mit dem Begleitgerät sein, aber bestimmte Funktionen sind möglicherweise nicht mehr verfügbar. Wenn die ist erforderlich, damit die App funktioniert, muss die App über eine normale Berechtigungsanfrage.
Profile von Companion-Geräten für Drittanbieter-Apps
Smartwatch-Profil
Das Smartwatch-Profil wird mit Android 12 eingeführt.
In der folgenden Tabelle werden die definierten Berechtigungen für den
COMPANION_DEVICE_WATCH
Geräteprofil und die Voraussetzungen für ihre Verwendung.
Berechtigungen | Companion-App und Geräteanforderungen |
---|---|
BenachrichtigungenBIND_NOTIFICATION_LISTENER_SERVICE
|
|
Phone |
|
SMS |
|
Contacts |
|
Calendar |
|
Nearby devices |
|
eSIM provisioning |
|
Managing ongoing calls |
|
Brillenprofil
Das Datenbrillenprofil wird mit Android 14 eingeführt.
In der folgenden Tabelle werden die definierten Berechtigungen für den
COMPANION_DEVICE_GLASSES
Geräteprofil und die Voraussetzungen für ihre Verwendung.
Berechtigungen | Companion-App und Geräteanforderungen |
---|---|
BenachrichtigungenBIND_NOTIFICATION_LISTENER_SERVICE POST_NOTIFICATIONS |
|
Phone |
|
SMS |
|
Contacts |
|
Microphone |
|
Nearby devices |
|
Managing ongoing calls |
|
Implementierung
Für Drittanbieter-Entwickler, die eine Companion-App implementieren, die den
DEVICE_PROFILE_WATCH
Profil enthält, gehen Sie so vor:
Rufen Sie die Methode
setDeviceProfile
.Übergeben Sie ein Profil (z. B.
DEVICE_PROFILE_WATCH
beim ErstellenAssociationRequest
Das Gerät wird gefertigt, um die Anzeige des Dialogs zur Nutzereinwilligung zu überspringen
Für Gerätehersteller, die eine Companion-App mit einem speziellen Gerät verwenden, verwenden Sie die folgenden erforderlichen Android-Systemkonfigurationen, um die Companion-App, mit der die Nutzereinwilligung übersprungen werden kann für Nutzer.
Rufen Sie das Zertifikat mit dem folgenden Befehl ab:
keytool -printcert -jarfile PATH/TO/APK
Ersetzen Sie den Paketnamen und das Zertifikat wie unten gezeigt. Beispieleingabe in die Konfigurationsdatei:
<!-- 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 Verknüpfungsanfrage an ein einzelnes Begleitgerät zu senden.
Zertifizierungsstufe
Verwenden Sie die CTS, um das Verhalten der Profilfunktion des Begleitgeräts zu testen.
Tests in
cts/tests/tests/companion/