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)
Android APIs
public static interface

RemoteController.OnClientUpdateListener

android.media.RemoteController.OnClientUpdateListener

Class Overview

Interface definition for the callbacks to be invoked whenever media events, metadata and playback status are available.

Summary

Public Methods
abstract void onClientChange (boolean clearing)
Called whenever all information, previously received through the other methods of the listener, is no longer valid and is about to be refreshed.
abstract void onClientMetadataUpdate ( RemoteController.MetadataEditor metadataEditor)
Called whenever new metadata is available.
abstract void onClientPlaybackStateUpdate (int state, long stateChangeTimeMs, long currentPosMs, float speed)
Called whenever the playback state has changed, and playback position and speed are known.
abstract void onClientPlaybackStateUpdate (int state)
Called whenever the playback state has changed.
abstract void onClientTransportControlUpdate (int transportControlFlags)
Called whenever the transport control flags have changed.

Public Methods

public abstract void onClientChange (boolean clearing)

Called whenever all information, previously received through the other methods of the listener, is no longer valid and is about to be refreshed. This is typically called whenever a new RemoteControlClient has been selected by the system to have its media information published.

Parameters
clearing true if there is no selected RemoteControlClient and no information is available.

public abstract void onClientMetadataUpdate ( RemoteController.MetadataEditor metadataEditor)

Called whenever new metadata is available. See the putLong(int, long) , putString(int, String) , putBitmap(int, Bitmap) , and putObject(int, Object) methods for the various keys that can be queried.

Parameters
metadataEditor the container of the new metadata.

public abstract void onClientPlaybackStateUpdate (int state, long stateChangeTimeMs, long currentPosMs, float speed)

Called whenever the playback state has changed, and playback position and speed are known.

Parameters
state one of the playback states authorized in setPlaybackState(int) .
stateChangeTimeMs the system time at which the state change was reported, expressed in ms. Based on elapsedRealtime() .
currentPosMs a positive value for the current media playback position expressed in ms, a negative value if the position is temporarily unknown.
speed a value expressed as a ratio of 1x playback: 1.0f is normal playback, 2.0f is 2x, 0.5f is half-speed, -2.0f is rewind at 2x speed. 0.0f means nothing is playing (e.g. when state is PLAYSTATE_ERROR ).

public abstract void onClientPlaybackStateUpdate (int state)

Called whenever the playback state has changed. It is called when no information is known about the playback progress in the media and the playback speed.

Parameters
state one of the playback states authorized in setPlaybackState(int) .

public abstract void onClientTransportControlUpdate (int transportControlFlags)

Called whenever the transport control flags have changed.

Parameters
transportControlFlags one of the flags authorized in setTransportControlFlags(int) .