Os dispositivos podem estabelecer uma conexão com a Internet diretamente usando uma conexão Wi-Fi ou celular ou indiretamente por um dispositivo Bluetooth pareado.
Nós acessíveis e próximos
Um dispositivo é considerado alcançável quando está on-line e disponível para se comunicar com outro dispositivo, seja diretamente por Bluetooth ou indiretamente usando a nuvem como intermediária.
Um dispositivo é considerado próximo se puder ser conectado diretamente por Bluetooth, sem usar a nuvem.
Atividades que afetam o tempo de reconexão
Em algumas circunstâncias, os dispositivos podem levar até 4 minutos para restabelecer uma conexão. Esses cenários incluem:
- Inatividade do dispositivo Wear OS: se um dispositivo Wear OS for removido do pulso do usuário ou não for usado ativamente por um período prolongado, o tempo de reconexão poderá ser estendido.
- Estado de soneca: o estado de soneca de economia de energia de um dispositivo portátil pode limitar os processos em segundo plano, o que pode aumentar o tempo de reconexão do dispositivo.
- Interação do usuário: se o usuário começar a interagir com um dispositivo portátil e um dispositivo Wear OS aproximadamente ao mesmo tempo, isso geralmente acelera o processo de reconexão.
Descobrir todos os dispositivos usando um cliente de nó
Um objeto NodeClient identifica e transmite para a lista de dispositivos Android
conectados a uma rede, independentemente da capacidade de cada dispositivo. Todos
os apps em um dispositivo recebem essas notificações de evento, como um novo dispositivo entrando
na rede ou um dispositivo atual ficando off-line.
A classe NodeClient é particularmente útil para descobrir dispositivos que
não têm seu app instalado.
Para registrar eventos de conexão e desconexão de dispositivos, use a
classe DataLayerAppHelper do Horologist. Ela fornece um
connectedAndInstalledNodes Flow para observar o estado da conexão. Além disso,
o método connectedNodes() retorna uma lista de dispositivos conectados, combinando
informações de NodeClient e CapabilityClient em um único objeto.
Descobrir dispositivos específicos usando um cliente de recursos
Um objeto CapabilityClient fornece informações sobre quais dispositivos na rede do Wear OS oferecem suporte a recursos específicos do app. Uma capability é um recurso
que um app define no build ou
configura dinamicamente no momento da execução.
Por exemplo, um app Android para dispositivos móveis pode anunciar que tem suporte a um controle remoto de reprodução de vídeo. A versão para Wear OS desse app pode usar o
CapabilityClient para verificar se a versão para dispositivos móveis está instalada
em um dispositivo por perto e se há suporte para esse recurso. Se for o caso, o app para Wear OS pode
mostrar botões de iniciar e pausar para que os usuários possam controlar um vídeo que está sendo reproduzido
no dispositivo móvel usando o dispositivo Wear OS. A transmissão de recursos
também funciona no sentido contrário. Os apps para Wear OS podem listar os recursos
com suporte.
Para definir capabilities no momento do build, declare um recurso string-array chamado
android_wear_capabilities em res/values/wear.xml, conforme mostrado em
Especificar nomes de recursos para detectar apps. Para evitar que a redução de recursos
remova android_wear_capabilities como não utilizado, especifique
tools:keep="@array/android_wear_capabilities" em um arquivo keep separado no
diretório res/raw/ (por exemplo, res/raw/keep.xml) em vez de em
res/values/wear.xml. Para ver a sintaxe do arquivo keep, consulte
Personalizar quais recursos manter.
Verificar os novos recursos do app
Use o CapabilityClient para determinar o ID do nó de um dispositivo com que você precisa
se comunicar. Por exemplo, se você precisar verificar a presença de um novo
recurso no app em
dispositivos portáteis, crie uma capacidade para esse novo recurso no
lado portátil. O app para Wear OS pode consultar os dispositivos que oferecem suporte a esse
recurso. Se o recurso estiver ausente em todos os dispositivos, isso significa que o usuário
não tem uma versão do app que ofereça suporte a ele. Você precisa
lidar com isso de forma adequada na lógica do app. Se você presumir que o dispositivo portátil é
sempre o nó correto para se comunicar, suas mensagens podem não ser
entregues, porque o app Telefone não oferece suporte ao recurso.
Determinar se um dispositivo Wear OS é o único em uma rede
Use o CapabilityClient para verificar se o app precisa operar no
modo independente porque não há outros dispositivos Android por perto. Ao
transmitir FILTER_ALL, nenhum outro dispositivo vai aparecer nos resultados.