Begleitgeräteprofile

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.

Aufforderung zum Dialogfeld für das Smartwatch-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
Benachrichtigungen

BIND_NOTIFICATION_LISTENER_SERVICE

POST_NOTIFICATIONS (added in Android 15)
  • ein über Bluetooth und/oder WLAN verbundenes Gerät sein
  • Verfügt über einen Bildschirm, auf dem Benachrichtigungen angezeigt werden können (Geräte, die Haptik statt eines Bildschirms wird ausgeschlossen.)
  • Bietet Nutzern eine Benachrichtigung, z. B. Smartphone-Benachrichtigungen auf dem Bildschirm des Begleitgeräts angezeigt.
  • Veröffentliche Smartphone-Benachrichtigungen zur Geräteverwaltung. Zum Beispiel, wenn eine Smartwatch verbunden ist oder eine bestimmte Funktion aktiviert ist.
Phone
  • ein über Bluetooth und/oder WLAN verbundenes Gerät sein
  • Das Gerät verfügt über ein integriertes Mikrofon und einen Lautsprecher, die eine Sprachunterhaltung ermöglichen.
  • Hat ein Display, auf dem Anruferinformationen angezeigt werden
  • Bietet dem Nutzer eine für den Nutzer sichtbare Anruffunktion (die Companion-App) Bridges Telefonanrufe)
SMS
  • ein über Bluetooth und/oder WLAN verbundenes Gerät sein
  • einen Bildschirm hat, auf dem SMS angezeigt werden.
  • Bieten Sie den Nutzern die Möglichkeit, SMS zu senden.
Contacts
  • ein über Bluetooth und/oder WLAN verbundenes Gerät sein
  • Hat einen Bildschirm
  • Nutzt Kontaktdaten im Rahmen von Anrufen oder Nachrichten
Calendar
  • ein über Bluetooth und/oder WLAN verbundenes Gerät sein
  • Hat einen Bildschirm
  • Dem Nutzer einen Kalender auf der Uhr anzeigen
Nearby devices
  • ein über Bluetooth und/oder WLAN verbundenes Gerät sein
  • Hat einen Bildschirm
  • Dem Benutzer eine Kopplungs-/Verbindungsmöglichkeit auf der Uhr bieten
eSIM provisioning
  • ein über Bluetooth und/oder WLAN verbundenes Gerät sein
  • Hat einen Bildschirm
  • Bieten Sie eine nutzerfreundliche Umgebung, bei der die Dienste des Abonnenten verwaltet werden. vom Mobilfunkanbieter auf der Smartwatch
Managing ongoing calls
  • ein über Bluetooth und/oder WLAN verbundenes Gerät sein
  • Das Gerät verfügt über ein integriertes Mikrofon und einen Lautsprecher, die eine Sprachunterhaltung ermöglichen.
  • Hat ein Display, auf dem Anruferinformationen angezeigt werden
  • Bietet dem Nutzer eine für den Nutzer sichtbare Anruffunktion (die Companion-App) Bridges Telefonanrufe)

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
Benachrichtigungen

BIND_NOTIFICATION_LISTENER_SERVICE

POST_NOTIFICATIONS
  • ein über Bluetooth und/oder WLAN verbundenes Gerät sein
  • Verfügt über einen Bildschirm, auf dem Benachrichtigungen angezeigt werden können (Geräte, die Haptik statt eines Bildschirms wird ausgeschlossen.)
  • Bietet Nutzern eine Benachrichtigung, z. B. Smartphone-Benachrichtigungen auf dem Bildschirm des Begleitgeräts angezeigt.
  • Postt Smartphone-Benachrichtigungen zur Geräteverwaltung, z. B. wenn eine Brille verbunden oder eine bestimmte Funktion aktiviert ist.
Phone
  • ein über Bluetooth und/oder WLAN verbundenes Gerät sein
  • Das Gerät verfügt über ein integriertes Mikrofon und einen Lautsprecher, die eine Sprachunterhaltung ermöglichen.
  • Hat ein Display, auf dem Anruferinformationen angezeigt werden
  • Bietet dem Nutzer eine für den Nutzer sichtbare Anruffunktion (die Companion-App) Bridges Telefonanrufe)
SMS
  • ein über Bluetooth und/oder WLAN verbundenes Gerät sein
  • einen Bildschirm hat, auf dem SMS angezeigt werden.
  • Bieten Sie den Nutzern die Möglichkeit, SMS zu senden.
Contacts
  • ein über Bluetooth und/oder WLAN verbundenes Gerät sein
  • Hat einen Bildschirm
  • Nutzt Kontaktdaten im Rahmen von Anrufen oder Nachrichten
Microphone
  • ein über Bluetooth und/oder WLAN verbundenes Gerät sein
  • Hat einen Bildschirm
  • Bietet dem Nutzer die Verwendung des Mikrofons an der Brille
Nearby devices
  • ein über Bluetooth und/oder WLAN verbundenes Gerät sein
  • Hat einen Bildschirm
  • Ermöglicht dem Nutzer das Koppeln/Verbinden mit der Brille
Managing ongoing calls
  • ein über Bluetooth und/oder WLAN verbundenes Gerät sein
  • Das Gerät verfügt über ein integriertes Mikrofon und einen Lautsprecher, die eine Sprachunterhaltung ermöglichen.
  • Hat ein Display, auf dem Anruferinformationen angezeigt werden
  • Bietet dem Nutzer eine für den Nutzer sichtbare Anruffunktion (die Companion-App) Bridges Telefonanrufe)

Implementierung

Für Drittanbieter-Entwickler, die eine Companion-App implementieren, die das DEVICE_PROFILE_WATCH Profil enthält, gehen Sie so vor:

  1. Rufen Sie die Methode setDeviceProfile .

  2. Übergeben Sie ein Profil (z. B. DEVICE_PROFILE_WATCH beim Erstellen AssociationRequest

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.

  1. Rufen Sie das Zertifikat mit dem folgenden Befehl ab:

    keytool  -printcert -jarfile PATH/TO/APK
    
  2. 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>
    
  3. 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/