鸿蒙OS 媒体元数据开发指导

场景介绍

媒体元数据主要用于媒体数据的存放和读取，包含诸如媒体资源的描述、创建日期、作者、封面图片等等。

接口说明

接口名	功能描述
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()	获取媒体的简要描述信息。

开发步骤

1. 调用 AVMetadata.Builder 类的 build 方法创建 AVMetadata 实例。代码示例如下：

   AVMetadata avMetadata = new AVMetadata.Builder().setString(AVMetadata.AVTextKey.MEDIA_ID, "illuminate.mp3")
                     .setString(AVMetadata.AVTextKey.TITLE, "title")
                     .setString(AVMetadata.AVTextKey.ARTIST, "artist")
                     .setString(AVMetadata.AVTextKey.ALBUM, "album")
                     .setString(AVMetadata.AVTextKey.DISPLAY_SUBTITLE, "display_subtitle")
                     .setPixelMap(AVMetadata.AVPixelMapKey.DISPLAY_ICON_URI, pixelmap)
                     .build();

1. (可选)根据已有的 AVMetadata 对象，可以获取媒体元数据信息，如获取媒体标题等，代码示例如下：

   String title = avMetadata.getString(AVMetadata.AVTextKey.TITLE); 

1. 我们需要结合 AVSession 使用，将已有的媒体元数据 AVMetadata 对象下发给应用，具体参考 AVSession 使用，示例如下：

   mediaSession.setAVMetadata(avMetadata);

1. 应用获取媒体元数据一般结合 AVControllerCallback 相关类使用，通过 onAVMetadataChanged 回调获取媒体元数据。

   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 = metadata.getText(AVMetadata.AVTextKey.TITLE).toString();
           }
           // 设置媒体title
           musicTitle.setText(title);
           // 获取曲目专封面
           PixelMap iconPixelMap = description.getIcon();
           // 设置歌曲封面图
           musicCover.setPixelMap(iconPixelMap);
       }
   }