added in API level 21

MediaMetadata

public final class MediaMetadata
extends Object implements Parcelable

java.lang.Object
↳	android.media.MediaMetadata

Contains metadata about an item, such as the title, artist, etc.

Summary

Nested classes
`class`	`MediaMetadata.Builder` Use to build MediaMetadata objects.

Constants
`String`	`METADATA_KEY_ALBUM` The album title for the media.
`String`	`METADATA_KEY_ALBUM_ART` The artwork for the album of the media's original source as a `Bitmap`.
`String`	`METADATA_KEY_ALBUM_ARTIST` The artist for the album of the media's original source.
`String`	`METADATA_KEY_ALBUM_ART_URI` The artwork for the album of the media's original source as a Uri formatted String.
`String`	`METADATA_KEY_ART` The artwork for the media as a `Bitmap`.
`String`	`METADATA_KEY_ARTIST` The artist of the media.
`String`	`METADATA_KEY_ART_URI` The artwork for the media as a Uri formatted String.
`String`	`METADATA_KEY_AUTHOR` The author of the media.
`String`	`METADATA_KEY_BT_FOLDER_TYPE` The bluetooth folder type of the media specified in the section 6.10.2.2 of the Bluetooth AVRCP 1.5.
`String`	`METADATA_KEY_COMPILATION` The compilation status of the media.
`String`	`METADATA_KEY_COMPOSER` The composer of the media.
`String`	`METADATA_KEY_DATE` The date the media was created or published.
`String`	`METADATA_KEY_DISC_NUMBER` The disc number for the media's original source.
`String`	`METADATA_KEY_DISPLAY_DESCRIPTION` A description that is suitable for display to the user.
`String`	`METADATA_KEY_DISPLAY_ICON` An icon or thumbnail that is suitable for display to the user.
`String`	`METADATA_KEY_DISPLAY_ICON_URI` A Uri formatted String for an icon or thumbnail that is suitable for display to the user.
`String`	`METADATA_KEY_DISPLAY_SUBTITLE` A subtitle that is suitable for display to the user.
`String`	`METADATA_KEY_DISPLAY_TITLE` A title that is suitable for display to the user.
`String`	`METADATA_KEY_DURATION` The duration of the media in ms.
`String`	`METADATA_KEY_GENRE` The genre of the media.
`String`	`METADATA_KEY_MEDIA_ID` A String key for identifying the content.
`String`	`METADATA_KEY_MEDIA_URI` A Uri formatted String representing the content.
`String`	`METADATA_KEY_NUM_TRACKS` The number of tracks in the media's original source.
`String`	`METADATA_KEY_RATING` The overall rating for the media.
`String`	`METADATA_KEY_TITLE` The title of the media.
`String`	`METADATA_KEY_TRACK_NUMBER` The track number for the media.
`String`	`METADATA_KEY_USER_RATING` The user's rating for the media.
`String`	`METADATA_KEY_WRITER` The writer of the media.
`String`	`METADATA_KEY_YEAR` The year the media was created or published as a long.

Inherited constants

From interface


    android.os.Parcelable

Fields
`public static final Creator<MediaMetadata>`	`CREATOR`

Public methods
`boolean`	`containsKey(String key)` Returns true if the given key is contained in the metadata
`int`	`describeContents()` Describe the kinds of special objects contained in this Parcelable instance's marshaled representation.
`Bitmap`	`getBitmap(String key)` Returns a `Bitmap` for the given key or null if no bitmap exists for the given key.
`MediaDescription`	`getDescription()` Returns a simple description of this metadata for display purposes.
`long`	`getLong(String key)` Returns the value associated with the given key, or 0L if no long exists for the given key.
`Rating`	`getRating(String key)` Returns a `Rating` for the given key or null if no rating exists for the given key.
`String`	`getString(String key)` Returns the text value associated with the given key as a String, or null if no mapping of the desired type exists for the given key or a null value is explicitly associated with the key.
`CharSequence`	`getText(String key)` Returns the value associated with the given key, or null if no mapping of the desired type exists for the given key or a null value is explicitly associated with the key.
`Set<String>`	`keySet()` Returns a Set containing the Strings used as keys in this metadata.
`int`	`size()` Returns the number of fields in this metadata.
`void`	`writeToParcel(Parcel dest, int flags)` Flatten this object in to a Parcel.

