Added in API level 19
Deprecated in API level 29

OnClientUpdateListener


interface OnClientUpdateListener
android.media.RemoteController.OnClientUpdateListener

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

Summary

Public methods
abstract Unit

Called whenever all information, previously received through the other methods of the listener, is no longer valid and is about to be refreshed.

abstract Unit

Called whenever new metadata is available.

abstract Unit

Called whenever the playback state has changed.

abstract Unit
onClientPlaybackStateUpdate(state: Int, stateChangeTimeMs: Long, currentPosMs: Long, speed: Float)

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

abstract Unit
onClientTransportControlUpdate(transportControlFlags: Int)

Called whenever the transport control flags have changed.

Public methods

onClientChange

Added in API level 19
abstract fun onClientChange(clearing: Boolean): Unit

Deprecated: Deprecated in Java.

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 Boolean: true if there is no selected RemoteControlClient and no information is available.

onClientMetadataUpdate

Added in API level 19
abstract fun onClientMetadataUpdate(metadataEditor: RemoteController.MetadataEditor!): Unit

Deprecated: Deprecated in Java.

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

Parameters
metadataEditor RemoteController.MetadataEditor!: the container of the new metadata.

onClientPlaybackStateUpdate

Added in API level 19
abstract fun onClientPlaybackStateUpdate(state: Int): Unit

Deprecated: Deprecated in Java.

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 Int: one of the playback states authorized in RemoteControlClient#setPlaybackState(int).

onClientPlaybackStateUpdate

Added in API level 19
abstract fun onClientPlaybackStateUpdate(
    state: Int,
    stateChangeTimeMs: Long,
    currentPosMs: Long,
    speed: Float
): Unit

Deprecated: Deprecated in Java.

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

Parameters
state Int: one of the playback states authorized in RemoteControlClient#setPlaybackState(int).
stateChangeTimeMs Long: the system time at which the state change was reported, expressed in ms. Based on android.os.SystemClock#elapsedRealtime().
currentPosMs Long: a positive value for the current media playback position expressed in ms, a negative value if the position is temporarily unknown.
speed Float: 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 RemoteControlClient#PLAYSTATE_ERROR).

onClientTransportControlUpdate

Added in API level 19
abstract fun onClientTransportControlUpdate(transportControlFlags: Int): Unit

Deprecated: Deprecated in Java.

Called whenever the transport control flags have changed.

Parameters
transportControlFlags Int: one of the flags authorized in RemoteControlClient#setTransportControlFlags(int).