Wear OS设备蓝牙有效范围进出监听API及自动重连问题

好问题！我来帮你捋清楚Wear OS平台上关于设备蓝牙范围监听和自动重连的实现方案：

一、有没有监听设备进出蓝牙有效范围的API？ #

当然有！Wear OS提供了两套核心API来监听设备连接状态的变化：

1. NodeClient 节点监听 #

通过NodeClient可以监听所有可连接的Wear节点（比如你的手机）的添加/移除事件，当设备回到蓝牙范围内时，你会收到节点新增的回调。

2. CapabilityClient 能力监听 #

如果你的手机端应用声明了特定的能力（比如接收手表指令的能力），用CapabilityClient监听具备该能力的节点变化会更精准——它只会通知你关心的、能和你的应用交互的设备状态，避免无关设备的干扰。

二、实现重连必须扫描附近节点吗？ #

完全不需要手动扫描！Wear OS的连接管理框架会自动维护可用节点的列表，当设备从超出范围回到有效区域时，上述监听器会自动触发回调，你只需要在回调里执行重连/重新发送指令的逻辑即可。

实用代码示例 #

1. 用NodeClient监听节点变化 #

// 获取NodeClient实例
val nodeClient = Wearable.getNodeClient(context)

// 定义节点监听器
val nodeListener = object : NodeListener {
    override fun onNodesChanged(nodes: List<Node>) {
        // 筛选出附近的目标手机节点（isNearby标记设备在蓝牙范围内）
        val targetPhoneNode = nodes.firstOrNull { it.isNearby }
        
        targetPhoneNode?.let { node ->
            // 这里执行重连或重新发送指令的逻辑
            sendCommandToPhone(node.id)
        }
    }
}

// 注册监听器（记得在页面销毁或不再需要时移除）
nodeClient.addListener(nodeListener)

2. 用CapabilityClient监听特定能力的设备 #

首先在手机端的wear.xml中声明能力：

<resources>
    <wearableApp package="com.your.package">
        <capability name="COMMAND_RECEIVER" />
    </wearableApp>
</resources>

然后在手表端监听该能力的节点变化：

val capabilityClient = Wearable.getCapabilityClient(context)

val capabilityListener = object : CapabilityListener {
    override fun onCapabilityChanged(capabilityInfo: CapabilityInfo) {
        // 获取当前可连接的、具备COMMAND_RECEIVER能力的节点
        val reachableNodes = capabilityInfo.nodes
        val targetPhoneNode = reachableNodes.firstOrNull { it.isNearby }
        
        targetPhoneNode?.let {
            // 触发重连逻辑
            restoreConnection(it.id)
        }
    }
}

// 注册监听器，只监听可到达的设备
capabilityClient.addListener(
    capabilityListener,
    "COMMAND_RECEIVER",
    CapabilityClient.FILTER_REACHABLE
)

额外提示 #

针对你遇到的Target not found exception，可以在异常捕获逻辑中标记当前连接状态为“断开”，等监听器收到设备回归的通知后，再自动重试发送指令，这样就能实现完整的自动重连流程了。

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