java.lang.Object | ||||
↳ | android.content.Context | |||
↳ | android.content.ContextWrapper | |||
↳ | android.app.Service | |||
↳ | com.google.android.gms.wearable.WearableListenerService |
Receives events from other nodes, such as data changes, messages or connectivity events.
The life-cycle of this service is managed by Android Wear. This service will be bound to and events delivered as a result of various Android Wear events, including data, messages and events indicating a device has connected or disconnected from the Android Wear network.
Applications expecting to be notified of events while in the background should extend this
class. Activities and other short-lived Android components may use addListener(DataClient.OnDataChangedListener)
, addListener(MessageClient.OnMessageReceivedListener)
to receive events for a limited period
of time.
Implementors could use a LocalBroadcastManager
to dispatch events to other components
in an application.
For best performance, limit the number of listeners and use mutually exclusive filters where there are multiple listeners. A common pattern is to use prefix filters to listen to different namespaces within an application.
Example manifest entry:
android:pathPrefix is optional.
<service android:name=".MyWearableListenerService" > <intent-filter> <!-- listeners receive events that match the action and data filters --> <action android:name="com.google.android.gms.wearable.DATA_CHANGED" /> <action android:name="com.google.android.gms.wearable.MESSAGE_RECEIVED" /> <action android:name="com.google.android.gms.wearable.CAPABILITY_CHANGED" /> <action android:name="com.google.android.gms.wearable.CHANNEL_EVENT" /> <data android:scheme="wear" android:host="*" android:pathPrefix="/prefix" /> </intent-filter> </service>
[Expand]
Inherited Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
![]() | |||||||||||
![]() | |||||||||||
![]() | |||||||||||
![]() |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
This method is used to retrieve the looper all callbacks will run on.
| |||||||||||
Called when a channel is closed.
| |||||||||||
Called when a channel is closed.
| |||||||||||
Called when a new channel is opened by a remote node.
| |||||||||||
Called when a new channel is opened by a remote node.
| |||||||||||
Receives data changed events.
| |||||||||||
Called when the input side of a channel is closed.
| |||||||||||
Called when the input side of a channel is closed.
| |||||||||||
Receives message events.
| |||||||||||
Called when the output side of a channel is closed.
| |||||||||||
Called when the output side of a channel is closed.
| |||||||||||
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
![]() | |||||||||||
![]() | |||||||||||
![]() | |||||||||||
![]() | |||||||||||
![]() | |||||||||||
![]() | |||||||||||
![]() | |||||||||||
![]() | |||||||||||
![]() | |||||||||||
![]() |
This method is used to retrieve the looper all callbacks will run on. The default behavior is to construct a new background thread the first time called and use that thread. If a different looper is desired, subclasses should override this method.
Returns | |
---|---|
Looper |
Parameters | |
---|---|
intent |
Intent |
Returns | |
---|---|
IBinder |
Parameters | |
---|---|
capabilityInfo |
CapabilityInfo |
Called when a channel is closed. This can happen through an explicit call to close(GoogleApiClient)
or close(GoogleApiClient, int)
on either side
of the connection, or due to disconnecting from the remote node.
Parameters | |
---|---|
channel |
Channel |
closeReason |
int : the reason for the channel closing. One of CLOSE_REASON_DISCONNECTED , CLOSE_REASON_REMOTE_CLOSE , or CLOSE_REASON_LOCAL_CLOSE . |
appSpecificErrorCode |
int : the error code specified on close(GoogleApiClient) , or 0 if closeReason is CLOSE_REASON_DISCONNECTED .
|
Called when a channel is closed.
Parameters | |
---|---|
channel |
ChannelClient.Channel : the ChannelClient.Channel that was closed. |
closeReason |
int : the reason for the input closing. One of CLOSE_REASON_DISCONNECTED , CLOSE_REASON_REMOTE_CLOSE , CLOSE_REASON_LOCAL_CLOSE , or CLOSE_REASON_NORMAL . |
appSpecificErrorCode |
int : the error code specified on close(ChannelClient.Channel, int) , or 0 if closeReason is CLOSE_REASON_DISCONNECTED or CLOSE_REASON_NORMAL . |
Called when a new channel is opened by a remote node.
Parameters | |
---|---|
channel |
Channel |
Called when a new channel is opened by a remote node.
Parameters | |
---|---|
channel |
ChannelClient.Channel : the ChannelClient.Channel that was opened. |
See also:
Receives data changed events. The provided buffer will be closed after this method completes.
Use freeze()
on items in the buffer to use them outside of this callscope.
Multiple data events may delivered in a single call and may only contain final-state
modifications of a data item. (Eg, multiple calls to putDataItem changing the value of the data
item's getData()
may only appear as a single event, with the last modification
expressed).
Applications needing to track the of all its data items, may use getDataItems(GoogleApiClient)
on boot to retrieve all existing data items.
Parameters | |
---|---|
dataEvents |
DataEventBuffer |
Called when the input side of a channel is closed.
Parameters | |
---|---|
channel |
Channel |
closeReason |
int : the reason for the input closing. One of CLOSE_REASON_DISCONNECTED , CLOSE_REASON_REMOTE_CLOSE , CLOSE_REASON_LOCAL_CLOSE , or CLOSE_REASON_NORMAL |
appSpecificErrorCode |
int : the error code specified on close(GoogleApiClient) , or 0 if closeReason is CLOSE_REASON_DISCONNECTED or CLOSE_REASON_NORMAL .
|
Called when the input side of a channel is closed.
Parameters | |
---|---|
channel |
ChannelClient.Channel : the ChannelClient.Channel whose input was closed. |
closeReason |
int : the reason for the input closing. One of CLOSE_REASON_DISCONNECTED , CLOSE_REASON_REMOTE_CLOSE , CLOSE_REASON_LOCAL_CLOSE , or CLOSE_REASON_NORMAL . |
appSpecificErrorCode |
int : the error code specified on close(ChannelClient.Channel, int) , or 0 if closeReason is CLOSE_REASON_DISCONNECTED or CLOSE_REASON_NORMAL . |
Receives message events.
Parameters | |
---|---|
messageEvent |
MessageEvent |
Called when the output side of a channel is closed.
Parameters | |
---|---|
channel |
Channel |
closeReason |
int : the reason for the output closing. One of CLOSE_REASON_DISCONNECTED , CLOSE_REASON_REMOTE_CLOSE , CLOSE_REASON_LOCAL_CLOSE , or CLOSE_REASON_NORMAL |
appSpecificErrorCode |
int : the error code specified on close(GoogleApiClient) , or 0 if closeReason is CLOSE_REASON_DISCONNECTED or CLOSE_REASON_NORMAL .
|
Called when the output side of a channel is closed.
Parameters | |
---|---|
channel |
ChannelClient.Channel : the ChannelClient.Channel whose output was closed. |
closeReason |
int : the reason for the output closing. One of CLOSE_REASON_DISCONNECTED , CLOSE_REASON_REMOTE_CLOSE , CLOSE_REASON_LOCAL_CLOSE , or CLOSE_REASON_NORMAL . |
appSpecificErrorCode |
int : the error code specified on close(ChannelClient.Channel, int) , or 0 if closeReason is CLOSE_REASON_DISCONNECTED or CLOSE_REASON_NORMAL . |