Most visited

Recently visited

Added in API level 21

MediaMetadata

public final class MediaMetadata
extends Object implements Parcelable

java.lang.Object
   ↳ android.media.MediaMetadata


包含有关项目的元数据,例如标题,艺术家等

Summary

Nested classes

class MediaMetadata.Builder

用于构建MediaMetadata对象。

Constants

String METADATA_KEY_ALBUM

媒体专辑标题。

String METADATA_KEY_ALBUM_ART

媒体原始作品专辑的作品为 Bitmap

String METADATA_KEY_ALBUM_ARTIST

媒体原始资料专辑的艺术家。

String METADATA_KEY_ALBUM_ART_URI

作为Uri格式字符串的媒体原始源相册的图片。

String METADATA_KEY_ART

作为媒体的作品为 Bitmap

String METADATA_KEY_ARTIST

媒体艺术家。

String METADATA_KEY_ART_URI

作为Uri格式字符串的媒体作品。

String METADATA_KEY_AUTHOR

媒体的作者。

String METADATA_KEY_COMPILATION

媒体的编辑状态。

String METADATA_KEY_COMPOSER

媒体的作曲家。

String METADATA_KEY_DATE

媒体创建或发布的日期。

String METADATA_KEY_DISC_NUMBER

媒体原始来源的光盘号码。

String METADATA_KEY_DISPLAY_DESCRIPTION

适合向用户显示的说明。

String METADATA_KEY_DISPLAY_ICON

适合向用户显示的图标或缩略图。

String METADATA_KEY_DISPLAY_ICON_URI

用于显示给用户的图标或缩略图的Uri格式字符串。

String METADATA_KEY_DISPLAY_SUBTITLE

适合向用户显示的字幕。

String METADATA_KEY_DISPLAY_TITLE

适合向用户显示的标题。

String METADATA_KEY_DURATION

媒体的持续时间以毫秒为单位。

String METADATA_KEY_GENRE

媒体的流派。

String METADATA_KEY_MEDIA_ID

用于识别内容的字符串键。

String METADATA_KEY_NUM_TRACKS

媒体原始来源中的曲目数量。

String METADATA_KEY_RATING

媒体整体评分。

String METADATA_KEY_TITLE

媒体的标题。

String METADATA_KEY_TRACK_NUMBER

媒体的曲目号码。

String METADATA_KEY_USER_RATING

用户对媒体的评分。

String METADATA_KEY_WRITER

媒体的作者。

String METADATA_KEY_YEAR

媒体创建或发布的一年。

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)

返回给定键的 Bitmap ;如果给定键不存在位图,则返回null。

MediaDescription getDescription()

为显示目的返回此元数据的简单描述。

long getLong(String key)

返回与给定键相关联的值,如果给定键不存在,则返回0L。

Rating getRating(String key)

给定键返回 Rating ,如果给定键不存在评级,则返回null。

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

Constants

METADATA_KEY_ALBUM

Added in API level 21
String METADATA_KEY_ALBUM

媒体专辑标题。

常量值:“android.media.metadata.ALBUM”

METADATA_KEY_ALBUM_ART

Added in API level 21
String METADATA_KEY_ALBUM_ART

媒体原始资料专辑的作品为 Bitmap

艺术品应该相对较小,如果它太大,可能会被系统缩小。 对于更高分辨率的图METADATA_KEY_ALBUM_ART_URI应该使用METADATA_KEY_ALBUM_ART_URI

常量值:“android.media.metadata.ALBUM_ART”

METADATA_KEY_ALBUM_ARTIST

Added in API level 21
String METADATA_KEY_ALBUM_ARTIST

媒体原始资料专辑的艺术家。

常量值:“android.media.metadata.ALBUM_ARTIST”

METADATA_KEY_ALBUM_ART_URI

Added in API level 21
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”

METADATA_KEY_ART

Added in API level 21
String METADATA_KEY_ART

媒体作品为 Bitmap

艺术品应该相对较小,如果它太大,可能会被系统缩小。 对于更高分辨率的图METADATA_KEY_ART_URI应该使用METADATA_KEY_ART_URI

常量值:“android.media.metadata.ART”

METADATA_KEY_ARTIST

Added in API level 21
String METADATA_KEY_ARTIST

媒体艺术家。

常量值:“android.media.metadata.ARTIST”

METADATA_KEY_ART_URI

Added in API level 21
String METADATA_KEY_ART_URI

作为Uri格式字符串的媒体作品。 艺术品可以使用openInputStream(Uri)decodeStream(InputStream)的组合加载。

为了获得最佳效果,Uris应使用content:// style并支持 EXTRA_SIZE以通过 openTypedAssetFileDescriptor(Uri, String, Bundle)检索缩放的作品。

常量值:“android.media.metadata.ART_URI”

METADATA_KEY_AUTHOR

Added in API level 21
String METADATA_KEY_AUTHOR

媒体的作者。

常量值:“android.media.metadata.AUTHOR”

METADATA_KEY_COMPILATION

Added in API level 21
String METADATA_KEY_COMPILATION

媒体的编辑状态。

常量值:“android.media.metadata.COMPILATION”

METADATA_KEY_COMPOSER

Added in API level 21
String METADATA_KEY_COMPOSER

媒体的作曲家。

常量值:“android.media.metadata.COMPOSER”

METADATA_KEY_DATE

Added in API level 21
String METADATA_KEY_DATE

媒体创建或发布的日期。 格式未指定,但建议使用RFC 3339。

常量值:“android.media.metadata.DATE”

METADATA_KEY_DISC_NUMBER

Added in API level 21
String METADATA_KEY_DISC_NUMBER

媒体原始来源的光盘号码。

