Descobrir dispositivos em uma rede usando as APIs Data Layer

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.