Developers
Most visited
Recently visited
MediaMetadata.Builder
public
static
final
class
MediaMetadata.Builder
extends Object
| java.lang.Object | |
| ↳ | android.media.MediaMetadata.Builder |
Use to build MediaMetadata objects. The system defined metadata keys must use the appropriate data type.
Summary
Public constructors | |
|---|---|
Builder()
Create an empty Builder. |
|
Builder(MediaMetadata source)
Create a Builder using a |
|
Public methods | |
|---|---|
MediaMetadata
|
build()
Creates a |
MediaMetadata.Builder
|
putBitmap(String key, Bitmap value)
Put a |
MediaMetadata.Builder
|
putLong(String key, long value)
Put a long value into the metadata. |
MediaMetadata.Builder
|
putRating(String key, Rating value)
Put a |
MediaMetadata.Builder
|
putString(String key, String value)
Put a String value into the metadata. |
MediaMetadata.Builder
|
putText(String key, CharSequence value)
Put a CharSequence value into the metadata. |
Inherited methods | |
|---|---|
Public constructors
Builder
public Builder ()
Create an empty Builder. Any field that should be included in the
MediaMetadata must be added.
Builder
public Builder (MediaMetadata source)
Create a Builder using a MediaMetadata instance to set the
initial values. All fields in the source metadata will be included in
the new metadata. Fields can be overwritten by adding the same key.
Public methods
build
public MediaMetadata build ()
Creates a MediaMetadata instance with the specified fields.
| Returns | |
|---|---|
MediaMetadata |
The new MediaMetadata instance |
putBitmap
public MediaMetadata.Builder putBitmap (String key, Bitmap value)
Put a Bitmap into the metadata. Custom keys may be used, but
if the METADATA_KEYs defined in this class are used they may only be
one of the following:
MediaMetadata.METADATA_KEY_ARTMediaMetadata.METADATA_KEY_ALBUM_ARTMediaMetadata.METADATA_KEY_DISPLAY_ICON
Large bitmaps may be scaled down by the system when
MediaSession.setMetadata(MediaMetadata) is called.
To pass full resolution images Uri should be used with
putString(String, String).
| Parameters | |
|---|---|
key |
String: The key for referencing this value
Value is MediaMetadata.METADATA_KEY_ART, MediaMetadata.METADATA_KEY_ALBUM_ART, or MediaMetadata.METADATA_KEY_DISPLAY_ICON |
value |
Bitmap: The Bitmap to store |
| Returns | |
|---|---|
MediaMetadata.Builder |
The Builder to allow chaining |
putLong
public MediaMetadata.Builder putLong (String key, long value)
Put a long value into the metadata. Custom keys may be used, but if the METADATA_KEYs defined in this class are used they may only be one of the following:
MediaMetadata.METADATA_KEY_DURATIONMediaMetadata.METADATA_KEY_TRACK_NUMBERMediaMetadata.METADATA_KEY_NUM_TRACKSMediaMetadata.METADATA_KEY_DISC_NUMBERMediaMetadata.METADATA_KEY_YEAR
| Parameters | |
|---|---|
key |
String: The key for referencing this value
Value is MediaMetadata.METADATA_KEY_DURATION, MediaMetadata.METADATA_KEY_YEAR, MediaMetadata.METADATA_KEY_TRACK_NUMBER, MediaMetadata.METADATA_KEY_NUM_TRACKS, MediaMetadata.METADATA_KEY_DISC_NUMBER, or MediaMetadata.METADATA_KEY_BT_FOLDER_TYPE |
value |
long: The long value to store |
| Returns | |
|---|---|
MediaMetadata.Builder |
The Builder to allow chaining |
putRating
public MediaMetadata.Builder putRating (String key, Rating value)
Put a Rating into the metadata. Custom keys may be used, but
if the METADATA_KEYs defined in this class are used they may only be
one of the following:
| Parameters | |
|---|---|
key |
String: The key for referencing this value
Value is MediaMetadata.METADATA_KEY_USER_RATING, or MediaMetadata.METADATA_KEY_RATING |
value |
Rating: The Rating value to store |
| Returns | |
|---|---|
MediaMetadata.Builder |
The Builder to allow chaining |
putString
public MediaMetadata.Builder putString (String key, String value)
Put a String value into the metadata. Custom keys may be used, but if the METADATA_KEYs defined in this class are used they may only be one of the following:
MediaMetadata.METADATA_KEY_TITLEMediaMetadata.METADATA_KEY_ARTISTMediaMetadata.METADATA_KEY_ALBUMMediaMetadata.METADATA_KEY_AUTHORMediaMetadata.METADATA_KEY_WRITERMediaMetadata.METADATA_KEY_COMPOSERMediaMetadata.METADATA_KEY_DATEMediaMetadata.METADATA_KEY_GENREMediaMetadata.METADATA_KEY_ALBUM_ARTISTMediaMetadata.METADATA_KEY_ART_URIMediaMetadata.METADATA_KEY_ALBUM_ART_URIMediaMetadata.METADATA_KEY_DISPLAY_TITLEMediaMetadata.METADATA_KEY_DISPLAY_SUBTITLEMediaMetadata.METADATA_KEY_DISPLAY_DESCRIPTIONMediaMetadata.METADATA_KEY_DISPLAY_ICON_URI
Uris for artwork should use the content:// style and support
ContentResolver#EXTRA_SIZE for retrieving scaled artwork
through ContentResolver#openTypedAssetFileDescriptor(Uri,
String, Bundle).
| Returns | |
|---|---|
MediaMetadata.Builder |
The Builder to allow chaining |
putText
public MediaMetadata.Builder putText (String key, CharSequence value)
Put a CharSequence value into the metadata. Custom keys may be used, but if the METADATA_KEYs defined in this class are used they may only be one of the following:
MediaMetadata.METADATA_KEY_TITLEMediaMetadata.METADATA_KEY_ARTISTMediaMetadata.METADATA_KEY_ALBUMMediaMetadata.METADATA_KEY_AUTHORMediaMetadata.METADATA_KEY_WRITERMediaMetadata.METADATA_KEY_COMPOSERMediaMetadata.METADATA_KEY_DATEMediaMetadata.METADATA_KEY_GENREMediaMetadata.METADATA_KEY_ALBUM_ARTISTMediaMetadata.METADATA_KEY_ART_URIMediaMetadata.METADATA_KEY_ALBUM_ART_URIMediaMetadata.METADATA_KEY_DISPLAY_TITLEMediaMetadata.METADATA_KEY_DISPLAY_SUBTITLEMediaMetadata.METADATA_KEY_DISPLAY_DESCRIPTIONMediaMetadata.METADATA_KEY_DISPLAY_ICON_URI
| Returns | |
|---|---|
MediaMetadata.Builder |
The Builder to allow chaining |