Cómo descubrir dispositivos en una red con las APIs de Data Layer

Los dispositivos pueden establecer una conexión a Internet de forma directa con una conexión Wi-Fi o móvil, o de forma indirecta a través de un dispositivo Bluetooth vinculado.

Nodos accesibles y cercanos

Se considera que un dispositivo está disponible cuando está en línea y disponible para comunicarse con otro dispositivo, ya sea directamente a través de Bluetooth o de forma indirecta con la nube como intermediario.

Un dispositivo se considera cercano si se puede conectar directamente a través de Bluetooth, sin usar la nube.

Actividades que afectan el tiempo de reconexión

En ciertas circunstancias, los dispositivos pueden tardar hasta 4 minutos en restablecer una conexión. Estos casos incluyen lo siguiente:

  • Inactividad del dispositivo Wear OS: Si se quita un dispositivo Wear OS de la muñeca del usuario o no se usa de forma activa durante un período prolongado, es posible que se extienda el tiempo de reconexión.
  • Estado de Doze: El estado de Doze de ahorro de energía de un dispositivo portátil puede limitar los procesos en segundo plano, lo que podría aumentar el tiempo de reconexión del dispositivo.
  • Interacción del usuario: Si el usuario comienza a interactuar con un dispositivo de mano y un dispositivo Wear OS aproximadamente al mismo tiempo, suele acelerarse el proceso de reconexión.

Descubre todos los dispositivos con un cliente de nodo

Un objeto NodeClient identifica y transmite a la lista de dispositivos con tecnología Android conectados a una red, independientemente de la capacidad de cada dispositivo. Todas las apps de un dispositivo reciben estas notificaciones de eventos, como cuando un dispositivo nuevo se une a la red o un dispositivo existente se desconecta.

La clase NodeClient es particularmente útil para descubrir dispositivos que no tienen tu app instalada.

Para registrarte en eventos de conexión y desconexión de dispositivos, puedes usar la clase DataLayerAppHelper de Horologist. Proporciona un objeto connectedAndInstalledNodes Flow para observar el estado de conexión. Además, su método connectedNodes() devuelve una lista de dispositivos conectados, lo que combina información de NodeClient y CapabilityClient en un solo objeto.

Descubre dispositivos específicos con un cliente de capacidades

Un objeto CapabilityClient proporciona información sobre qué dispositivos de la red de Wear OS admiten funciones específicas de la app. Una capacidad es una función que una app define en el tiempo de compilación o que configura de forma dinámica durante el tiempo de ejecución.

Por ejemplo, una app para Android podría anunciar que admite el control remoto de la reproducción de videos. La versión para Wear OS de esa app puede usar la CapabilityClient para verificar si la versión para dispositivos móviles está instalada en un dispositivo cercano y si es compatible con esa función. Si es así, la app para Wear OS puede mostrar los botones de reproducción y pausa para que los usuarios puedan controlar un video que se reproduce en su dispositivo móvil desde su dispositivo Wear OS. La transmisión de capacidades también funciona en la dirección opuesta; las apps para Wear OS pueden enumerar las capacidades que admiten.

Para definir las capacidades en el tiempo de compilación, declara un recurso string-array llamado android_wear_capabilities en res/values/wear.xml, como se muestra en Especifica nombres de funciones para detectar las apps. Para evitar que la reducción de recursos quite android_wear_capabilities como no utilizado, especifica tools:keep="@array/android_wear_capabilities" en un archivo de conservación independiente en el directorio res/raw/ (por ejemplo, res/raw/keep.xml) en lugar de res/values/wear.xml. Para conocer la sintaxis del archivo de mantenimiento, consulta Cómo personalizar los recursos que se conservarán.

Verifica las nuevas capacidades de tu app

Usa el CapabilityClient para determinar el ID de nodo de un dispositivo con el que necesitas comunicarte. Por ejemplo, si necesitas verificar la presencia de una función nueva en tu app para dispositivos de mano, crea una capacidad para esa función nueva en el lado del dispositivo de mano. Luego, tu app para Wear OS puede consultar los dispositivos que admiten esa capacidad. Si falta la capacidad en todos los dispositivos, significa que el usuario no tiene una versión de tu app que admita esta función, lo que debes controlar de forma correcta en la lógica de tu app. Si supones que el dispositivo de mano siempre es el nodo correcto con el que se debe establecer la comunicación, es posible que tus mensajes no se entreguen porque la app de Teléfono no admite la función.

Determina si un dispositivo Wear OS es el único en una red

Puedes usar CapabilityClient para verificar si tu app debe funcionar en modo independiente porque no hay otros dispositivos con Android cerca. Si pasas FILTER_ALL, no deberían aparecer otros dispositivos en los resultados.