使用数据层 API 发现网络上的设备

设备可以直接使用 Wi-Fi 或移动网络连接来建立互联网连接,也可以通过配对的蓝牙设备间接建立互联网连接。

可访问的节点和附近的节点

当设备处于在线状态且可与其他设备通信(直接通过蓝牙或间接使用云作为中介)时,会被视为可访问。

如果设备无需使用云端即可通过蓝牙直接连接,则会被视为附近设备。

影响重新连接时间的活动

在某些情况下,设备可能需要长达 4 分钟才能重新建立连接。这些情况包括:

  • 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 应用可以列出其支持的功能。

如需在构建时定义功能,请在 res/values/wear.xml 中声明名为 android_wear_capabilities 的 string-array 资源,如指定用于检测应用的功能名称中所述。为防止资源缩减功能将 android_wear_capabilities 作为未使用的资源移除,请在 res/raw/ 目录中的单独 keep 文件(例如 res/raw/keep.xml)而非 res/values/wear.xml 中指定 tools:keep="@array/android_wear_capabilities"。如需了解 keep 文件语法,请参阅自定义要保留的资源。

查看应用的新功能

使用 CapabilityClient 确定您需要与之通信的设备的节点 ID。例如,如果您需要检查手持设备上的应用中是否存在某项新功能,请在手持设备端为该新功能创建功能。然后,您的 Wear OS 应用可以查询支持该功能的设备。如果所有设备上都缺少该功能,则意味着用户没有支持此功能的应用版本,您应在应用逻辑中妥善处理这种情况。如果您假设手持设备始终是正确的通信节点,则您的消息可能最终无法送达,因为“电话”应用不支持该功能。

确定 Wear OS 设备是否是网络中的唯一设备

您可以使用 CapabilityClient 检查您的应用是否必须在独立模式下运行,因为附近没有其他 Android 设备。通过传入 FILTER_ALL,结果中不应显示任何其他设备。