Inherited methods

From class


  
    java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long millis, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void`	`wait(long millis)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void`	`wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

From interface


  
    android.os.Parcelable

Constants

METADATA_KEY_ALBUM

added in API level 21

String METADATA_KEY_ALBUM

The album title for the media.

Constant Value: "android.media.metadata.ALBUM"

METADATA_KEY_ALBUM_ART

added in API level 21

String METADATA_KEY_ALBUM_ART

The artwork for the album of the media's original source as a Bitmap.

The artwork should be relatively small and may be scaled down by the system if it is too large. For higher resolution artwork METADATA_KEY_ALBUM_ART_URI should be used instead.

Constant Value: "android.media.metadata.ALBUM_ART"

METADATA_KEY_ALBUM_ARTIST

added in API level 21

String METADATA_KEY_ALBUM_ARTIST

The artist for the album of the media's original source.

Constant Value: "android.media.metadata.ALBUM_ARTIST"

METADATA_KEY_ALBUM_ART_URI

added in API level 21

String METADATA_KEY_ALBUM_ART_URI

The artwork for the album of the media's original source as a Uri formatted String. The artwork can be loaded using a combination of openInputStream(Uri) and decodeStream(InputStream).

For the best results, Uris should use the content:// style and support EXTRA_SIZE for retrieving scaled artwork through openTypedAssetFileDescriptor(Uri, String, Bundle).

Constant Value: "android.media.metadata.ALBUM_ART_URI"

METADATA_KEY_ART

added in API level 21

String METADATA_KEY_ART

The artwork for the media as a Bitmap.

The artwork should be relatively small and may be scaled down by the system if it is too large. For higher resolution artwork METADATA_KEY_ART_URI should be used instead.

Constant Value: "android.media.metadata.ART"

METADATA_KEY_ARTIST

added in API level 21

String METADATA_KEY_ARTIST

The artist of the media.

Constant Value: "android.media.metadata.ARTIST"

METADATA_KEY_ART_URI

added in API level 21

String METADATA_KEY_ART_URI

The artwork for the media as a Uri formatted String. The artwork can be loaded using a combination of openInputStream(Uri) and decodeStream(InputStream).

For the best results, Uris should use the content:// style and support EXTRA_SIZE for retrieving scaled artwork through openTypedAssetFileDescriptor(Uri, String, Bundle).

Constant Value: "android.media.metadata.ART_URI"

METADATA_KEY_AUTHOR

added in API level 21

String METADATA_KEY_AUTHOR

The author of the media.

Constant Value: "android.media.metadata.AUTHOR"

METADATA_KEY_BT_FOLDER_TYPE

Android O Developer Preview

String METADATA_KEY_BT_FOLDER_TYPE

The bluetooth folder type of the media specified in the section 6.10.2.2 of the Bluetooth AVRCP 1.5. It should be one of the following:

Constant Value: "android.media.metadata.BT_FOLDER_TYPE"

METADATA_KEY_COMPILATION

added in API level 21

String METADATA_KEY_COMPILATION

The compilation status of the media.

Constant Value: "android.media.metadata.COMPILATION"

METADATA_KEY_COMPOSER

added in API level 21

String METADATA_KEY_COMPOSER

The composer of the media.

Constant Value: "android.media.metadata.COMPOSER"

METADATA_KEY_DATE

added in API level 21

String METADATA_KEY_DATE

The date the media was created or published. The format is unspecified but RFC 3339 is recommended.

Constant Value: "android.media.metadata.DATE"

METADATA_KEY_DISC_NUMBER

added in API level 21

String METADATA_KEY_DISC_NUMBER

The disc number for the media's original source.

Constant Value: "android.media.metadata.DISC_NUMBER"

METADATA_KEY_DISPLAY_DESCRIPTION

added in API level 21

String METADATA_KEY_DISPLAY_DESCRIPTION

A description that is suitable for display to the user. When displaying more information for media described by this metadata this should be preferred to other fields if present.

Constant Value: "android.media.metadata.DISPLAY_DESCRIPTION"

METADATA_KEY_DISPLAY_ICON

added in API level 21

String METADATA_KEY_DISPLAY_ICON

