Il profilo del dispositivo complementare, introdotto in Android 12, è una funzionalità che consente alle app complementari di richiedere un insieme di autorizzazioni specifiche per il tipo di dispositivo complementare, ad esempio uno smartwatch. L'utilizzo di un profilo del dispositivo complementare semplifica la procedura di registrazione consentendo alle app di mostrare un singolo prompt agli utenti sui loro dispositivi mobili per richiedere un insieme definito di autorizzazioni anziché più prompt che richiedono le autorizzazioni singolarmente. In questo modo, puoi usufruire di un'esperienza di configurazione più snella e di tassi di attivazione migliori per le app complementari.
Per utilizzare i profili del dispositivo complementare, le app complementari devono soddisfare i seguenti requisiti:
- Gestire un dispositivo complementare (ad esempio uno smartwatch).
- Avere 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 sulle autorizzazioni e sul ruolo Android corrispondente di ogni profilo, vedi Profili dispositivo companion per app di terze parti.
Per ulteriori informazioni sui dispositivi complementari, consulta Associazione di dispositivi complementari.
Comportamento del dispositivo
Questa sezione descrive il comportamento del dispositivo quando vengono utilizzati i profili dei dispositivi complementari.
Quando un utente accetta la richiesta di un'app di creare un'associazione con un dispositivo companion, il servizio CompanionDeviceManager (CDM) assegna il ruolo del profilo del dispositivo (ad esempio, smartwatch) all'app companion, concedendo tutte le autorizzazioni definite per quel ruolo del profilo specificato.
La Figura 1 mostra un esempio di app che richiede autorizzazioni per il profilo del dispositivo COMPANION_DEVICE_WATCH.
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 rimuove tutti i dispositivi nell'app complementare, CDM revoca il profilo mentre l'app non è in esecuzione in primo piano o ha un servizio in primo piano in esecuzione. La revoca del profilo comporta anche la revoca di tutte le autorizzazioni definite per il profilo.
Dopo che un utente accetta la richiesta di un'app di concedere le 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 companion, ma alcune funzionalità potrebbero non essere più disponibili. Se è necessaria l'autorizzazione per il funzionamento dell'app, l'app deve richiederla tramite una normale richiesta di autorizzazione.
Profili dispositivo companion per app di terze parti
Profilo dell'orologio
Il profilo dell'orologio viene introdotto in Android 12.
La tabella seguente descrive le autorizzazioni definite per il profilo del dispositivo COMPANION_DEVICE_WATCH e i requisiti per utilizzarle.
| Autorizzazioni | Requisiti dell'app complementare e del dispositivo |
|---|---|
Notifiche
POST_NOTIFICATIONS (added in Android 15) |
|
Phone |
|
SMS |
|
Contacts |
|
Calendar |
|
Nearby devices |
|
eSIM provisioning |
|
Managing ongoing calls |
|
Profilo occhiali
Il profilo Glasses viene introdotto in Android 14.
La seguente tabella descrive le autorizzazioni definite per il profilo del dispositivo COMPANION_DEVICE_GLASSES e i requisiti per il relativo utilizzo.
| Autorizzazioni | Requisiti dell'app complementare e del dispositivo |
|---|---|
NotifichePOST_NOTIFICATIONS |
|
Phone |
|
SMS |
|
Contacts |
|
Microphone |
|
Nearby devices |
|
Managing ongoing calls |
|
Implementazione
Gli sviluppatori di terze parti che implementano un'app complementare che richiede il profilo
DEVICE_PROFILE_WATCH
devono procedere nel seguente modo:
Chiama il metodo
setDeviceProfile.Trasmetti un profilo (ad esempio,
DEVICE_PROFILE_WATCHdurante la creazione diAssociationRequest).
I produttori di dispositivi possono saltare la visualizzazione della finestra di dialogo per il consenso dell'utente
I produttori di dispositivi che implementano un'app complementare con un dispositivo specifico devono utilizzare le seguenti configurazioni di sistema Android obbligatorie per certificare l'app complementare, che consente all'app di saltare la visualizzazione della finestra di dialogo per il consenso degli utenti.
Recupera il certificato utilizzando il comando seguente:
keytool -printcert -jarfile PATH/TO/APKSostituisci il nome del pacchetto e il certificato come mostrato nel seguente 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>Utilizza
AssociationRequestper inviare una richiesta di associazione a un singolo dispositivo complementare.
Convalida
Per testare il comportamento della funzionalità del profilo del dispositivo complementare, utilizza i test CTS in cts/tests/tests/companion/.