Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)

Sending and Receiving Messages

This lesson teaches you to

  1. Send a Message
  2. Receive a Message

You send messages using the MessageApi and attach the following items to the message:

  • An arbitrary payload (optional)
  • A path that uniquely identifies the message's action

Unlike data items, there is no syncing between the handheld and wearable apps. Messages are a one-way communication mechanism that's meant for "fire-and-forget" tasks, such as sending a message to the wearable to start an activity. You can also use messages in request/response model where one side of the connection sends a message, does some work, sends back a response message.

Send a Message

The following example shows how to send a message that indicates to the other side of the connect to start an activity. This call is made synchronously, which blocks until the message is received or when the request times out:

Note: Read more about asynchronous and synchronous calls to Google Play services and when to use each in Communicate with Google Play Services .

       Node node; // the connected device to send the message to
GoogleApiClient mGoogleApiClient;
public static final START_ACTIVITY_PATH = "/start/MainActivity";
...

    SendMessageResult result = Wearable.MessageApi.sendMessage(
            mGoogleApiClient, node, START_ACTIVITY_PATH, null).await();
    if (!result.getStatus().isSuccess()) {
        Log.e(TAG, "ERROR: failed to send Message: " + result.getStatus());
    }
      

Here's a simple way to get a list of connected nodes that you can potentially send messages to:

       private Collection<String> getNodes() {
    HashSet <String>results= new HashSet<String>();
    NodeApi.GetConnectedNodesResult nodes =
            Wearable.NodeApi.getConnectedNodes(mGoogleApiClient).await();
    for (Node node : nodes.getNodes()) {
        results.add(node.getId());
    }
    return results;
}
      

Receiving a Message

To be notified of received messages, you implement a listener for message events. This example shows how you might do this by checking the START_ACTIVITY_PATH that the previous example used to send the message. If this condition is true , a specific activity is started.

       @Override
public void onMessageReceived(MessageEvent messageEvent) {
    if (messageEvent.getPath().equals(START_ACTIVITY_PATH)) {
        Intent startIntent = new Intent(this, MainActivity.class);
        startIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
        startActivity(startIntent);
    }
}
      

This is just a snippet that requires more implementation details. Learn about how to implement a full listener service or activity in Listening for Data Layer Events .