An icon or thumbnail that is suitable for display to the user. When displaying an icon for media described by this metadata this should be preferred to other fields if present. This must be a Bitmap.

The icon should be relatively small and may be scaled down by the system if it is too large. For higher resolution artwork METADATA_KEY_DISPLAY_ICON_URI should be used instead.

Constant Value: "android.media.metadata.DISPLAY_ICON"

METADATA_KEY_DISPLAY_ICON_URI

added in API level 21

String METADATA_KEY_DISPLAY_ICON_URI

A Uri formatted String for an icon or thumbnail that is suitable for display to the user. When displaying more information for media described by this metadata the display description should be preferred to other fields when present. The icon can be loaded using a combination of openInputStream(Uri) and decodeStream(InputStream).

For the best results, Uris should use the content:// style and support EXTRA_SIZE for retrieving scaled artwork through openTypedAssetFileDescriptor(Uri, String, Bundle).

Constant Value: "android.media.metadata.DISPLAY_ICON_URI"

METADATA_KEY_DISPLAY_SUBTITLE

added in API level 21

String METADATA_KEY_DISPLAY_SUBTITLE

A subtitle that is suitable for display to the user. When displaying a second line for media described by this metadata this should be preferred to other fields if present.

Constant Value: "android.media.metadata.DISPLAY_SUBTITLE"

METADATA_KEY_DISPLAY_TITLE

added in API level 21

String METADATA_KEY_DISPLAY_TITLE

A title that is suitable for display to the user. This will generally be the same as METADATA_KEY_TITLE but may differ for some formats. When displaying media described by this metadata this should be preferred if present.

Constant Value: "android.media.metadata.DISPLAY_TITLE"

METADATA_KEY_DURATION

added in API level 21

String METADATA_KEY_DURATION

The duration of the media in ms. A negative duration indicates that the duration is unknown (or infinite).

Constant Value: "android.media.metadata.DURATION"

METADATA_KEY_GENRE

added in API level 21

String METADATA_KEY_GENRE

The genre of the media.

Constant Value: "android.media.metadata.GENRE"

METADATA_KEY_MEDIA_ID

added in API level 21

String METADATA_KEY_MEDIA_ID

A String key for identifying the content. This value is specific to the service providing the content. If used, this should be a persistent unique key for the underlying content. It may be used with playFromMediaId(String, Bundle) to initiate playback when provided by a MediaBrowser connected to the same app.

Constant Value: "android.media.metadata.MEDIA_ID"

METADATA_KEY_MEDIA_URI

Android O Developer Preview

String METADATA_KEY_MEDIA_URI

A Uri formatted String representing the content. This value is specific to the service providing the content. It may be used with playFromUri(Uri, Bundle) to initiate playback when provided by a MediaBrowser connected to the same app.

Constant Value: "android.media.metadata.MEDIA_URI"

METADATA_KEY_NUM_TRACKS

added in API level 21

String METADATA_KEY_NUM_TRACKS

The number of tracks in the media's original source.

Constant Value: "android.media.metadata.NUM_TRACKS"

METADATA_KEY_RATING

added in API level 21

String METADATA_KEY_RATING

The overall rating for the media.

See also:

Rating

Constant Value: "android.media.metadata.RATING"

METADATA_KEY_TITLE

added in API level 21

String METADATA_KEY_TITLE

The title of the media.

Constant Value: "android.media.metadata.TITLE"

METADATA_KEY_TRACK_NUMBER

added in API level 21

String METADATA_KEY_TRACK_NUMBER

The track number for the media.

Constant Value: "android.media.metadata.TRACK_NUMBER"

METADATA_KEY_USER_RATING

added in API level 21

String METADATA_KEY_USER_RATING

The user's rating for the media.

See also:

Rating

Constant Value: "android.media.metadata.USER_RATING"

METADATA_KEY_WRITER

added in API level 21

String METADATA_KEY_WRITER

The writer of the media.

Constant Value: "android.media.metadata.WRITER"

METADATA_KEY_YEAR

added in API level 21

String METADATA_KEY_YEAR

The year the media was created or published as a long.

Constant Value: "android.media.metadata.YEAR"

Fields

CREATOR

added in API level 21

Creator<MediaMetadata> CREATOR

Public methods

containsKey

added in API level 21

