public abstract class

MessageClient

extends GoogleApi<Wearable.WearableOptions>
java.lang.Object
   ↳ com.google.android.gms.common.api.GoogleApi<com.google.android.gms.wearable.Wearable.WearableOptions>
     ↳ com.google.android.gms.wearable.MessageClient

Class Overview

Exposes an API for components to send messages to other nodes.

Messages are delivered to connected network nodes. A message is considered successful if it has been queued for delivery to the specified node. A message will only be queued if the specified node is connected. A DataClient should be used for messages to nodes which are not currently connected (to be delivered on connection).

Messages should generally contain ephemeral, small payloads. Use assets with a DataClient to store more persistent or larger data efficiently.

A message is private to the application that created it and accessible only by that application on other nodes.

Summary

Nested Classes
@interface MessageClient.FilterType Message filter types. 
interface MessageClient.OnMessageReceivedListener Used with addListener(MessageClient.OnMessageReceivedListener) to receive message events. 
Constants
String ACTION_MESSAGE_RECEIVED Message received action for use in manifest-based listener filters.
int FILTER_LITERAL Filter type for addListener(OnMessageReceivedListener, Uri, int): if this filter is set, the given URI will be taken as a literal path, and the operation will apply to the matching message only.
int FILTER_PREFIX Filter type for addListener(OnMessageReceivedListener, Uri, int): if this filter is set, the given URI will be taken as a path prefix, and the operation will apply to all matching messages.
Public Methods
abstract Task<Void> addListener(MessageClient.OnMessageReceivedListener listener, Uri uri, int filterType)
Registers a listener to be notified of received messages.
abstract Task<Void> addListener(MessageClient.OnMessageReceivedListener listener)
Registers a listener to be notified of received messages.
abstract Task<Boolean> removeListener(MessageClient.OnMessageReceivedListener listener)
Removes a listener which was previously added through addListener(OnMessageReceivedListener) or addListener(OnMessageReceivedListener, Uri, int).
abstract Task<Integer> sendMessage(String nodeId, String path, byte[] data)
Sends byte[] data to the specified node.
[Expand]
Inherited Methods
From class java.lang.Object

Constants

public static final String ACTION_MESSAGE_RECEIVED

Message received action for use in manifest-based listener filters.

Constant Value: "com.google.android.gms.wearable.MESSAGE_RECEIVED"

public static final int FILTER_LITERAL

Filter type for addListener(OnMessageReceivedListener, Uri, int): if this filter is set, the given URI will be taken as a literal path, and the operation will apply to the matching message only.

Constant Value: 0 (0x00000000)

public static final int FILTER_PREFIX

Filter type for addListener(OnMessageReceivedListener, Uri, int): if this filter is set, the given URI will be taken as a path prefix, and the operation will apply to all matching messages.

Constant Value: 1 (0x00000001)

Public Methods

public abstract Task<Void> addListener (MessageClient.OnMessageReceivedListener listener, Uri uri, int filterType)

Registers a listener to be notified of received messages. Calls to this method should be balanced with removeListener(OnMessageReceivedListener) to avoid leaking resources.

uri and filterType can be used to filter the messages sent to the listener. For example, if uri and filterType create a path prefix filter, then only messages matching that prefix will be notified. The uri follows the rules of the <data> element of <intent-filter>. The path is ignored if a URI host is not specified. The host should be an Android Wear node ID, or * to match any node. i.e, you should use:

wear://*/<path>
or
wear://<nodeId>/<path>

Listeners will be called on the main thread, or the looper set in Wearable.WearableOptions.

Callers wishing to be notified of events in the background should use WearableListenerService.

Parameters
listener MessageClient.OnMessageReceivedListener
uri Uri
filterType int
Returns
Task<Void>

public abstract Task<Void> addListener (MessageClient.OnMessageReceivedListener listener)

Registers a listener to be notified of received messages. Calls to this method should be balanced with removeListener(OnMessageReceivedListener) to avoid leaking resources.

Listeners will be called on the main thread, or the looper set in Wearable.WearableOptions.

Callers wishing to be notified of events in the background should use WearableListenerService.

Parameters
listener MessageClient.OnMessageReceivedListener
Returns
Task<Void>

public abstract Task<Boolean> removeListener (MessageClient.OnMessageReceivedListener listener)

Removes a listener which was previously added through addListener(OnMessageReceivedListener) or addListener(OnMessageReceivedListener, Uri, int).

Parameters
listener MessageClient.OnMessageReceivedListener
Returns
Task<Boolean>

public abstract Task<Integer> sendMessage (String nodeId, String path, byte[] data)

Sends byte[] data to the specified node.

Parameters
nodeId String: identifier for a particular node on the Android Wear network. Valid targets may be obtained through getCapability(String, int) or from the host in getUri().
path String: identifier used to specify a particular endpoint at the receiving node
data byte: small array of information to pass to the target node. Generally not larger than 100k
Returns
Task<Integer> if successful, an ID used to identify the sent message, otherwise an ApiException. A successful result doesn't guarantee delivery.