Overview

Use to build MediaMetadatax objects. The system defined metadata keys must use the appropriate data type.

Summary

Constructors
public	Builder() Create an empty Builder.
public	Builder(MediaMetadata source) Create a Builder using a MediaMetadata instance to set the initial values.

Methods
public MediaMetadata	build() Creates a MediaMetadata instance with the specified fields.
public MediaMetadata.Builder	putBitmap(java.lang.String key, Bitmap value) Put a Bitmap into the metadata.
public MediaMetadata.Builder	putFloat(java.lang.String key, float value) Put a float value into the metadata.
public MediaMetadata.Builder	putLong(java.lang.String key, long value) Put a long value into the metadata.
public MediaMetadata.Builder	putRating(java.lang.String key, Rating value) Put a Rating into the metadata.
public MediaMetadata.Builder	putString(java.lang.String key, java.lang.String value) Put a String value into the metadata.
public MediaMetadata.Builder	putText(java.lang.String key, java.lang.CharSequence value) Put a CharSequence value into the metadata.
public MediaMetadata.Builder	setExtras(Bundle extras) Set a bundle of extras.
from java.lang.Object	clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors

Create an empty Builder. Any field that should be included in the MediaMetadata must be added.

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.

Parameters:

source:

Methods

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_TITLE
• MediaMetadata.METADATA_KEY_ARTIST
• MediaMetadata.METADATA_KEY_ALBUM
• MediaMetadata.METADATA_KEY_AUTHOR
• MediaMetadata.METADATA_KEY_WRITER
• MediaMetadata.METADATA_KEY_COMPOSER
• MediaMetadata.METADATA_KEY_COMPILATION
• MediaMetadata.METADATA_KEY_DATE
• MediaMetadata.METADATA_KEY_GENRE
• MediaMetadata.METADATA_KEY_ALBUM_ARTIST
• MediaMetadata.METADATA_KEY_ART_URI
• MediaMetadata.METADATA_KEY_ALBUM_ART_URI
• MediaMetadata.METADATA_KEY_DISPLAY_TITLE
• MediaMetadata.METADATA_KEY_DISPLAY_SUBTITLE
• MediaMetadata.METADATA_KEY_DISPLAY_DESCRIPTION
• MediaMetadata.METADATA_KEY_DISPLAY_ICON_URI
• MediaMetadata.METADATA_KEY_MEDIA_ID
• MediaMetadata.METADATA_KEY_MEDIA_URI

Parameters:

key: The key for referencing this value
value: The CharSequence value to store

Returns:

The Builder to allow chaining

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_TITLE
• MediaMetadata.METADATA_KEY_ARTIST
• MediaMetadata.METADATA_KEY_ALBUM
• MediaMetadata.METADATA_KEY_AUTHOR
• MediaMetadata.METADATA_KEY_WRITER
• MediaMetadata.METADATA_KEY_COMPOSER
• MediaMetadata.METADATA_KEY_COMPILATION
• MediaMetadata.METADATA_KEY_DATE
• MediaMetadata.METADATA_KEY_GENRE
• MediaMetadata.METADATA_KEY_ALBUM_ARTIST
• MediaMetadata.METADATA_KEY_ART_URI
• MediaMetadata.METADATA_KEY_ALBUM_ART_URI
• MediaMetadata.METADATA_KEY_DISPLAY_TITLE
• MediaMetadata.METADATA_KEY_DISPLAY_SUBTITLE
• MediaMetadata.METADATA_KEY_DISPLAY_DESCRIPTION
• MediaMetadata.METADATA_KEY_DISPLAY_ICON_URI
• MediaMetadata.METADATA_KEY_MEDIA_ID
• MediaMetadata.METADATA_KEY_MEDIA_URI

Parameters:

key: The key for referencing this value
value: The String value to store

Returns:

The Builder to allow chaining

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_DURATION
• MediaMetadata.METADATA_KEY_TRACK_NUMBER
• MediaMetadata.METADATA_KEY_NUM_TRACKS
• MediaMetadata.METADATA_KEY_DISC_NUMBER
• MediaMetadata.METADATA_KEY_YEAR
• MediaMetadata.METADATA_KEY_BROWSABLE
• MediaMetadata.METADATA_KEY_PLAYABLE
• MediaMetadata.METADATA_KEY_ADVERTISEMENT
• MediaMetadata.METADATA_KEY_DOWNLOAD_STATUS

Parameters:

key: The key for referencing this value
value: The String value to store

Returns:

The Builder to allow chaining

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:

• MediaMetadata.METADATA_KEY_RATING
• MediaMetadata.METADATA_KEY_USER_RATING

Parameters:

key: The key for referencing this value
value: The String value to store

Returns:

The Builder to allow chaining

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_ART
• MediaMetadata.METADATA_KEY_ALBUM_ART
• MediaMetadata.METADATA_KEY_DISPLAY_ICON

Large bitmaps may be scaled down when it is passed to the other process. To pass full resolution images should be used with MediaMetadata.Builder.putString(String, String).

Parameters:

key: The key for referencing this value
value: The Bitmap to store

Returns:

The Builder to allow chaining

Put a float value into the metadata. Custom keys may be used.

Parameters:

key: The key for referencing this value
value: The float value to store

Returns:

The Builder to allow chaining

Set a bundle of extras.

Parameters:

extras: The extras to include with this description or null.

Returns:

The Builder to allow chaining

Creates a MediaMetadata instance with the specified fields.

Returns:

The new MediaMetadatax instance