Il profilo del dispositivo associato, introdotto in Android 12, è una funzionalità che consente alle app complementari di richiedere una serie di autorizzazioni specifiche per il tipo di dispositivo associato, ad esempio uno smartwatch. L'utilizzo di un profilo del dispositivo complementare semplifica il processo di registrazione consentendo alle app di visualizzare un'unica richiesta agli utenti sui propri dispositivi mobili per richiedere un set definito di autorizzazioni invece di più richieste che richiedono autorizzazioni singolarmente. Ciò può consentire un'esperienza di configurazione più semplificata e migliori tariffe di attivazione per le app complementari.
Per utilizzare i profili del dispositivo complementare, le app complementari devono soddisfare i seguenti requisiti:
- Gestisci un dispositivo complementare (ad esempio uno smartwatch).
- Disporre di funzionalità dell'app o chiamare API Android che richiedono tutte le autorizzazioni definite per il profilo del dispositivo complementare.
Ogni profilo del dispositivo associato corrisponde a un ruolo Android. Per ulteriori informazioni sulle autorizzazioni e sul ruolo Android corrispondente di ciascun profilo, consulta Profili dei dispositivi complementari per app di terze parti .
Per ulteriori informazioni sui dispositivi associati, vedere Associazione dei dispositivi associati .
Comportamento del dispositivo
Questa sezione descrive il comportamento del dispositivo quando vengono utilizzati i profili del dispositivo complementare.
Quando un utente accetta la richiesta di un'app di creare un'associazione con un dispositivo complementare, il servizio CompanionDeviceManager
(CDM) assegna il ruolo del profilo del dispositivo (ad esempio, orologio) all'app complementare, concedendo tutte le autorizzazioni definite per quel ruolo del profilo specificato. La Figura 1 mostra un esempio di un'app che richiede autorizzazioni per il profilo del dispositivo COMPANION_DEVICE_WATCH
.
Figura 1. Finestra di dialogo che richiede le autorizzazioni per il profilo del dispositivo di controllo.
Quando un utente cancella i dati del pacchetto in Impostazioni o rimuove tutti i dispositivi nell'app complementare, CDM revoca il profilo mentre l'app non è in esecuzione in primo piano né è in esecuzione un servizio in primo piano. La revoca del profilo revoca anche tutte le autorizzazioni definite per il profilo.
Dopo che un utente accetta la richiesta di un'app di concedere autorizzazioni per un particolare 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 complementare ma alcune funzionalità potrebbero non essere più disponibili. Se l'autorizzazione è necessaria per il funzionamento dell'app, l'app deve richiedere l'autorizzazione tramite una normale richiesta di autorizzazione .
Profili del dispositivo complementare per app di terze parti
Guarda il profilo
Il profilo 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 il loro utilizzo.
Autorizzazioni | Requisiti dell'app complementare e del dispositivo |
---|---|
NotificheBIND_NOTIFICATION_LISTENER_SERVICE |
|
Phone |
|
SMS |
|
Contacts |
|
Calendar |
|
Nearby devices |
|
eSIM provisioning |
|
Managing ongoing calls |
|
Profilo degli occhiali
Il profilo Occhiali viene introdotto in Android 14.
La tabella seguente descrive le autorizzazioni definite per il profilo del dispositivo COMPANION_DEVICE_GLASSES
e i requisiti per utilizzarle.
Autorizzazioni | Requisiti dell'app complementare e del dispositivo |
---|---|
NotificheBIND_NOTIFICATION_LISTENER_SERVICE POST_NOTIFICATIONS |
|
Phone |
|
SMS |
|
Contacts |
|
Microphone |
|
Nearby devices |
|
Managing ongoing calls |
|
Implementazione
Per gli sviluppatori di terze parti che implementano un'app complementare che richiede il profilo DEVICE_PROFILE_WATCH
, procedi come segue:
Chiama il metodo
setDeviceProfile
.Passa un profilo (ad esempio
DEVICE_PROFILE_WATCH
durante la creazioneAssociationRequest
.
I produttori del dispositivo evitano di visualizzare la finestra di dialogo per il consenso dell'utente
Per i produttori di dispositivi che implementano un'app complementare con un dispositivo specifico, utilizzare le seguenti configurazioni di sistema Android richieste per certificare l'app complementare, che consente all'app di ignorare la visualizzazione della finestra di dialogo per il consenso dell'utente per gli utenti.
Recuperare il certificato utilizzando il comando seguente:
keytool -printcert -jarfile PATH/TO/APK
Sostituisci 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
AssociationRequest
per effettuare una richiesta di associazione a un singolo dispositivo complementare.
Validazione
Per testare il comportamento della funzionalità del profilo del dispositivo associato, utilizzare i test CTS in cts/tests/tests/companion/
.