鸿蒙HarmonyOS开发实战—多媒体开发（视频开发 三）_new pacmap()

场景介绍

媒体描述信息主要工作是支持多媒体的相关描述信息的存取。

接口说明

媒体描述信息类AVDescription的主要接口

接口名	功能描述
getMediaId()	获取媒体标识。
getTitle()	获取媒体标题。
getSubTitle()	获取媒体副标题。
getDescription()	获取媒体描述信息。
getIcon()	获取媒体图标。
getIconUri()	获取媒体图标的Uri。
getExtras()	获取媒体添加的额外信息，例如应用和系统使用的内部信息。
getMediaUri()	获取媒体内容的Uri。
marshalling(Parcel parcel)	将一个AVDescription对象写入到Parcel对象。
unmarshalling(Parcel parcel)	将一个Parcel对象写入到AVDescription对象。

媒体描述信息内部静态类AVDescription.Builder的主要接口

接口名	功能描述
setMediaId(String mediaId)	设置媒体标识。
setTitle(CharSequence title)	设置媒体标题。
setSubTitle(CharSequence subTitle)	设置媒体副标题。
setDescription(String description)	设置媒体描述信息。
setIcon(PixelMap icon)	设置媒体图标。
setIconUri(Uri iconUri)	设置媒体图标的Uri。
setExtras(PacMap extras)	设置媒体的额外信息，例如应用和系统使用的内部信息。
setIMediaUri(Uri mediaUri)	设置媒体的Uri。
build()	构造方法。

开发步骤

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

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);
Uri iconUri = Uri.parse("http://test.icon");
Uri mediaUri = Uri.parse("http://test.mp4");
PacMap pacMap = new PacMap();
AVDescription avDescription = new AVDescription.Builder().setExtras(null)
            .setMediaId("1")
            .setDescription("Description")
            .setIconUri(iconUri)
            .setIMediaUri(mediaUri)
            .setExtras(pacMap)
            .setIcon(pixelMap)
            .setTitle("title")
            .setSubTitle("subTitle")
            .build();

2. （可选）根据已有的AVDescription对象，可以获取媒体的描述信息，如获取媒体Uri，代码示例如下：

Uri uri = avDescription.getMediaUri(); 

3. （可选）根据已有的AVDescription对象，可以将媒体的描述信息写入Parcel对象，代码示例如下：

Parcel parcel = Parcel.create();
boolean result = avDescription.marshalling(parcel);

4. （可选）根据已有的Parcel对象，可以读取到AVDescription对象，实现媒体描述信息的写入，代码示例如下：

boolean result = avDescription.unmarshalling(parcel);

媒体元数据开发

场景介绍

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

接口说明

媒体元数据存放类AVMetadata.Builder的主要接口

接口名	功能描述
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()	媒体元数据生成函数。

媒体元数据类AVMetadata的主要接口

接口名	功能描述
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实例。代码示例如下：

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

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

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

3. 将已有的媒体元数据AVMetadata对象下发给应用，示例如下：

AVSession  mediaSession = new AVSession(this, "AVService");
mediaSession.setAVMetadata(avMetadata);

4. 应用获取媒体元数据一般结合AVControllerCallback相关类使用。

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

---

最后，为了能让大家更好的去学习提升鸿蒙 (Harmony OS) 开发技术，小编连夜整理了一份30个G纯血版学习资料（含视频、电子书、学习文档等）以及一份在Github上持续爆火霸榜的《纯血版华为鸿蒙 (Harmony OS)开发手册》（共计890页），希望对大家有所帮助。

纯血版鸿蒙 HarmonyOS 4.0 视频学习资料

需要以上视频学习资料小伙伴

请点击→纯血版全套鸿蒙HarmonyOS学习资料

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数HarmonyOS鸿蒙开发工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年HarmonyOS鸿蒙开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上HarmonyOS鸿蒙开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录大纲截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新

如果你觉得这些内容对你有帮助，可以添加VX：vip204888 （备注鸿蒙获取）

一个人可以走的很快，但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎扫码加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

由于文件比较大，这里只是将部分目录大纲截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新

如果你觉得这些内容对你有帮助，可以添加VX：vip204888 （备注鸿蒙获取）
[外链图片转存中…(img-kMC4TrVv-1712921168083)]

一个人可以走的很快，但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎扫码加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！