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 spécifiques au type d'appareil associé, par exemple une montre connectée. L'utilisation d'un profil d'appareil associé simplifie le processus d'enregistrement en permettant aux applications d'afficher une seule invite sur leurs appareils mobiles pour demander un ensemble défini d'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 utiliser des profils d'appareils associés, les applications associées doivent répondre aux exigences suivantes:

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

Chaque profil d'appareil compagnon correspond à un rôle Android. Pour en savoir plus sur les autorisations et le rôle Android correspondant de chaque profil, consultez Profils d'appareils associés pour les applications tierces.

Pour en savoir plus sur les appareils associés, consultez la section Association d'appareils associés.

Comportement de l'appareil

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

Lorsqu'un utilisateur accepte la demande d'une application de créer une association avec un appareil associé, le service CompanionDeviceManager (CDM) attribue le rôle de profil de l'appareil (par exemple, montre) à l'application associée, en accordant toutes les autorisations définies pour ce rôle de profil spécifié. La figure 1 montre un exemple d'application demandant des autorisations pour le profil de l'appareil COMPANION_DEVICE_WATCH.

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 supprime tous les appareils de l'application associée, CDM révoque le profil tant que l'application n'est pas exécutée au premier plan et qu'aucun service de premier plan n'est en cours d'exécution. La révocation du profil entraîne également la révocation de toutes les autorisations définies pour le profil.

Une fois qu'un utilisateur a accepté la demande d'une application d'accorder des autorisations pour un profil d'appareil particulier, il peut révoquer les autorisations individuelles qui ont été accordées. Lorsqu'une autorisation est révoquée par un utilisateur, l'application reste associée à l'appareil compagnon, mais certaines fonctionnalités peuvent devenir indisponibles. Si l'autorisation est requise pour le fonctionnement de l'application, celle-ci doit la demander via une demande d'autorisation normale.

Profils d'appareils associés pour les applications tierces

Profil de la montre

Le profil de montre est introduit dans Android 12.

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

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

POST_NOTIFICATIONS (added in Android 15)
  • être un appareil connecté via le Bluetooth et/ou le Wi-Fi ;
  • Possède un écran capable d'afficher des notifications (les appareils qui utilisent la technologie haptique au lieu d'un écran sont exclus)
  • Fournit une expérience de notification destinée à l'utilisateur, par exemple en affichant les notifications du téléphone sur l'écran de l'appareil associé.
  • Envoie des notifications sur le téléphone pour la gestion des appareils. Par exemple, lorsqu'une montre est connectée ou qu'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 pour les conversations vocales
  • Dispose d'un écran qui affiche les informations sur l'appelant
  • Fournit une expérience d'appel téléphonique destinée à l'utilisateur (l'application associée assure la liaison des appels téléphoniques)
SMS
  • être un appareil connecté via le Bluetooth et/ou le Wi-Fi ;
  • dispose d'un écran affichant des 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
  • Utilise les coordonnées des contacts dans le cadre de l'expérience d'appel ou de messagerie
Calendar
  • être un appareil connecté via le Bluetooth et/ou le Wi-Fi ;
  • est équipé d'un écran d'affichage ;
  • Proposer une expérience utilisateur de l'agenda sur la montre
Nearby devices
  • être un appareil connecté via le Bluetooth et/ou le Wi-Fi ;
  • est équipé d'un écran d'affichage ;
  • Proposer une expérience d'association/connexion à l'utilisateur sur la montre
eSIM provisioning
  • être un appareil connecté via le Bluetooth et/ou le Wi-Fi ;
  • est équipé d'un écran d'affichage ;
  • Proposer à l'utilisateur une expérience qui gère les services de l'abonné auprès 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 pour les conversations vocales
  • Dispose d'un écran qui affiche les informations sur l'appelant
  • Fournit une expérience d'appel téléphonique destinée à l'utilisateur (l'application associée assure la liaison des appels téléphoniques)

Profil des lunettes

Le profil Lunettes est introduit dans Android 14.

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

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

POST_NOTIFICATIONS
  • être un appareil connecté via le Bluetooth et/ou le Wi-Fi ;
  • Possède un écran capable d'afficher des notifications (les appareils qui utilisent la technologie haptique au lieu d'un écran sont exclus)
  • Fournit une expérience de notification destinée à 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 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 pour les conversations vocales
  • Dispose d'un écran qui affiche les informations sur l'appelant
  • Fournit une expérience d'appel téléphonique destinée à l'utilisateur (l'application associée assure la liaison des appels téléphoniques)
SMS
  • être un appareil connecté via le Bluetooth et/ou le Wi-Fi ;
  • dispose d'un écran affichant des 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
  • Utilise les coordonnées des contacts dans le cadre de l'expérience d'appel ou de messagerie
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 ;
  • est équipé d'un écran d'affichage ;
  • Fournit une expérience d'association/connexion destinée à l'utilisateur sur les lunettes
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 pour les conversations vocales
  • Dispose d'un écran qui affiche les informations sur l'appelant
  • Fournit une expérience d'appel téléphonique destinée à l'utilisateur (l'application associée assure la liaison des appels téléphoniques)

Implémentation

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

  1. Appelez la méthode setDeviceProfile.

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

Pour les fabricants d'appareils qui implémentent une application associée avec un appareil spécifique, utilisez les configurations système Android requises suivantes pour certifier l'application associée, ce qui permet à l'application d'ignorer l'affichage de la boîte de dialogue de consentement de l'utilisateur.

  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é dans l'exemple d'entrée suivant 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 les tests CTS dans cts/tests/tests/companion/.