Wear设备capabilityClient节点非nearby不可达，如何解决？

场景 #

我希望通过Wear设备监听capabilityClient，实现遗落手机提醒功能（检测手持设备是否离线）。尝试多次失败后，我反转了工作流程，改为从手持设备监听Wear设备来简化问题。

使用设备：实体Pixel 6（手机）、实体Fossil Carlyle HR（手表），二者已配对可正常使用，均已连接ADB，能通过Android Studio的Logcat查看日志。

问题 #

本地运行修改后的DataLayer Sample项目，最初尝试设置能力变化监听器，但设备离线时从未收到回调。转而查询节点验证设备是否可被发现，结果是有时能返回配对设备，有时不能。猜测问题可能和配对设备是否为“nearby”有关，但不确定。

代码 #

在MainActivity.kt中设置了触发queryNodes()的按钮：

MainActivity.kt
// Sorry for the gratuitous logging and control statements.
// I've been learning Kotlin as I go, and I forgot the value of the debugger.
...
    private fun queryNodes() {
        Log.d(TAG, "Node Query clicked")
        lifecycleScope.launch {
            try {
                val nodes = getReachableNodes()
                    .filterValues { MOBILE_CAPABILITY in it }.keys
                Log.d(TAG, "Nodes: " + nodes.toString())
            } catch (cancellationException: CancellationException) {
                throw cancellationException
            } catch (exception: Exception) {
                Log.d(TAG, "Querying nodes failed: $exception")
            }
        }
    }
...
    private suspend fun getReachableNodes(): Map<Node, Set<String>> =
        capabilityClient.getAllCapabilities(CapabilityClient.FILTER_REACHABLE)
            .await()
            // Pair the list of all reachable nodes with their capabilities
            .flatMap { (capability, capabilityInfo) ->
                Log.d(TAG, "flat mapping " + capability.toString())
                capabilityInfo.nodes.map { it to capability }
            }
            // Group the pairs by the nodes
            .groupBy(
                keySelector = { it.first },
                valueTransform = { it.second }
            )
            // Transform the capability list for each node into a set
            .mapValues { it.value.toSet() }
...

当前设置返回空节点列表。将过滤器改为FILTER_ALL时，能获取到一个节点，调试发现该节点的isNearby属性为false，推测这是它不“可达”的原因。

疑问 #

1. 如何让这些节点变为可达状态？是否与isNearby属性有关？
2. 使用CapabilityClient监听能力变化的思路是否正确？

关于节点可达与isNearby的关系 #

没错，isNearby属性直接影响节点的“可达”状态。Wear OS中，FILTER_REACHABLE只会返回当前通过蓝牙或Wi-Fi直连处于近场连接状态的节点，也就是isNearby=true的设备。如果设备配对但不在近场范围内（比如蓝牙断开），isNearby会变为false，自然不会被FILTER_REACHABLE筛选出来。

要让节点变为可达，确保以下几点：

• 手机和手表的蓝牙处于开启状态，且距离在蓝牙有效范围内（通常10米内）
• 关闭手机或手表的蓝牙省电模式，避免系统主动断开连接
• 确认两者没有被其他设备占用蓝牙连接（比如手表同时连了其他手机）

关于CapabilityClient监听思路的正确性 #

用CapabilityClient实现遗落提醒的思路是可行的，但需要注意几个关键点：

1. 正确注册能力监听：
   要在Wear设备端注册能力变化监听器，而不是只在手机端。因为你需要检测手机是否离线，应该让手表主动监听手机的能力状态。示例代码如下：

   private val capabilityListener = CapabilityClient.OnCapabilityChangedListener { capabilityInfo ->
       val connectedNodes = capabilityInfo.nodes.filter { it.isNearby }
       if (connectedNodes.isEmpty()) {
           // 手机已离线，触发遗落提醒
           showPhoneLeftBehindAlert()
       }
   }
   
   override fun onResume() {
       super.onResume()
       capabilityClient.addListener(
           capabilityListener,
           MOBILE_CAPABILITY,
           CapabilityClient.FILTER_REACHABLE
       )
   }
   
   override fun onPause() {
       super.onPause()
       capabilityClient.removeListener(capabilityListener)
   }
   

2. 处理延迟和误判：
   蓝牙连接偶尔会出现短暂断开再重连的情况，建议设置一个3-5秒的延迟，确认节点确实长时间不可达后再触发提醒，避免误报。
3. 后台运行权限：
   如果需要在后台持续监听，确保你的Wear应用申请了FOREGROUND_SERVICE权限，并启动前台服务，否则系统可能会在应用后台时杀死监听进程。

额外排查点 #

• 确认MOBILE_CAPABILITY在手机端的wear.xml中正确声明，且手机应用已注册该能力：

  <!-- res/values/wear.xml -->
  <string-array name="android_wear_capabilities">
      <item>mobile_capability</item>
  </string-array>
  

• 检查Logcat中是否有WearableServices相关的错误日志，比如权限不足、能力注册失败等信息。

内容的提问来源于stack exchange，提问作者losttime