boolean containsKey (String key)

Returns true if the given key is contained in the metadata

Parameters
`key`	`String`: a String key

Returns
`boolean`	true if the key exists in this metadata, false otherwise

describeContents

added in API level 21

int describeContents ()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. For example, if the object will include a file descriptor in the output of writeToParcel(Parcel, int), the return value of this method must include the CONTENTS_FILE_DESCRIPTOR bit.

Returns
`int`	a bitmask indicating the set of special object types marshaled by this Parcelable object instance.

getBitmap

added in API level 21

Bitmap getBitmap (String key)

Returns a Bitmap for the given key or null if no bitmap exists for the given key.

Parameters
`key`	`String`: The key the value is stored under

Returns
`Bitmap`	A `Bitmap` or null

getDescription

added in API level 21

MediaDescription getDescription ()

Returns a simple description of this metadata for display purposes.

Returns
`MediaDescription`	A simple description of this metadata. This value will never be `null`.

getLong

added in API level 21

long getLong (String key)

Returns the value associated with the given key, or 0L if no long exists for the given key.

Parameters
`key`	`String`: The key the value is stored under

Returns
`long`	a long value

getRating

added in API level 21

Rating getRating (String key)

Returns a Rating for the given key or null if no rating exists for the given key.

Parameters
`key`	`String`: The key the value is stored under

Returns
`Rating`	A `Rating` or null

getString

added in API level 21

String getString (String key)

Returns the text value associated with the given key as a String, or null if no mapping of the desired type exists for the given key or a null value is explicitly associated with the key. This is equivalent to calling getText().toString() if the value is not null.

Parameters
`key`	`String`: The key the value is stored under

Returns
`String`	a String value, or null

getText

added in API level 21

CharSequence getText (String key)

Returns the value associated with the given key, or null if no mapping of the desired type exists for the given key or a null value is explicitly associated with the key.

Parameters
`key`	`String`: The key the value is stored under

Returns
`CharSequence`	a CharSequence value, or null

keySet

added in API level 21

Set<String> keySet ()

Returns a Set containing the Strings used as keys in this metadata.

Returns
`Set<String>`	a Set of String keys

size

added in API level 21

int size ()

Returns the number of fields in this metadata.

Returns
`int`	The number of fields in the metadata.

writeToParcel

added in API level 21

void writeToParcel (Parcel dest, 
                int flags)

Flatten this object in to a Parcel.

Parameters
`dest`	`Parcel`: The Parcel in which the object should be written.
`flags`	`int`: Additional flags about how the object should be written. May be 0 or `PARCELABLE_WRITE_RETURN_VALUE`.

Jun	JUL	Aug
	18
2016	2017	2018

MediaMetadata

Summary

Nested classes

Constants

Inherited constants

Fields

Public methods

Inherited methods

Constants

METADATA_KEY_ALBUM

METADATA_KEY_ALBUM_ART

METADATA_KEY_ALBUM_ARTIST

METADATA_KEY_ALBUM_ART_URI

METADATA_KEY_ART

METADATA_KEY_ARTIST

METADATA_KEY_ART_URI

METADATA_KEY_AUTHOR

METADATA_KEY_BT_FOLDER_TYPE

METADATA_KEY_COMPILATION

METADATA_KEY_COMPOSER

METADATA_KEY_DATE

METADATA_KEY_DISC_NUMBER

METADATA_KEY_DISPLAY_DESCRIPTION

METADATA_KEY_DISPLAY_ICON

METADATA_KEY_DISPLAY_ICON_URI

METADATA_KEY_DISPLAY_SUBTITLE

METADATA_KEY_DISPLAY_TITLE

METADATA_KEY_DURATION

METADATA_KEY_GENRE

METADATA_KEY_MEDIA_ID

METADATA_KEY_MEDIA_URI

METADATA_KEY_NUM_TRACKS

METADATA_KEY_RATING

METADATA_KEY_TITLE

METADATA_KEY_TRACK_NUMBER

METADATA_KEY_USER_RATING

METADATA_KEY_WRITER

METADATA_KEY_YEAR

Fields

CREATOR

Public methods

containsKey

describeContents

getBitmap

getDescription

getLong

getRating

getString

getText

keySet

size

writeToParcel

Interfaces

Classes

Exceptions