接口说明
接口名 |
功能描述 |
---|---|
Builder() |
媒体元数据构造器的构造函数。 |
Builder(AVMetadata source) |
媒体元数据构造器的带参构造函数。 |
setText(String key, CharSequence value) |
用于存储媒体标题等信息。 |
setString(String key, String value) |
用于存储媒体作者、艺术家、描述等。 |
setLong(String key, long value) |
用于存储媒体ID、媒体时长等信息。 |
setPixelMap(String key, PixelMap value) |
用于存储媒体元数据相关的图片资源。 |
build() |
媒体元数据生成函数。 |
接口名 |
功能描述 |
---|---|
hasKey(String key) |
媒体元数据中是否包含某一个key的数据。 |
getText(String key) |
获取text类型的key的数据,比如获取媒体标题等信息。 |
getString(String key) |
获取String类型key的数据,比如获取媒体作者、艺术家、描述等。 |
getLong(String key) |
获取Long类型key数据,比如获取媒体ID、媒体时长等信息。 |
getKeysSet() |
获取媒体元数据的集合。 |
getPixelMap(String key) |
获取PixelMap类型key数据,获取媒体元数据相关的图片资源。 |
marshalling(Parcel in) |
将一个AVMetadata对象写入到Parcel对象。 |
getAVDescription() |
获取媒体的简要描述信息。 |
开发步骤
- 调用AVMetadata.Builder类的build方法创建AVMetadata实例。代码示例如下:
String pathName = “/data/data/com.example.myapplication/files/test.png”;
ImageSource.SourceOptions srcOpts = new ImageSource.SourceOptions();
srcOpts.formatHint = “image/png”;
ImageSource imageSource = ImageSource.create(pathName, srcOpts);
ImageSource.DecodingOptions decodingOpts = new ImageSource.DecodingOptions();
decodingOpts.desiredSize = new Size(0, 0);
decodingOpts.desiredRegion = new Rect(0, 0, 0, 0);
PixelMap pixelMap = imageSource.createPixelmap(0, decodingOpts);
AVMetadata avMetadata = new AVMetadata.Builder().setString(AVMetadata.AVTextKey.META_ID, “illuminate.mp3”)
.setString(AVMetadata.AVTextKey.TITLE, “title”)
.setString(AVMetadata.AVTextKey.ARTIST, “artist”)
.setString(AVMetadata.AVTextKey.ALBUM, “album”)
.setString(AVMetadata.AVTextKey.TITLE, “display_subtitle”)
.setPixelMap(AVMetadata.AVPixelMapKey.ICON, pixelmap)
.build();
- (可选)根据已有的AVMetadata对象,可以获取媒体元数据信息,如获取媒体标题等,代码示例如下:
String title = avMetadata.getString(AVMetadata.AVTextKey.TITLE);
- 我们需要结合AVSession使用,将已有的媒体元数据AVMetadata对象下发给应用,具体参考《媒体会话管理开发指导》使用,示例如下:
AVSession mediaSession = new AVSession(this, “AVService”);
mediaSession.setAVMetadata(avMetadata);
- 应用获取媒体元数据一般结合AVControllerCallback相关类使用,通过onAVMetadataChanged回调获取媒体元数据(详细见《媒体会话管理开发指导》)。
Image musicCover;
Text musicTitle;
public class Callback extends AVControllerCallback {
@Override
public void onAVMetadataChanged(AVMetadata metadata) {
// 歌曲信息回调
AVDescription description = metadata.getAVDescription();
// 获取标题
String title = description.getTitle().toString();
CharSequence sequence = metadata.getText(AVMetadata.AVTextKey.TITLE);
if (sequence != null) {
title = sequence.toString();
}
// 设置媒体title
musicTitle.setText(title);
// 获取曲目专封面
PixelMap iconPixelMap = description.getIcon();
// 设置歌曲封面图
musicCover.setPixelMap(iconPixelMap);
}
}