常量值:“android.media.metadata.DISC_NUMBER”

METADATA_KEY_DISPLAY_DESCRIPTION

Added in API level 21
String METADATA_KEY_DISPLAY_DESCRIPTION

适合向用户显示的说明。 当显示由这个元数据描述的媒体的更多信息时,这应该优先于其他字段(如果存在)。

常量值:“android.media.metadata.DISPLAY_DESCRIPTION”

METADATA_KEY_DISPLAY_ICON

Added in API level 21
String METADATA_KEY_DISPLAY_ICON

适合向用户显示的图标或缩略图。 当显示由该元数据描述的媒体的图标时,如果存在其他字段,则该图标应该优选。 这必须是Bitmap

图标应该相对较小,如果它太大,可能会被系统缩小。 对于更高分辨率的图METADATA_KEY_DISPLAY_ICON_URI应该使用METADATA_KEY_DISPLAY_ICON_URI

常量值:“android.media.metadata.DISPLAY_ICON”

METADATA_KEY_DISPLAY_ICON_URI

Added in API level 21
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”

METADATA_KEY_DISPLAY_SUBTITLE

Added in API level 21
String METADATA_KEY_DISPLAY_SUBTITLE

适合向用户显示的字幕。 当显示由此元数据描述的媒体的第二行时,如果存在其他字段,则应优先选择此行。

常量值:“android.media.metadata.DISPLAY_SUBTITLE”

METADATA_KEY_DISPLAY_TITLE

Added in API level 21
String METADATA_KEY_DISPLAY_TITLE

适合向用户显示的标题。 这通常与METADATA_KEY_TITLE相同,但对于某些格式可能会有所不同。 当显示由这个元数据描述的媒体时,如果存在这个应该是首选。

常量值:“android.media.metadata.DISPLAY_TITLE”

METADATA_KEY_DURATION

Added in API level 21
String METADATA_KEY_DURATION

媒体的持续时间以毫秒为单位。 负的持续时间表示持续时间未知(或无限)。

常量值:“android.media.metadata.DURATION”

METADATA_KEY_GENRE

Added in API level 21
String METADATA_KEY_GENRE

媒体的流派。

常量值:“android.media.metadata.GENRE”

METADATA_KEY_MEDIA_ID

Added in API level 21
String METADATA_KEY_MEDIA_ID

用于识别内容的字符串键。 该值特定于提供内容的服务。 如果使用,这应该是底层内容的永久性唯一键。 当连接到同一应用的MediaBrowser提供时,它可以与playFromMediaId(String, Bundle)用于启动播放。

常量值:“android.media.metadata.MEDIA_ID”

METADATA_KEY_NUM_TRACKS

Added in API level 21
String METADATA_KEY_NUM_TRACKS

媒体原始来源中的曲目数量。

常量值:“android.media.metadata.NUM_TRACKS”

METADATA_KEY_RATING

Added in API level 21
String METADATA_KEY_RATING

媒体整体评分。

也可以看看:

常量值:“android.media.metadata.RATING”

METADATA_KEY_TITLE

Added in API level 21
String METADATA_KEY_TITLE

媒体的标题。

常量值:“android.media.metadata.TITLE”

METADATA_KEY_TRACK_NUMBER

Added in API level 21
String METADATA_KEY_TRACK_NUMBER

媒体的曲目号码。

常量值:“android.media.metadata.TRACK_NUMBER”

METADATA_KEY_USER_RATING

Added in API level 21
String METADATA_KEY_USER_RATING

用户对媒体的评分。

也可以看看:

常量值:“android.media.metadata.USER_RATING”

METADATA_KEY_WRITER

Added in API level 21
String METADATA_KEY_WRITER

媒体的作者。

常量值:“android.media.metadata.WRITER”

METADATA_KEY_YEAR

Added in API level 21
String METADATA_KEY_YEAR

媒体创建或发布的一年。

常量值:“android.media.metadata.YEAR”

Fields

CREATOR

Added in API level 21
Creator<MediaMetadata> CREATOR

Public methods

containsKey

Added in API level 21
boolean containsKey (String key)

如果给定的键包含在元数据中,则返回true

Parameters
key String: a String key
Returns
boolean true if the key exists in this metadata, false otherwise

describeContents

Added in API level 21
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.

getBitmap

Added in API level 21
Bitmap getBitmap (String key)

返回给定键的 Bitmap ;如果给定键不存在位图,则返回null。

Parameters
key String: The key the value is stored under
Returns
Bitmap A Bitmap or null

getDescription

Added in API level 21
MediaDescription getDescription ()

为显示目的返回此元数据的简单描述。

Returns
MediaDescription A simple description of this metadata.

getLong

Added in API level 21
long getLong (String key)

返回与给定键相关联的值,如果给定键不存在,则返回0L。

Parameters
key String: The key the value is stored under
Returns
long a long value

getRating

Added in API level 21
Rating getRating (String key)

返回给定键的 Rating ;如果给定键不存在评级,则返回null。

Parameters
key String: The key the value is stored under
Returns
Rating A Rating or null

getString

Added in API level 21
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

getText

Added in API level 21
CharSequence getText (String key)

返回与给定键相关联的值;如果没有给定键的所需类型的映射存在,或者null键与该键明确关联,则返回null。

Parameters
key String: The key the value is stored under
Returns
CharSequence a CharSequence value, or null

keySet

Added in API level 21
Set<String> keySet ()

返回包含在此元数据中用作键的字符串的集合。

Returns
Set<String> a Set of String keys

size

Added in API level 21
int size ()

返回此元数据中的字段数。

Returns
int The number of fields in the metadata.

writeToParcel

Added in API level 21
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.

Hooray!