场景介绍

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

接口说明

开发步骤

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);
       }
   }