发送与接收消息

    使用MessageApi发送消息，要附加以下几项：

    • 任一payload（可选）
    • 唯一标识消息动作的路径

    不像数据元，Messages（消息）在手持和可穿戴应用之间没有同步。Messages是单向交流机制，这有利于远程进程调用(RPC)，比如：发送消息到可穿戴设备以开启activity。

    多个可穿戴设备可以连接到一台用户的手持设备。在网络中每个已连接的设备被视为一个节点（node）。由于有多个已连接的设备，我们必须考虑哪个节点收到消息。例如，在一个在可穿戴设备上接收语音数据的语音转录应用中，我们应该发送消息到一个具有处理能力和电池容量的节点来处理请求，例如一个手持式设备。

    Note: Google Play services 7.3.0版之前，一次只有一个可穿戴设备可以连接到手持设备。我们需要将现有的代码升级，以考虑到多个连接节点的功能。如果我们不作出修改，那么我们的消息可能不会传到想要的设备。

    一个可穿戴应用可以为用户提供如语音转录等功能。用户可以对着他们可穿戴设备的麦克风说话，然后就会将语音保存成一个笔记。由于一个可穿戴设备通常没有足够的处理能力和电池容量来处理语音转录activity，所以应用应该将这个工作留给一个更加有能力的、已连接的设备来处理。

    下面几个小节介绍如何通知那些可以处理activity请求的设备节点，发现有能力满足请求的节点，并发送消息给那些节点。

    为了把我们的手持式应用的功能通知其它节点，需要：

    1. 在工程的 目录下创建一个名为 wear.xml 的 XML 文件。
    2. 在 wear.xml 文件中添加一个名为 android_wear_capabilities 的资源。
    3. 定义设备可以提供的功能。

    下面这个例子介绍了如何将一个名为 voice_transcription 的功能添加到 wear.xml中：

    首先，我们可以通过调用 方法来检测具有相关功能的节点。下面的例子介绍了如何手动检索具有 voice_transcription 功能的节点：

    1. private static final String
    2.         VOICE_TRANSCRIPTION_CAPABILITY_NAME = "voice_transcription";
    4. private GoogleApiClient mGoogleApiClient;
    6. ...
    8.     CapabilityApi.GetCapabilityResult result =
    9.             Wearable.CapabilityApi.getCapability(
    11.                     CapabilityApi.FILTER_REACHABLE).await();
    13.     updateTranscriptionCapability(result.getCapability());
    14. }

    为了在连接到可穿戴设备的时候检测有能力的节点，注册一个 CapabilityApi.CapabilityListener() 实例到 。下面的例子介绍了如何注册该监听器和检索具有 voice_transcription 功能的节点。

    Note: 如果我们创建一个继承 WearableListenerService 的 service 来检测功能的变化，我们可能要重写 ) 方法来监听细微的连接细节，例如，一个可穿戴设备与手持式设备从Wi-Fi连接切换到蓝牙连接。关于一个实现的例子，请查看在 FindMyPhone 示例中的 DisconnectListenerService 类。更多关于如何监听重要事件的内容，请见。

    下面的例子介绍了如何确定最佳节点：

    1. private String transcriptionNodeId = null;
    3. private void updateTranscriptionCapability(CapabilityInfo capabilityInfo) {
    4.     Set<Node> connectedNodes = capabilityInfo.getNodes();
    6.     transcriptionNodeId = pickBestNodeId(connectedNodes);
    7. }
    9. private String pickBestNodeId(Set<Node> nodes) {
    10.     String bestNodeId = null;
    11.     for (Node node : nodes) {
    12.         if (node.isNearby()) {
    13.             return node.getId();
    14.          }
    15.          bestNodeId = node.getId();
    16.     }
    17.     return bestNodeId;
    18. }

    一旦我们确定了最佳节点，使用 MessageApi 发送消息。

    下面的例子介绍了如何从一个可穿戴设备发送消息到具有语音转录功能的节点。在我们试图发送消息之前，需要判断节点是否可用。这个调用是同步的，它在系统将传送的消息放到队列前会一直阻塞。

    Note: 阅读 了解更多关于异步和同步调用，以及何时使用哪个。

    我们还可以广播消息给所有已连接的节点。为了获得我们可以发送消息的已连接节点，需要实现下面的代码：

    1. private Collection<String> getNodes() {
    2.     HashSet <String>results = new HashSet<String>();
    3.     NodeApi.GetConnectedNodesResult nodes =
    4.             Wearable.NodeApi.getConnectedNodes(mGoogleApiClient).await();
    5.     for (Node node : nodes.getNodes()) {
    6.         results.add(node.getId());
    7.     }
    8.     return results;

    接收消息

    这仅是实现更多细节的一小段。关于如何在 service 或 activity 实现完整的监听，请参见 。