Accesso al livello dati indossabile

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.