Per chiamare l'API del livello dati, utilizza la classe
Wearable
per recuperare le istanze delle varie classi client,
come
DataClient
e
MessageClient
.
Consulta le seguenti risorse correlate:
Nota: l'API del livello dati può solo inviare messaggi e sincronizzare dati
con dispositivi Android o orologi Wear OS. Ciò significa che se il tuo dispositivo Wear OS è accoppiato con un
dispositivo iOS, l'API del livello dati non funziona.
Per questo motivo, non
utilizzare l'API del livello dati come metodo principale per comunicare con una rete. Segui invece lo stesso schema delle app mobile, con alcune piccole differenze.
Utilizza un client minimo
Per iniziare è sufficiente un client minimo, come mostrato nell'esempio seguente. Per ulteriori informazioni, consulta Accesso alle API di Google.
Kotlin
val dataClient: DataClient = Wearable.getDataClient(context)
Java
DataClient dataClient = Wearable.getDataClient(context);
Può trattarsi di qualsiasi contesto Android valido. Se utilizzi l'API nell'ambito di un Activity
, usa il metodo getDataClient(activity)
della classe Wearable
. In questo modo alcune interazioni vengono visualizzate come finestre di dialogo anziché come notifiche, ad esempio quando all'utente viene chiesto di aggiornare la versione di Google Play Services.
Per impostazione predefinita, i callback agli ascoltatori vengono eseguiti nel thread dell'interfaccia utente principale dell'app.
Per fare in modo che i callback vengano eseguiti su un thread diverso, utilizza un oggetto
WearableOptions
per specificare un Looper
personalizzato:
Kotlin
val dataClient: DataClient = Wearable.WearableOptions.Builder().setLooper(myLooper).build().let { options -> Wearable.getDataClient(context, options) }
Java
WearableOptions options = new WearableOptions.Builder().setLooper(myLooper).build(); DataClient dataClient = Wearable.getDataClient(context, options);
Consulta il riferimento
WearableOptions.Builder
per ulteriori informazioni.
I client API per dispositivi indossabili, come
DataClient
e
MessageClient
, sono poco costosi da creare. Non è necessario bloccare i client API, quindi puoi crearli tutte le volte che vuoi. Utilizza lo stile più adatto alla tua app. Lo stato del client, ad esempio l'insieme di listener registrati, viene condiviso tra tutti i client e viene conservato se Google Play Services viene aggiornato mentre un'app è in esecuzione.