Profili dei dispositivi complementari

Il profilo del dispositivo companion, introdotto in Android 12, è che consente alle app companion di richiedere una serie di autorizzazioni specifiche per: il tipo di dispositivo associato, ad esempio uno smartwatch. Utilizzo di una creatività companion Il profilo del dispositivo semplifica il processo di registrazione consentendo alle app di visualizzare agli utenti sui loro dispositivi mobili di richiedere un insieme definito autorizzazioni invece di più prompt che richiedono le autorizzazioni singolarmente. Ciò può consentire un'esperienza di configurazione più semplice e tassi di attivazione migliori. per le app complementari.

Per utilizzare i profili dei dispositivi associati, le app complementari devono: requisiti:

• Gestire un dispositivo associato (ad esempio uno smartwatch).
• Disporre di funzionalità dell'app o chiamare API Android che richiedono tutte le autorizzazioni definite per il profilo del dispositivo associato.

Ogni profilo del dispositivo associato corrisponde a un ruolo Android. Per ulteriori informazioni informazioni sulle autorizzazioni e sul ruolo Android corrispondente di ogni profilo, consulta l'articolo Profili dei dispositivi companion per le app di terze parti.

Per ulteriori informazioni sui dispositivi associati, vedi Accoppiamento dispositivo companion.

Comportamento dispositivo

Questa sezione descrive il comportamento del dispositivo quando vengono utilizzati profili di dispositivi associati.

Quando un utente accetta la richiesta di un'app di creare un'associazione con una creatività companion. dispositivo, CompanionDeviceManager (CDM) assegna il ruolo di profilo del dispositivo (ad esempio, orologio) al companion concedendo tutte le autorizzazioni definite per il ruolo di profilo specificato. La figura 1 mostra un esempio di un'app che richiede autorizzazioni per COMPANION_DEVICE_WATCH profilo del dispositivo.

Figura 1. Finestra di dialogo che richiede le autorizzazioni per il profilo dello smartwatch.

Quando un utente cancella i dati del pacchetto nelle Impostazioni o li rimuove tutti dispositivi nell'app complementare, CDM revoca il profilo mentre L'app non è in esecuzione in primo piano o non è in primo piano è in esecuzione il servizio. La revoca del profilo comporta anche la revoca di tutte le definizioni le autorizzazioni per il profilo.

Dopo che un utente accetta la richiesta di un'app di concedere autorizzazioni per un determinato profilo del dispositivo, l'utente può revocare le singole autorizzazioni concesse. Quando un'autorizzazione viene revocata da un utente, l'app rimane associata al dispositivo associato, ma alcune funzionalità potrebbero non essere più disponibili. Se necessaria per il funzionamento dell'app, quest'ultima deve richiedere l'autorizzazione tramite una normale richiesta di autorizzazione.

Profili dispositivo companion per app di terze parti

Profilo dell'orologio

Il profilo dello smartwatch viene introdotto in Android 12.

La tabella seguente descrive le autorizzazioni definite per COMPANION_DEVICE_WATCH profilo del dispositivo e i requisiti per l'utilizzo.

