public
final
class
MediaMetadataCompat
extends Object
implements
Parcelable
java.lang.Object | |
↳ | android.support.v4.media.MediaMetadataCompat |
Contains metadata about an item, such as the title, artist, etc.
Nested classes | |
---|---|
class |
MediaMetadataCompat.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
|
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 style String. |
String |
METADATA_KEY_ART
The artwork for the media as a |
String |
METADATA_KEY_ARTIST
The artist of the media. |
String |
METADATA_KEY_ART_URI
The artwork for the media as a Uri style String. |
String |
METADATA_KEY_AUTHOR
The author of the media. |
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
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_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<MediaMetadataCompat> |
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. |
static
MediaMetadataCompat
|
fromMediaMetadata(Object metadataObj)
Creates an instance from a framework |
Bitmap
|
getBitmap(String key)
Return a |
Bundle
|
getBundle()
Gets the bundle backing the metadata object. |
MediaDescriptionCompat
|
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. |
Object
|
getMediaMetadata()
Gets the underlying framework |
RatingCompat
|
getRating(String key)
Return a |
String
|
getString(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. |
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()
Get 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
| |
From
interface
android.os.Parcelable
|
String METADATA_KEY_ALBUM
The album title for the media.
Constant Value: "android.media.metadata.ALBUM"
String METADATA_KEY_ALBUM_ART
The artwork for the album of the media's original source as a
Bitmap
.
Constant Value: "android.media.metadata.ALBUM_ART"
String METADATA_KEY_ALBUM_ARTIST
The artist for the album of the media's original source.
Constant Value: "android.media.metadata.ALBUM_ARTIST"
String METADATA_KEY_ALBUM_ART_URI
The artwork for the album of the media's original source as a Uri style String.
Constant Value: "android.media.metadata.ALBUM_ART_URI"
String METADATA_KEY_ART
The artwork for the media as a Bitmap
.
Constant Value: "android.media.metadata.ART"
String METADATA_KEY_ARTIST
The artist of the media.
Constant Value: "android.media.metadata.ARTIST"
String METADATA_KEY_ART_URI
The artwork for the media as a Uri style String.
Constant Value: "android.media.metadata.ART_URI"
String METADATA_KEY_AUTHOR
The author of the media.
Constant Value: "android.media.metadata.AUTHOR"
String METADATA_KEY_COMPILATION
The compilation status of the media.
Constant Value: "android.media.metadata.COMPILATION"
String METADATA_KEY_COMPOSER
The composer of the media.
Constant Value: "android.media.metadata.COMPOSER"
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"
String METADATA_KEY_DISC_NUMBER
The disc number for the media's original source.
Constant Value: "android.media.metadata.DISC_NUMBER"
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"
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
.
Constant Value: "android.media.metadata.DISPLAY_ICON"
String METADATA_KEY_DISPLAY_ICON_URI
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. This must be a Uri style String.
Constant Value: "android.media.metadata.DISPLAY_ICON_URI"
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"
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"
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"
String METADATA_KEY_GENRE
The genre of the media.
Constant Value: "android.media.metadata.GENRE"
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.
Constant Value: "android.media.metadata.MEDIA_ID"
String METADATA_KEY_NUM_TRACKS
The number of tracks in the media's original source.
Constant Value: "android.media.metadata.NUM_TRACKS"
String METADATA_KEY_RATING
The overall rating for the media.
See also:
Constant Value: "android.media.metadata.RATING"
String METADATA_KEY_TITLE
The title of the media.
Constant Value: "android.media.metadata.TITLE"
String METADATA_KEY_TRACK_NUMBER
The track number for the media.
Constant Value: "android.media.metadata.TRACK_NUMBER"
String METADATA_KEY_USER_RATING
The user's rating for the media.
See also:
Constant Value: "android.media.metadata.USER_RATING"
String METADATA_KEY_WRITER
The writer of the media.
Constant Value: "android.media.metadata.WRITER"
String METADATA_KEY_YEAR
The year the media was created or published as a long.
Constant Value: "android.media.metadata.YEAR"
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 |
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. |
MediaMetadataCompat fromMediaMetadata (Object metadataObj)
Creates an instance from a framework MediaMetadata
object.
This method is only supported on
LOLLIPOP
and later.
Parameters | |
---|---|
metadataObj |
Object :
A MediaMetadata object, or null
if none. |
Returns | |
---|---|
MediaMetadataCompat |
An equivalent MediaMetadataCompat object, or null if
none.
|
Bitmap getBitmap (String key)
Return 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
|
Bundle getBundle ()
Gets the bundle backing the metadata object. This is available to support backwards compatibility. Apps should not modify the bundle directly.
Returns | |
---|---|
Bundle |
The Bundle backing this metadata. |
MediaDescriptionCompat getDescription ()
Returns a simple description of this metadata for display purposes.
Returns | |
---|---|
MediaDescriptionCompat |
A simple description of this metadata. |
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 |
Object getMediaMetadata ()
Gets the underlying framework MediaMetadata
object.
This method is only supported on
LOLLIPOP
and later.
Returns | |
---|---|
Object |
An equivalent MediaMetadata object, or null
if none.
|
RatingCompat getRating (String key)
Return a RatingCompat
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 | |
---|---|
RatingCompat |
A RatingCompat or null
|
String getString (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 | |
---|---|
String |
a String value, or null |
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 |
Set<String> keySet ()
Returns a Set containing the Strings used as keys in this metadata.
Returns | |
---|---|
Set<String> |
a Set of String keys |
int size ()
Get the number of fields in this metadata.
Returns | |
---|---|
int |
The number of fields in the metadata. |
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 .
|