Profils d'appareils associés

Le profil d'appareil associé, introduit dans Android 12, est une fonctionnalité qui permet aux applications associées de demander un ensemble d'autorisations Le type d'appareil associé (une montre connectée, par exemple) Utilisation d'une annonce associée profil d'appareil simplifie le processus d'enregistrement en permettant aux applications d'afficher une requête unique aux utilisateurs sur leurs appareils mobiles pour demander un ensemble défini de des autorisations au lieu de plusieurs invites demandant des autorisations individuellement. Cela peut simplifier la configuration et améliorer les taux d'activation. pour les applications associées.

Pour que vous puissiez utiliser des profils d'appareils associés, les applications associées doivent répondre aux critères suivants configuration requise:

  • gérer un appareil associé (par exemple, une montre connectée) ;
  • disposer de fonctionnalités d'application ou appeler des API Android nécessitant toutes les autorisations définies pour le profil de l'appareil associé.

Chaque profil d'appareil associé correspond à un rôle Android. Pour plus des informations sur les autorisations et le rôle Android correspondant de chaque consultez l'article Profils d'appareils associés pour les applications tierces.

Pour en savoir plus sur les appareils associés, consultez Association d'un appareil associé

Comportement de l'appareil

Cette section décrit le comportement des appareils lorsque des profils associés sont utilisés.

Lorsqu'un utilisateur accepte la demande de création d'une association par une application associée à une annonce associée appareil, le CompanionDeviceManager (CDM) attribue le rôle de profil d'appareil (par exemple, montre) au compagnon et accorder toutes les autorisations définies pour le rôle de profil spécifié. La figure 1 montre l'exemple d'une application demandant des autorisations pour COMPANION_DEVICE_WATCH profil de l'appareil.

Invite de la boîte de dialogue du profil de l'appareil de la montre

Figure 1 : Boîte de dialogue demandant des autorisations pour le profil de la montre.

Lorsqu'un utilisateur efface les données du package dans les paramètres ou les supprime appareils dans l'application associée, le CDM révoque le profil L'application ne s'exécute pas ou n'a pas de premier plan service en cours d'exécution. Si vous révoquez le profil, tous les éléments autorisations pour le profil.

Une fois qu'un utilisateur accepte la demande d'autorisation d'une application profil sur l'appareil, l'utilisateur peut révoquer les autorisations qui lui ont été accordées. Lorsqu'une autorisation est révoquée par un utilisateur, l'application reste associée au mais certaines fonctionnalités risquent de ne plus être disponibles. Si le est nécessaire au fonctionnement de l'application, celle-ci doit demander l'autorisation l'autorisation par le biais d'une demande d'autorisation.

Profils d'appareils associés pour les applications tierces

Regarder le profil

Le profil de montre est introduit dans Android 12.

Le tableau suivant décrit les autorisations définies pour COMPANION_DEVICE_WATCH profil d'appareil et les conditions requises pour les utiliser.

Autorisations Configuration requise pour l'application associée et l'appareil
Notifications

