public final class MediaMetadata
extends Object
implements Parcelable
java.lang.Object | |
↳ | android.media.MediaMetadata |
包含有关项目的元数据,例如标题,艺术家等
Nested classes |
|
---|---|
class |
MediaMetadata.Builder 用于构建MediaMetadata对象。 |
Inherited constants |
---|
From interface android.os.Parcelable
|
Fields |
|
---|---|
public static final Creator<MediaMetadata> |
CREATOR |
Public methods |
|
---|---|
boolean |
containsKey(String key) 如果给定的键包含在元数据中,则返回true |
int |
describeContents() 描述此Parcelable实例的封送表示中包含的特殊对象的种类。 |
Bitmap |
getBitmap(String key) 返回给定键的 |
MediaDescription |
getDescription() 为显示目的返回此元数据的简单描述。 |
long |
getLong(String key) 返回与给定键相关联的值,如果给定键不存在,则返回0L。 |
Rating |
getRating(String key) 给定键返回 |
String |
getString(String key) 以String形式返回与给定键关联的文本值;如果给定键不存在所需类型的映射,或者null键与该键明确关联,则返回null。 |
CharSequence |
getText(String key) 返回与给定键相关联的值;如果没有给定键的所需类型的映射存在,或者null键与该键明确关联,则返回null。 |
Set<String> |
keySet() 返回包含在此元数据中用作键的字符串的集合。 |
int |
size() 返回此元数据中的字段数。 |
void |
writeToParcel(Parcel dest, int flags) 将此对象平铺到一个包裹中。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
|
From interface android.os.Parcelable
|
String METADATA_KEY_ALBUM
媒体专辑标题。
常量值:“android.media.metadata.ALBUM”
String METADATA_KEY_ALBUM_ART
媒体原始资料专辑的作品为 Bitmap
。
艺术品应该相对较小,如果它太大,可能会被系统缩小。 对于更高分辨率的图METADATA_KEY_ALBUM_ART_URI
应该使用METADATA_KEY_ALBUM_ART_URI
。
常量值:“android.media.metadata.ALBUM_ART”
String METADATA_KEY_ALBUM_ARTIST
媒体原始资料专辑的艺术家。
常量值:“android.media.metadata.ALBUM_ARTIST”
String METADATA_KEY_ALBUM_ART_URI
作为Uri格式字符串的媒体原始源相册的图片。 艺术品可以使用openInputStream(Uri)
和decodeStream(InputStream)
的组合加载。
为了获得最佳效果,Uris应该使用content:// style并通过 openTypedAssetFileDescriptor(Uri, String, Bundle)
支持 EXTRA_SIZE
来检索缩放图片。
常量值:“android.media.metadata.ALBUM_ART_URI”
String METADATA_KEY_ART
媒体作品为 Bitmap
。
艺术品应该相对较小,如果它太大,可能会被系统缩小。 对于更高分辨率的图METADATA_KEY_ART_URI
应该使用METADATA_KEY_ART_URI
。
常量值:“android.media.metadata.ART”
String METADATA_KEY_ARTIST
媒体艺术家。
常量值:“android.media.metadata.ARTIST”
String METADATA_KEY_ART_URI
作为Uri格式字符串的媒体作品。 艺术品可以使用openInputStream(Uri)
和decodeStream(InputStream)
的组合加载。
为了获得最佳效果,Uris应使用content:// style并支持 EXTRA_SIZE
以通过 openTypedAssetFileDescriptor(Uri, String, Bundle)
检索缩放的作品。
常量值:“android.media.metadata.ART_URI”
String METADATA_KEY_AUTHOR
媒体的作者。
常量值:“android.media.metadata.AUTHOR”
String METADATA_KEY_COMPILATION
媒体的编辑状态。
常量值:“android.media.metadata.COMPILATION”
String METADATA_KEY_COMPOSER
媒体的作曲家。
常量值:“android.media.metadata.COMPOSER”
String METADATA_KEY_DATE
媒体创建或发布的日期。 格式未指定,但建议使用RFC 3339。
常量值:“android.media.metadata.DATE”
String METADATA_KEY_DISC_NUMBER
媒体原始来源的光盘号码。
常量值:“android.media.metadata.DISC_NUMBER”
String METADATA_KEY_DISPLAY_DESCRIPTION
适合向用户显示的说明。 当显示由这个元数据描述的媒体的更多信息时,这应该优先于其他字段(如果存在)。
常量值:“android.media.metadata.DISPLAY_DESCRIPTION”
String METADATA_KEY_DISPLAY_ICON
适合向用户显示的图标或缩略图。 当显示由该元数据描述的媒体的图标时,如果存在其他字段,则该图标应该优选。 这必须是Bitmap
。
图标应该相对较小,如果它太大,可能会被系统缩小。 对于更高分辨率的图METADATA_KEY_DISPLAY_ICON_URI
应该使用METADATA_KEY_DISPLAY_ICON_URI
。
常量值:“android.media.metadata.DISPLAY_ICON”
String METADATA_KEY_DISPLAY_ICON_URI
用于显示给用户的图标或缩略图的Uri格式字符串。 在显示此元数据描述的媒体的更多信息时,显示说明应优先于其他字段。 该图标可以使用openInputStream(Uri)
和decodeStream(InputStream)
的组合加载。
为了获得最佳效果,Uris应使用content:// style并支持 EXTRA_SIZE
以通过 openTypedAssetFileDescriptor(Uri, String, Bundle)
检索缩放图 openTypedAssetFileDescriptor(Uri, String, Bundle)
。
常量值:“android.media.metadata.DISPLAY_ICON_URI”
String METADATA_KEY_DISPLAY_SUBTITLE
适合向用户显示的字幕。 当显示由此元数据描述的媒体的第二行时,如果存在其他字段,则应优先选择此行。
常量值:“android.media.metadata.DISPLAY_SUBTITLE”
String METADATA_KEY_DISPLAY_TITLE
适合向用户显示的标题。 这通常与METADATA_KEY_TITLE
相同,但对于某些格式可能会有所不同。 当显示由这个元数据描述的媒体时,如果存在这个应该是首选。
常量值:“android.media.metadata.DISPLAY_TITLE”
String METADATA_KEY_DURATION
媒体的持续时间以毫秒为单位。 负的持续时间表示持续时间未知(或无限)。
常量值:“android.media.metadata.DURATION”
String METADATA_KEY_GENRE
媒体的流派。
常量值:“android.media.metadata.GENRE”
String METADATA_KEY_MEDIA_ID
用于识别内容的字符串键。 该值特定于提供内容的服务。 如果使用,这应该是底层内容的永久性唯一键。 当连接到同一应用的MediaBrowser
提供时,它可以与playFromMediaId(String, Bundle)
用于启动播放。
常量值:“android.media.metadata.MEDIA_ID”
String METADATA_KEY_NUM_TRACKS
媒体原始来源中的曲目数量。
常量值:“android.media.metadata.NUM_TRACKS”
String METADATA_KEY_RATING
媒体整体评分。
也可以看看:
常量值:“android.media.metadata.RATING”
String METADATA_KEY_TITLE
媒体的标题。
常量值:“android.media.metadata.TITLE”
String METADATA_KEY_TRACK_NUMBER
媒体的曲目号码。
常量值:“android.media.metadata.TRACK_NUMBER”
String METADATA_KEY_USER_RATING
用户对媒体的评分。
也可以看看:
常量值:“android.media.metadata.USER_RATING”
String METADATA_KEY_WRITER
媒体的作者。
常量值:“android.media.metadata.WRITER”
String METADATA_KEY_YEAR
媒体创建或发布的一年。
常量值:“android.media.metadata.YEAR”
boolean containsKey (String key)
如果给定的键包含在元数据中,则返回true
Parameters | |
---|---|
key |
String : a String key |
Returns | |
---|---|
boolean |
true if the key exists in this metadata, false otherwise |
int describeContents ()
描述此Parcelable实例的封送表示中包含的特殊对象的种类。 例如,如果对象将在writeToParcel(Parcel, int)
的输出中包含writeToParcel(Parcel, int)
,则此方法的返回值必须包含CONTENTS_FILE_DESCRIPTOR
位。
Returns | |
---|---|
int |
a bitmask indicating the set of special object types marshaled by this Parcelable object instance. |
Bitmap getBitmap (String key)
返回给定键的 Bitmap
;如果给定键不存在位图,则返回null。
Parameters | |
---|---|
key |
String : The key the value is stored under |
Returns | |
---|---|
Bitmap |
A Bitmap or null |
MediaDescription getDescription ()
为显示目的返回此元数据的简单描述。
Returns | |
---|---|
MediaDescription |
A simple description of this metadata. |
long getLong (String key)
返回与给定键相关联的值,如果给定键不存在,则返回0L。
Parameters | |
---|---|
key |
String : The key the value is stored under |
Returns | |
---|---|
long |
a long value |
Rating getRating (String key)
返回给定键的 Rating
;如果给定键不存在评级,则返回null。
Parameters | |
---|---|
key |
String : The key the value is stored under |
Returns | |
---|---|
Rating |
A Rating or null |
String getString (String key)
以String形式返回与给定键关联的文本值;如果给定键不存在所需类型的映射,或者null键与该键明确关联,则返回null。 这相当于如果值不为空,则调用getText().toString()
。
Parameters | |
---|---|
key |
String : The key the value is stored under |
Returns | |
---|---|
String |
a String value, or null |
CharSequence getText (String key)
返回与给定键相关联的值;如果没有给定键的所需类型的映射存在,或者null键与该键明确关联,则返回null。
Parameters | |
---|---|
key |
String : The key the value is stored under |
Returns | |
---|---|
CharSequence |
a CharSequence value, or null |
Set<String> keySet ()
返回包含在此元数据中用作键的字符串的集合。
Returns | |
---|---|
Set<String> |
a Set of String keys |
int size ()
返回此元数据中的字段数。
Returns | |
---|---|
int |
The number of fields in the metadata. |
void writeToParcel (Parcel dest, int flags)
将此对象平铺到一个包裹中。
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 . |