Обнаружение устройств в сети с помощью API уровня данных

Устройства могут подключаться к интернету напрямую через Wi-Fi или передачу данных по мобильной сети или косвенно через подключенное устройство Bluetooth.

Доступные и ближайшие узлы

Устройство считается доступным, если оно подключено к интернету и может обмениваться данными с другим устройством напрямую через Bluetooth или через облако.

Устройство считается находящимся поблизости, если к нему можно подключиться напрямую через Bluetooth, не используя облако.

Действия, влияющие на время повторного подключения

В некоторых случаях на восстановление подключения может потребоваться до четырех минут. Вот примеры таких случаев:

  • Бездействие устройства Wear OS. Если устройство Wear OS снято с запястья пользователя или не используется активно в течение длительного периода, время повторного подключения может быть увеличено.
  • Спящий режим. Энергосберегающий спящий режим может ограничивать фоновые процессы, что увеличивает время повторного подключения устройства.
  • Взаимодействие с пользователем. Если пользователь начинает взаимодействовать с мобильным устройством и устройством Wear OS примерно в одно и то же время, это часто ускоряет процесс повторного подключения.

Обнаружение всех устройств с помощью клиента узла

Объект NodeClient идентифицирует и передает список устройств Android, подключенных к сети, независимо от возможностей каждого устройства. Все приложения на устройстве получают уведомления о таких событиях, например о подключении нового устройства к сети или отключении существующего.

Класс NodeClient особенно полезен для обнаружения устройств, на которых не установлено ваше приложение.

Чтобы зарегистрироваться для получения событий подключения и отключения устройства, вы можете использовать класс Horologist DataLayerAppHelper. Он предоставляет connectedAndInstalledNodes Flow для отслеживания состояния подключения. Кроме того, метод connectedNodes() возвращает список подключенных устройств, объединяя информацию из NodeClient и CapabilityClient в один объект.

Как найти определенные устройства с помощью клиента возможностей

Объект CapabilityClient предоставляет информацию о том, какие устройства в сети Wear OS поддерживают определенные возможности приложения. Функция – это возможность, которую приложение определяет во время сборки или динамически настраивает во время выполнения.

Например, мобильное приложение Android может рекламировать, что оно поддерживает дистанционное управление воспроизведением видео. Версия приложения для Wear OS может использовать CapabilityClient, чтобы проверить, установлена ли мобильная версия приложения на устройстве поблизости и поддерживает ли она эту функцию. Если да, то приложение для Wear OS может показывать кнопки воспроизведения и паузы, чтобы пользователи могли управлять видео, которое воспроизводится на мобильном устройстве, с устройства Wear OS. Трансляция возможностей работает и в обратном направлении: приложения Wear OS могут перечислять поддерживаемые ими возможности.

Чтобы определить возможности во время сборки, объявите ресурс string-array с именем android_wear_capabilities в res/values/wear.xml, как показано в разделе Укажите названия возможностей для обнаружения приложений. Чтобы предотвратить удаление android_wear_capabilities как неиспользуемого ресурса, укажите tools:keep="@array/android_wear_capabilities" в отдельном файле keep в каталоге res/raw/ (например, res/raw/keep.xml), а не в res/values/wear.xml. Синтаксис файла keep описан в разделе Как настроить, какие ресурсы нужно сохранить.

Проверьте новые возможности приложения

Используйте CapabilityClient, чтобы определить идентификатор узла устройства, с которым нужно связаться. Например, если вам нужно проверить, есть ли в приложении на мобильном устройстве новая функция, создайте для нее возможность на стороне мобильного устройства. После этого приложение для Wear OS сможет запрашивать информацию об устройствах, которые поддерживают эту функцию. Если функция отсутствует на всех устройствах, значит у пользователя нет версии приложения, которая ее поддерживает. Это нужно корректно обработать в логике приложения. Если вы предполагаете, что портативное устройство всегда является правильным узлом для связи, ваши сообщения могут не доставляться, поскольку приложение "Телефон" не поддерживает эту функцию.

Как определить, является ли устройство Wear OS единственным в сети

Вы можете использовать CapabilityClient, чтобы проверить, должно ли приложение работать в автономном режиме, если поблизости нет других устройств Android. Если передать FILTER_ALL, в результатах не должно быть других устройств.