public class

RemoteControlClient.MetadataEditor

extends Object
java.lang.Object
   ↳ android.media.RemoteControlClient.MetadataEditor

Class Overview

Class used to modify metadata in a RemoteControlClient object. Use editMetadata(boolean) to create an instance of an editor, on which you set the metadata for the RemoteControlClient instance. Once all the information has been set, use apply() to make it the new metadata that should be displayed for the associated client. Once the metadata has been "applied", you cannot reuse this instance of the MetadataEditor.

Summary

Constants
int BITMAP_KEY_ARTWORK The metadata key for the content artwork / album art.
Public Methods
synchronized void apply()
Associates all the metadata that has been set since the MetadataEditor instance was created with editMetadata(boolean), or since clear() was called, with the RemoteControlClient.
synchronized void clear()
Clears all the metadata that has been set since the MetadataEditor instance was created with editMetadata(boolean).
synchronized RemoteControlClient.MetadataEditor putBitmap(int key, Bitmap bitmap)
Sets the album / artwork picture to be displayed on the remote control.
synchronized RemoteControlClient.MetadataEditor putLong(int key, long value)
Adds numerical information to be displayed.
synchronized RemoteControlClient.MetadataEditor putString(int key, String value)
Adds textual information to be displayed.
[Expand]
Inherited Methods
From class java.lang.Object

Constants

public static final int BITMAP_KEY_ARTWORK

Since: API Level 14

The metadata key for the content artwork / album art.

Constant Value: 100 (0x00000064)

Public Methods

public synchronized void apply ()

Since: API Level 14

Associates all the metadata that has been set since the MetadataEditor instance was created with editMetadata(boolean), or since clear() was called, with the RemoteControlClient. Once "applied", this MetadataEditor cannot be reused to edit the RemoteControlClient's metadata.

public synchronized void clear ()

Since: API Level 14

Clears all the metadata that has been set since the MetadataEditor instance was created with editMetadata(boolean).

public synchronized RemoteControlClient.MetadataEditor putBitmap (int key, Bitmap bitmap)

Since: API Level 14

Sets the album / artwork picture to be displayed on the remote control.

Parameters
key the identifier of the bitmap to set. The only valid value is BITMAP_KEY_ARTWORK
bitmap The bitmap for the artwork, or null if there isn't any.
Returns
  • Returns a reference to the same MetadataEditor object, so you can chain put calls together.
Throws
IllegalArgumentException
IllegalArgumentException
See Also

public synchronized RemoteControlClient.MetadataEditor putLong (int key, long value)

Since: API Level 14

Adds numerical information to be displayed. Note that none of the information added after apply() has been called, will be displayed.

Parameters
key the identifier of a the metadata field to set. Valid values are METADATA_KEY_CD_TRACK_NUMBER, METADATA_KEY_DISC_NUMBER, METADATA_KEY_DURATION (with a value expressed in milliseconds), METADATA_KEY_YEAR.
value The long value for the given key
Returns
  • Returns a reference to the same MetadataEditor object, so you can chain put calls together.
Throws
IllegalArgumentException

public synchronized RemoteControlClient.MetadataEditor putString (int key, String value)

Since: API Level 14

Adds textual information to be displayed. Note that none of the information added after apply() has been called, will be displayed.

Parameters
key The identifier of a the metadata field to set. Valid values are METADATA_KEY_ALBUM, METADATA_KEY_ALBUMARTIST, METADATA_KEY_TITLE, METADATA_KEY_ARTIST, METADATA_KEY_AUTHOR, METADATA_KEY_COMPILATION, METADATA_KEY_COMPOSER, METADATA_KEY_DATE, METADATA_KEY_GENRE, METADATA_KEY_TITLE, METADATA_KEY_WRITER.
value The text for the given key, or null to signify there is no valid information for the field.
Returns
  • Returns a reference to the same MetadataEditor object, so you can chain put calls together.
Throws
IllegalArgumentException