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 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.
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
POST_NOTIFICATIONS (added in Android 15) |
|
Phone |
|
SMS |
|
Contacts |
|
Calendar |
|
Nearby devices |
|
eSIM provisioning |
|
Managing ongoing calls |
|
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 |
---|---|
NotificationsBIND_NOTIFICATION_LISTENER_SERVICE POST_NOTIFICATIONS |
|
Phone |
|
SMS |
|
Contacts |
|
Microphone |
|
Nearby devices |
|
Managing ongoing calls |
|
Implémentation
Pour les développeurs tiers qui implémentent une application associée qui demande
DEVICE_PROFILE_WATCH
profil, procédez comme suit:
Appelez la méthode
setDeviceProfile
.Transmettez un profil (par exemple,
DEVICE_PROFILE_WATCH
lors de la créationAssociationRequest
Fabricant de l'appareil pour ignorer l'affichage de la boîte de dialogue de recueil du consentement de l'utilisateur
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.
Récupérez le certificat à l'aide de la commande suivante:
keytool -printcert -jarfile PATH/TO/APK
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>
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/