Autorizzazioni	Requisiti dell'app complementare e del dispositivo
Notifiche BIND_NOTIFICATION_LISTENER_SERVICE POST_NOTIFICATIONS (added in Android 15)	Essere un dispositivo connesso tramite Bluetooth e/o Wi-Fi Dispone di uno schermo in grado di visualizzare notifiche (i dispositivi che utilizzano la tecnologia aptica anziché lo schermo è esclusa) Offre un'esperienza di notifica rivolta agli utenti, ad esempio mostrando notifiche dello smartphone sullo schermo del dispositivo associato. Pubblica notifiche dello smartphone per la gestione dei dispositivi. ad esempio quando un orologio è connesso o quando è attiva una funzionalità specifica.
Phone	Essere un dispositivo connesso tramite Bluetooth e/o Wi-Fi È dotato di microfono e altoparlante integrati che consentono le conversazioni vocali Ha una schermata che mostra le informazioni sul chiamante Offre un'esperienza di chiamata verso l'utente (l'app complementare collega le telefonate)
SMS	Essere un dispositivo connesso tramite Bluetooth e/o Wi-Fi Ha una schermata che mostra gli SMS Fornisci un'esperienza SMS rivolta agli utenti
Contacts	Essere un dispositivo connesso tramite Bluetooth e/o Wi-Fi Dispone di uno schermo Utilizza le informazioni di contatto nell'ambito delle chiamate o dei messaggi
Calendar	Essere un dispositivo connesso tramite Bluetooth e/o Wi-Fi Dispone di uno schermo Offri agli utenti un'esperienza di calendario sullo smartwatch
Nearby devices	Essere un dispositivo connesso tramite Bluetooth e/o Wi-Fi Dispone di uno schermo Fornisci un'esperienza di accoppiamento/connessione rivolta agli utenti sullo smartwatch
eSIM provisioning	Essere un dispositivo connesso tramite Bluetooth e/o Wi-Fi Dispone di uno schermo Offri un'esperienza rivolta agli utenti che gestisca i servizi dell'abbonato dell'operatore sullo smartwatch
Managing ongoing calls	Essere un dispositivo connesso tramite Bluetooth e/o Wi-Fi È dotato di microfono e altoparlante integrati che consentono le conversazioni vocali Ha una schermata che mostra le informazioni sul chiamante Offre un'esperienza di chiamata verso l'utente (l'app complementare collega le telefonate)

Profilo occhiali

Il profilo Occhiali viene introdotto in Android 14.

La tabella seguente descrive le autorizzazioni definite per COMPANION_DEVICE_GLASSES profilo del dispositivo e i requisiti per l'utilizzo.

Autorizzazioni	Requisiti dell'app complementare e del dispositivo
Notifiche BIND_NOTIFICATION_LISTENER_SERVICE POST_NOTIFICATIONS	Essere un dispositivo connesso tramite Bluetooth e/o Wi-Fi Dispone di uno schermo in grado di visualizzare notifiche (i dispositivi che utilizzano la tecnologia aptica anziché lo schermo è esclusa) Offre un'esperienza di notifica rivolta agli utenti, ad esempio mostrando notifiche dello smartphone sullo schermo del dispositivo associato. Pubblica notifiche sullo smartphone per la gestione dei dispositivi, ad esempio quando è connesso un dispositivo con occhiali o quando è attiva una funzionalità specifica.
Phone	Essere un dispositivo connesso tramite Bluetooth e/o Wi-Fi È dotato di microfono e altoparlante integrati che consentono le conversazioni vocali Ha una schermata che mostra le informazioni sul chiamante Offre un'esperienza di chiamata verso l'utente (l'app complementare collega le telefonate)
SMS	Essere un dispositivo connesso tramite Bluetooth e/o Wi-Fi Ha una schermata che mostra gli SMS Fornisci un'esperienza SMS rivolta agli utenti
Contacts	Essere un dispositivo connesso tramite Bluetooth e/o Wi-Fi Dispone di uno schermo Utilizza le informazioni di contatto nell'ambito delle chiamate o dei messaggi
Microphone	Essere un dispositivo connesso tramite Bluetooth e/o Wi-Fi Dispone di uno schermo Offre un'esperienza di microfono rivolta verso l'utente sugli occhiali
Nearby devices	Essere un dispositivo connesso tramite Bluetooth e/o Wi-Fi Dispone di uno schermo Fornisce un'esperienza di accoppiamento/collegamento verso l'utente sugli occhiali
Managing ongoing calls	Essere un dispositivo connesso tramite Bluetooth e/o Wi-Fi È dotato di microfono e altoparlante integrati che consentono le conversazioni vocali Ha una schermata che mostra le informazioni sul chiamante Offre un'esperienza di chiamata verso l'utente (l'app complementare collega le telefonate)

Implementazione

Per gli sviluppatori di terze parti che implementano un'app complementare che richiede DEVICE_PROFILE_WATCH profilo, procedi nel seguente modo:

1. Chiama il setDeviceProfile .

2. Trasmettere un profilo (ad esempio, DEVICE_PROFILE_WATCH durante la creazione AssociationRequest.

Il produttore del dispositivo ignora la visualizzazione della finestra di dialogo per il consenso dell'utente

Per i produttori di dispositivi che implementano un'app complementare con uno specifico dispositivo, utilizza le seguenti configurazioni di sistema Android necessarie per certificare app complementare, che consente all'app di saltare la visualizzazione del consenso dell'utente per gli utenti.

1. Recupera il certificato utilizzando il comando seguente:

   keytool  -printcert -jarfile PATH/TO/APK
   

2. Sostituisci il nome del pacchetto e il certificato come mostrato di seguito input di esempio nel file di configurazione:

   <!-- 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. Utilizza le funzionalità di AssociationRequest per effettuare una richiesta di associazione a un singolo dispositivo associato.

Convalida

Per verificare il comportamento della funzionalità di profilo del dispositivo associato, utilizza lo strumento CTS test in cts/tests/tests/companion/