public static final class MediaMetadata.Builder
extends Object
java.lang.Object | |
↳ | android.media.MediaMetadata.Builder |
用于构建MediaMetadata对象。 系统定义的元数据密钥必须使用适当的数据类型。
Public constructors |
|
---|---|
MediaMetadata.Builder() 创建一个空的生成器。 |
|
MediaMetadata.Builder(MediaMetadata source) 使用 |
Public methods |
|
---|---|
MediaMetadata |
build() 用指定的字段创建一个 |
MediaMetadata.Builder |
putBitmap(String key, Bitmap value) 将一个 |
MediaMetadata.Builder |
putLong(String key, long value) 将长期价值放入元数据中。 |
MediaMetadata.Builder |
putRating(String key, Rating value) 将 |
MediaMetadata.Builder |
putString(String key, String value) 将一个字符串值放入元数据中。 |
MediaMetadata.Builder |
putText(String key, CharSequence value) 将CharSequence值放入元数据中。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
MediaMetadata.Builder ()
创建一个空的生成器。 必须添加应包含在MediaMetadata
中的任何字段。
MediaMetadata.Builder (MediaMetadata source)
使用MediaMetadata
实例创建一个Builder来设置初始值。 源元数据中的所有字段都将包含在新的元数据中。 通过添加相同的密钥可以覆盖字段。
MediaMetadata build ()
用指定的字段创建一个 MediaMetadata
实例。
Returns | |
---|---|
MediaMetadata |
The new MediaMetadata instance |
MediaMetadata.Builder putBitmap (String key, Bitmap value)
将Bitmap
放入元数据中。 可以使用自定义键,但如果使用此类中定义的METADATA_KEYs,它们可能只是以下之一:
大型位图可能会被系统缩小。 要传递全分辨率图像Uris
应与putString(String, String)
一起使用。
Parameters | |
---|---|
key |
String : The key for referencing this value |
value |
Bitmap : The Bitmap to store |
Returns | |
---|---|
MediaMetadata.Builder |
The Builder to allow chaining |
MediaMetadata.Builder putLong (String key, long value)
将长期价值放入元数据中。 可以使用自定义键,但如果使用此类中定义的METADATA_KEYs,它们可能只是以下之一:
METADATA_KEY_DURATION
METADATA_KEY_TRACK_NUMBER
METADATA_KEY_NUM_TRACKS
METADATA_KEY_DISC_NUMBER
METADATA_KEY_YEAR
Parameters | |
---|---|
key |
String : The key for referencing this value |
value |
long : The long value to store |
Returns | |
---|---|
MediaMetadata.Builder |
The Builder to allow chaining |
MediaMetadata.Builder putRating (String key, Rating value)
将Rating
放入元数据中。 可以使用自定义键,但如果使用此类中定义的METADATA_KEYs,它们可能只是以下之一:
Parameters | |
---|---|
key |
String : The key for referencing this value |
value |
Rating : The Rating value to store |
Returns | |
---|---|
MediaMetadata.Builder |
The Builder to allow chaining |
MediaMetadata.Builder putString (String key, String value)
将一个字符串值放入元数据中。 可以使用自定义键,但如果使用此类中定义的METADATA_KEYs,它们可能只是以下之一:
METADATA_KEY_TITLE
METADATA_KEY_ARTIST
METADATA_KEY_ALBUM
METADATA_KEY_AUTHOR
METADATA_KEY_WRITER
METADATA_KEY_COMPOSER
METADATA_KEY_DATE
METADATA_KEY_GENRE
METADATA_KEY_ALBUM_ARTIST
METADATA_KEY_ART_URI
METADATA_KEY_ALBUM_ART_URI
METADATA_KEY_DISPLAY_TITLE
METADATA_KEY_DISPLAY_SUBTITLE
METADATA_KEY_DISPLAY_DESCRIPTION
METADATA_KEY_DISPLAY_ICON_URI
艺术品的Uris应该使用content:// style并且支持 EXTRA_SIZE
通过 openTypedAssetFileDescriptor(Uri, String, Bundle)
检索缩放的艺术品。
Parameters | |
---|---|
key |
String : The key for referencing this value |
value |
String : The String value to store |
Returns | |
---|---|
MediaMetadata.Builder |
The Builder to allow chaining |
MediaMetadata.Builder putText (String key, CharSequence value)
将CharSequence值放入元数据中。 可以使用自定义键,但如果使用此类中定义的METADATA_KEYs,它们可能只是以下之一:
METADATA_KEY_TITLE
METADATA_KEY_ARTIST
METADATA_KEY_ALBUM
METADATA_KEY_AUTHOR
METADATA_KEY_WRITER
METADATA_KEY_COMPOSER
METADATA_KEY_DATE
METADATA_KEY_GENRE
METADATA_KEY_ALBUM_ARTIST
METADATA_KEY_ART_URI
METADATA_KEY_ALBUM_ART_URI
METADATA_KEY_DISPLAY_TITLE
METADATA_KEY_DISPLAY_SUBTITLE
METADATA_KEY_DISPLAY_DESCRIPTION
METADATA_KEY_DISPLAY_ICON_URI
Parameters | |
---|---|
key |
String : The key for referencing this value |
value |
CharSequence : The CharSequence value to store |
Returns | |
---|---|
MediaMetadata.Builder |
The Builder to allow chaining |