public static final class MediaMetadata.Builder extends Object
Constructor and Description |
---|
Builder()
Create an empty Builder.
|
Builder(MediaMetadata source)
Create a Builder using a
MediaMetadata instance to set the
initial values. |
Builder(MediaMetadata source,
int maxBitmapSize)
Create a Builder using a
MediaMetadata instance to set
initial values, but replace bitmaps with a scaled down copy if they
are larger than maxBitmapSize. |
Modifier and Type | Method and Description |
---|---|
MediaMetadata |
build()
Creates a
MediaMetadata instance with the specified fields. |
MediaMetadata.Builder |
putBitmap(String key,
Bitmap value)
Put a
Bitmap into the metadata. |
MediaMetadata.Builder |
putLong(String key,
long value)
Put a long value into the metadata.
|
MediaMetadata.Builder |
putRating(String key,
Rating value)
Put a
Rating into the metadata. |
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.
|
public Builder()
MediaMetadata
must be added.public Builder(MediaMetadata source)
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.source
- public Builder(MediaMetadata source, int maxBitmapSize)
MediaMetadata
instance to set
initial values, but replace bitmaps with a scaled down copy if they
are larger than maxBitmapSize.source
- The original metadata to copy.maxBitmapSize
- The maximum height/width for bitmaps contained
in the metadata.public MediaMetadata.Builder putText(String key, CharSequence value)
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_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
key
- The key for referencing this valuevalue
- The CharSequence value to storepublic MediaMetadata.Builder putString(String key, String value)
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_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
Uris for artwork should use the content:// style and support
ContentResolver.EXTRA_SIZE
for retrieving scaled artwork
through ContentResolver.openTypedAssetFileDescriptor(Uri,
String, Bundle)
.
key
- The key for referencing this valuevalue
- The String value to storepublic MediaMetadata.Builder putLong(String key, long value)
key
- The key for referencing this valuevalue
- The long value to storepublic MediaMetadata.Builder putRating(String key, Rating value)
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:
key
- The key for referencing this valuevalue
- The Rating value to storepublic MediaMetadata.Builder putBitmap(String key, Bitmap value)
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 by the system. To pass full
resolution images Uris
should be used with
putString(java.lang.String, java.lang.String)
.
key
- The key for referencing this valuevalue
- The Bitmap to storepublic MediaMetadata build()
MediaMetadata
instance with the specified fields.