Richiedere autorizzazioni su Wear OS

La richiesta di autorizzazioni su Wear OS è simile alla richiesta di autorizzazioni nelle app mobile, con un paio di casi d'uso aggiuntivi. Questo documento presuppone che tu sappia come funzionano le autorizzazioni Android. In caso contrario, rivedi il funzionamento delle autorizzazioni su Android.

Come in un'app mobile, l'utente deve concedere le autorizzazioni a un'app Wear per accedere a determinate funzionalità. Nelle tue app per Wear, fornisci funzionalità significative senza richiedere autorizzazioni.

Scenari di autorizzazione

Esistono diversi scenari che potresti incontrare quando richiedi autorizzazioni pericolose su Wear OS:

  • L'app Wear richiede autorizzazioni per un'app in esecuzione sul dispositivo indossabile.

  • L'app Wear richiede le autorizzazioni per un'app in esecuzione sullo smartphone.

  • L'app Telefono richiede le autorizzazioni per un'app in esecuzione sul dispositivo indossabile.

  • L'app Telefono richiede più autorizzazioni che possono essere utilizzate solo mentre il dispositivo indossabile è connesso.

Per vedere tutti questi scenari in un'app funzionante, esamina l'esempio ExerciseSampleCompose su GitHub.

Le sezioni seguenti spiegano ciascuno di questi scenari. Per informazioni più dettagliate sulla richiesta di autorizzazioni, consulta la sezione Modelli di richiesta di autorizzazioni.

L'app Wear richiede l'autorizzazione per il wearable

Quando l'app Wear richiede un'autorizzazione per un'app in esecuzione sul dispositivo indossabile, il sistema mostra una finestra di dialogo per richiedere l'autorizzazione all'utente. Nella tua app, richiedi le autorizzazioni solo quando è chiaro all'utente perché sono necessarie per eseguire una determinata operazione.

Esamina i principi delle autorizzazioni per assicurarti di offrire la migliore esperienza ai tuoi utenti e ricorda di controllare shouldShowRequestPermissionRationale() e fornire ulteriori informazioni, se necessario.

Se un'app o un quadrante richiede più di un'autorizzazione alla volta, le richieste di autorizzazione vengono visualizzate una dopo l'altra.

Più schermate di autorizzazione, una dopo l'altra.
Figura 1. Schermate delle autorizzazioni che appaiono in successione.

L'app Wear richiede l'autorizzazione telefono

Quando l'app Wear richiede un'autorizzazione per lo smartphone, ad esempio un'app per dispositivi indossabili vuole accedere a foto o altri dati sensibili nella versione mobile dell'app, l'app Wear deve inviare l'utente allo smartphone per accettare l'autorizzazione. Lì, l'app Telefono può fornire ulteriori informazioni all'utente, utilizzando un'attività. Nell'attività, includi due pulsanti: uno per concedere l'autorizzazione e uno per negarla.

L'app Wear invia l'utente allo smartphone per concedere l'autorizzazione.
Figura 2. Invia l'utente allo smartphone per concedere l'autorizzazione.

L'app Telefono richiede l'autorizzazione per il wearable

Se l'utente si trova in un'app per smartphone e l'app richiede un'autorizzazione per indossabili, ad esempio per precaricare la musica nel caso in cui lo smartphone si disconnetta, l'app per smartphone indirizza l'utente al dispositivo indossabile per accettare l'autorizzazione. La versione indossabile dell'app utilizza il metodo requestPermissions per attivare la finestra di dialogo delle autorizzazioni di sistema.

L'app Telefono invia l'utente al dispositivo indossabile per concedere l'autorizzazione.
Figura 3. Invia l'utente al dispositivo indossabile per concedere l'autorizzazione.

L'app Telefono richiede più autorizzazioni contemporaneamente

Figura 4. Una finestra di dialogo delle autorizzazioni che utilizza un profilo del dispositivo complementare per richiedere più autorizzazioni in un'unica richiesta.

Le app partner su Android 12 (livello API 31) e versioni successive possono utilizzare i profili dei dispositivi complementari quando si connettono a uno smartwatch. L'utilizzo di un profilo semplifica la procedura di registrazione raggruppando la concessione di un insieme di autorizzazioni specifico per il tipo di dispositivo in un unico passaggio.

Le autorizzazioni raggruppate vengono concesse all'app complementare una volta connesso il dispositivo e durano solo per il periodo di associazione del dispositivo. L'eliminazione dell'app o la rimozione dell'associazione comporta la rimozione delle autorizzazioni. Per maggiori dettagli, vedi AssociationRequest.Builder.setDeviceProfile().

Pattern di richiesta di autorizzazione