BIND_NOTIFICATION_LISTENER_SERVICE
  • être un appareil connecté via le Bluetooth et/ou le Wi-Fi ;
  • dispose d'un écran capable d'afficher des notifications (les appareils qui utilisent les retours haptiques au lieu d'un écran sont exclus.)
  • Propose une expérience de notification visible par l'utilisateur, par exemple en affichant les notifications du téléphone sur l'écran de l'appareil associé.
Phone
  • être un appareil connecté via le Bluetooth et/ou le Wi-Fi ;
  • Dispose d'un micro et d'un haut-parleur intégrés qui permettent d'engager des conversations vocales
  • Dispose d'un écran qui affiche les informations sur l'appelant
  • Propose une expérience d'appel téléphonique visible par l'utilisateur (l'application associée ponte les appels téléphoniques)
SMS
  • être un appareil connecté via le Bluetooth et/ou le Wi-Fi ;
  • Dispose d'un écran qui affiche les SMS
  • Proposez une expérience SMS aux utilisateurs
Contacts
  • être un appareil connecté via le Bluetooth et/ou le Wi-Fi ;
  • Dispose d'un écran
  • Utilisation des coordonnées dans le cadre des appels ou des messages
Calendar
  • être un appareil connecté via le Bluetooth et/ou le Wi-Fi ;
  • Dispose d'un écran
  • Proposer aux utilisateurs une expérience d'agenda sur la montre
Nearby devices
  • être un appareil connecté via le Bluetooth et/ou le Wi-Fi ;
  • Dispose d'un écran
  • Offrir à l'utilisateur une expérience d'association et de connexion sur la montre
eSIM provisioning
  • être un appareil connecté via le Bluetooth et/ou le Wi-Fi ;
  • Dispose d'un écran
  • Proposer aux utilisateurs une expérience qui gère les services de l'abonné de l'opérateur sur la montre
Managing ongoing calls
  • être un appareil connecté via le Bluetooth et/ou le Wi-Fi ;
  • Dispose d'un micro et d'un haut-parleur intégrés qui permettent d'engager des conversations vocales
  • Dispose d'un écran qui affiche les informations sur l'appelant
  • Propose une expérience d'appel téléphonique visible par l'utilisateur (l'application associée ponte les appels téléphoniques)

Profil de lunettes

Le profil Glasses est introduit dans Android 14.

Le tableau suivant décrit les autorisations définies pour COMPANION_DEVICE_GLASSES profil d'appareil et les conditions requises pour les utiliser.

Autorisations Configuration requise pour l'application associée et l'appareil
Notifications

BIND_NOTIFICATION_LISTENER_SERVICE

POST_NOTIFICATIONS
  • être un appareil connecté via le Bluetooth et/ou le Wi-Fi ;
  • dispose d'un écran capable d'afficher des notifications (les appareils qui utilisent les retours haptiques au lieu d'un écran sont exclus.)
  • Propose une expérience de notification visible par l'utilisateur, par exemple en affichant les notifications du téléphone sur l'écran de l'appareil associé.
  • Publie des notifications sur le téléphone à des fins de gestion des appareils, par exemple lorsqu'un appareil avec lunettes est connecté ou lorsqu'une fonctionnalité spécifique est activée.
Phone
  • être un appareil connecté via le Bluetooth et/ou le Wi-Fi ;
  • Dispose d'un micro et d'un haut-parleur intégrés qui permettent d'engager des conversations vocales
  • Dispose d'un écran qui affiche les informations sur l'appelant
  • Propose une expérience d'appel téléphonique visible par l'utilisateur (l'application associée ponte les appels téléphoniques)
SMS
  • être un appareil connecté via le Bluetooth et/ou le Wi-Fi ;
  • Dispose d'un écran qui affiche les SMS
  • Proposez une expérience SMS aux utilisateurs
Contacts
  • être un appareil connecté via le Bluetooth et/ou le Wi-Fi ;
  • Dispose d'un écran
  • Utilisation des coordonnées dans le cadre des appels ou des messages
Microphone
  • être un appareil connecté via le Bluetooth et/ou le Wi-Fi ;
  • Dispose d'un écran
  • Fournit une expérience de micro visible par l'utilisateur sur les lunettes
Nearby devices
  • être un appareil connecté via le Bluetooth et/ou le Wi-Fi ;
  • Dispose d'un écran
  • Offre une expérience d'association et de connexion des lunettes visible par l'utilisateur
Managing ongoing calls
  • être un appareil connecté via le Bluetooth et/ou le Wi-Fi ;
  • Dispose d'un micro et d'un haut-parleur intégrés qui permettent d'engager des conversations vocales
  • Dispose d'un écran qui affiche les informations sur l'appelant
  • Propose une expérience d'appel téléphonique visible par l'utilisateur (l'application associée ponte les appels téléphoniques)

Implémentation

Pour les développeurs tiers qui implémentent une application associée qui demande le DEVICE_PROFILE_WATCH profil, procédez comme suit:

  1. Appelez la méthode setDeviceProfile.

  2. Transmettez un profil (par exemple, DEVICE_PROFILE_WATCH lors de la création AssociationRequest

Pour les fabricants d'appareils qui implémentent une application associée avec une utilisez les configurations système Android requises suivantes pour certifier L'application associée, qui permet d'ignorer l'affichage du consentement de l'utilisateur pour les utilisateurs.

  1. Récupérez le certificat à l'aide de la commande suivante:

    keytool  -printcert -jarfile PATH/TO/APK

  2. Remplacez le nom du package et le certificat comme indiqué ci-dessous. exemple d'entrée dans le fichier de configuration:

    <!-- 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. Utilisez AssociationRequest pour envoyer une demande d'association à un seul appareil associé.

Validation

Pour tester le comportement de la fonctionnalité de profil d'appareil associé, utilisez l'outil CTS. tests dans cts/tests/tests/companion/