Ao chamar a API Data Layer, use a classe
Wearable
para receber instâncias das várias classes de cliente,
como
DataClient
e
MessageClient
.
Confira estes recursos relacionados:
- Exemplo de DataLayer (link em inglês)
Observação: a API Data Layer só pode enviar mensagens e sincronizar dados com dispositivos Android ou
relógios Wear OS. Isso significa que, se o dispositivo Wear OS estiver pareado
com um dispositivo iOS, a API Data Layer não vai funcionar.
Por esse motivo, não
use essa API como a principal forma de comunicação com uma rede. Em vez disso,
siga o mesmo padrão dos apps para dispositivos móveis,
com algumas pequenas diferenças.
Usar um cliente mínimo
Como mostrado no exemplo a seguir, um cliente mínimo é o suficiente para começar. Consulte Acessar APIs Google para conferir mais informações.
Kotlin
val dataClient: DataClient = Wearable.getDataClient(context)
Java
DataClient dataClient = Wearable.getDataClient(context);
O contexto pode ser qualquer um do Android que seja válido. Caso você esteja usando a API
no escopo de uma Activity
, use o
método getDataClient(activity)
da
classe Wearable
. Isso permite que algumas interações apareçam
como caixas de diálogo em vez de notificações, como quando o usuário precisa atualizar
a versão do Google Play Services.
Por padrão, callbacks para listeners são feitos na linha de execução de interface principal do app.
Se quiser callbacks em uma linha de execução diferente, use um objeto
WearableOptions
para especificar um Looper
personalizado:
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);
Consulte a referência
WearableOptions.Builder
para mais informações.
Os clientes da API Wearable, como
DataClient
e
MessageClient
, têm baixo custo de criação. Como eles não precisam
ser mantidos, você pode criar esses clientes quantas vezes precisar. Use o estilo adequado ao seu app. O estado
do cliente, como o conjunto de listeners registrados, é compartilhado entre todos os clientes
e fica preservado quando o Google Play Services é atualizado enquanto um app está
em execução.