Esistono diversi pattern per richiedere le autorizzazioni agli utenti. In ordine di priorità, sono:

  • Chiedi l'autorizzazione nel contesto quando è ovviamente necessaria per una funzionalità specifica, ma non per l'esecuzione dell'app nel suo complesso.

  • Fornisci informazioni nel contesto quando il motivo della richiesta di autorizzazione non è ovvio e l'autorizzazione non è necessaria per il funzionamento complessivo dell'app.

Questi pattern sono spiegati nelle sezioni seguenti.

Chiedere nel contesto

Richiedi le autorizzazioni quando è chiaro all'utente perché sono necessarie per eseguire una determinata operazione. È più probabile che gli utenti concedano un'autorizzazione quando comprendono il suo collegamento alla funzionalità che vogliono utilizzare.

Ad esempio, un'app potrebbe richiedere la posizione dell'utente per mostrare i luoghi di interesse nelle vicinanze. Quando l'utente tocca per cercare luoghi nelle vicinanze, l'app può richiedere immediatamente l'autorizzazione di accesso alla posizione perché esiste una chiara relazione tra la ricerca di luoghi nelle vicinanze e la necessità dell'autorizzazione di accesso alla posizione. L'ovvietà di questa relazione rende superfluo che l'app mostri schermate didattiche aggiuntive.

L'app richiede l'autorizzazione quando è ovviamente necessaria.
Figura 5. Chiedi un'autorizzazione nel contesto.

Educare nel contesto

La figura 6 mostra un esempio di formazione contestuale. L'app non richiede autorizzazioni per avviare il timer, ma un suggerimento didattico in linea mostra che una parte dell'attività, il rilevamento della posizione, è bloccata. Quando l'utente tocca il suggerimento, viene visualizzata una schermata di richiesta di autorizzazione che consente all'utente di sbloccare il rilevamento della posizione.

Utilizza il metodo shouldShowRequestPermissionRationale per aiutare la tua app a decidere se fornire maggiori informazioni. Per ulteriori dettagli, vedi Richiedere autorizzazioni app. In alternativa, puoi esaminare il modo in cui l'applicazione di esempio per oratori su GitHub gestisce la visualizzazione delle informazioni.

Quando si presenta la necessità dell'autorizzazione, l'app spiega perché è necessaria.
Figura 6. Fornisci informazioni nel contesto.

Gestire il rifiuto

Se l'utente nega un'autorizzazione richiesta che non è fondamentale per un'attività prevista, non impedirgli di continuare l'attività. Se alcune parti dell'attività sono disattivate a causa dell'autorizzazione negata, fornisci un feedback visivo e pratico.

La figura 7 mostra l'utilizzo di un'icona a forma di lucchetto per indicare che una funzionalità è bloccata perché l'utente non ha concesso l'autorizzazione per utilizzarla.

Quando l'utente nega l'autorizzazione, viene visualizzata un'icona a forma di lucchetto accanto alla funzionalità associata.
Figura 7. Icona lucchetto che indica che una funzionalità è bloccata a causa di un'autorizzazione negata.

Quando una finestra di dialogo relativa a un'autorizzazione per indossabili precedentemente negata viene visualizzata una seconda volta, include l'opzione Nega, non mostrare più. Se l'utente sceglie questa opzione, l'unico modo per concedere questa autorizzazione in futuro è accedere all'app Impostazioni del dispositivo indossabile.

Il sistema offre la possibilità di interrompere la richiesta di autorizzazione.
Figura 8. L'utente può accedere a una richiesta di autorizzazione che è stata negata due volte in precedenza tramite le Impostazioni.

Scopri di più su come gestire il rifiuto delle autorizzazioni.

Autorizzazioni per i servizi

Solo un'attività può chiamare il metodo requestPermissions, quindi se l'utente interagisce con la tua app utilizzando un servizio, ad esempio tramite un quadrante dell'orologio, il servizio deve aprire un'attività prima di richiedere l'autorizzazione. In questa attività, fornisci ulteriori informazioni sul motivo per cui è necessaria l'autorizzazione.

In generale, non richiedere autorizzazioni per un quadrante. Implementa invece una complicazione e lascia che l'utente scelga quali dati visualizzare tramite la complicazione.

Impostazioni

Un utente può modificare le autorizzazioni di un'app Wear in Impostazioni in qualsiasi momento. Quando l'utente tenta di eseguire un'operazione che richiede un'autorizzazione, chiama prima il metodo checkSelfPermission per verificare se l'app ha l'autorizzazione per eseguire l'operazione.

Esegui questo controllo anche se l'utente ha concesso l'autorizzazione in precedenza, perché potrebbe averla revocata in un secondo momento.

L'utente può modificare le autorizzazioni tramite l'app Impostazioni.
Figura 9. L'utente può modificare le autorizzazioni utilizzando l'app Impostazioni.