Begleitgeräteprofile

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.

Sehen Sie sich die Dialogaufforderung zum Geräteprofil an

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
Benachrichtigungen

BIND_NOTIFICATION_LISTENER_SERVICE
  • Seien Sie ein über Bluetooth und/oder WLAN verbundenes Gerät
  • Verfügt über einen Bildschirm, der Benachrichtigungen anzeigen kann (ausgenommen sind Geräte, die Haptik anstelle eines Bildschirms verwenden)
  • Bietet eine benutzerorientierte Benachrichtigungserfahrung, z. B. die Anzeige von Telefonbenachrichtigungen auf dem Bildschirm des Begleitgeräts.
Phone
  • Seien Sie ein über Bluetooth und/oder WLAN verbundenes Gerät
  • Verfügt über ein eingebautes Mikrofon und einen Lautsprecher, die Sprachgespräche ermöglichen
  • Verfügt über einen Bildschirm, auf dem Anruferinformationen angezeigt werden
  • Bietet ein benutzerorientiertes Telefonanruferlebnis (die Begleit-App überbrückt Telefonanrufe)
SMS
  • Seien Sie ein über Bluetooth und/oder WLAN verbundenes Gerät
  • Verfügt über einen Bildschirm, auf dem SMS-Nachrichten angezeigt werden
  • Bieten Sie ein benutzerorientiertes SMS-Erlebnis
Contacts
  • Seien Sie ein über Bluetooth und/oder WLAN verbundenes Gerät
  • Verfügt über einen Bildschirm
  • Verwendet Kontaktinformationen als Teil des Anruf- oder Nachrichtenerlebnisses
Calendar
  • Seien Sie ein über Bluetooth und/oder WLAN verbundenes Gerät
  • Verfügt über einen Bildschirm
  • Bieten Sie ein benutzerorientiertes Kalendererlebnis auf der Uhr
Nearby devices
  • Seien Sie ein über Bluetooth und/oder WLAN verbundenes Gerät
  • Verfügt über einen Bildschirm
  • Bieten Sie ein benutzerorientiertes Pairing-/Verbindungserlebnis auf der Uhr
eSIM provisioning
  • Seien Sie ein über Bluetooth und/oder WLAN verbundenes Gerät
  • Verfügt über einen Bildschirm
  • Bieten Sie ein benutzerorientiertes Erlebnis, das die Dienste des Abonnenten über den Mobilfunkanbieter auf der Uhr verwaltet
Managing ongoing calls
  • Seien Sie ein über Bluetooth und/oder WLAN verbundenes Gerät
  • Verfügt über ein eingebautes Mikrofon und einen Lautsprecher, die Sprachgespräche ermöglichen
  • Verfügt über einen Bildschirm, auf dem Anruferinformationen angezeigt werden
  • Bietet ein benutzerorientiertes Telefonanruferlebnis (die Begleit-App überbrückt Telefonanrufe)

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
Benachrichtigungen

BIND_NOTIFICATION_LISTENER_SERVICE

POST_NOTIFICATIONS
  • Seien Sie ein über Bluetooth und/oder WLAN verbundenes Gerät
  • Verfügt über einen Bildschirm, der Benachrichtigungen anzeigen kann (ausgenommen sind Geräte, die Haptik anstelle eines Bildschirms verwenden)
  • Bietet eine benutzerorientierte Benachrichtigungserfahrung, z. B. die Anzeige von Telefonbenachrichtigungen auf dem Bildschirm des Begleitgeräts.
  • Veröffentlicht Telefonbenachrichtigungen zur Geräteverwaltung, beispielsweise wenn eine Brille angeschlossen ist oder eine bestimmte Funktion aktiviert ist.
Phone
  • Seien Sie ein über Bluetooth und/oder WLAN verbundenes Gerät
  • Verfügt über ein eingebautes Mikrofon und einen Lautsprecher, die Sprachgespräche ermöglichen
  • Verfügt über einen Bildschirm, auf dem Anruferinformationen angezeigt werden
  • Bietet ein benutzerorientiertes Telefonanruferlebnis (die Begleit-App überbrückt Telefonanrufe)
SMS
  • Seien Sie ein über Bluetooth und/oder WLAN verbundenes Gerät
  • Verfügt über einen Bildschirm, auf dem SMS-Nachrichten angezeigt werden
  • Bieten Sie ein benutzerorientiertes SMS-Erlebnis
Contacts
  • Seien Sie ein über Bluetooth und/oder WLAN verbundenes Gerät
  • Verfügt über einen Bildschirm
  • Verwendet Kontaktinformationen als Teil des Anruf- oder Nachrichtenerlebnisses
Microphone
  • Seien Sie ein über Bluetooth und/oder WLAN verbundenes Gerät
  • Verfügt über einen Bildschirm
  • Bietet ein dem Benutzer zugewandtes Mikrofonerlebnis auf der Brille
Nearby devices
  • Seien Sie ein über Bluetooth und/oder WLAN verbundenes Gerät
  • Verfügt über einen Bildschirm
  • Bietet ein dem Benutzer zugewandtes Pairing-/Verbindungserlebnis auf der Brille
Managing ongoing calls
  • Seien Sie ein über Bluetooth und/oder WLAN verbundenes Gerät
  • Verfügt über ein eingebautes Mikrofon und einen Lautsprecher, die Sprachgespräche ermöglichen
  • Verfügt über einen Bildschirm, auf dem Anruferinformationen angezeigt werden
  • Bietet ein benutzerorientiertes Telefonanruferlebnis (die Begleit-App überbrückt Telefonanrufe)

Implementierung

Gehen Sie für Drittentwickler, die eine Begleit-App implementieren, die das DEVICE_PROFILE_WATCH -Profil anfordert, wie folgt vor:

  1. Rufen Sie die setDeviceProfile -Methode auf.

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

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.

  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 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>
    
  3. 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/ .