HarmonyOS之深入解析媒体数据的管理与操作
Posted Forever_wj
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了HarmonyOS之深入解析媒体数据的管理与操作相关的知识,希望对你有一定的参考价值。
一、简介
- HarmonyOS 媒体数据管理模块支持多媒体数据管理相关的功能开发,常见操作如:获取媒体元数据、截取帧数据等。
- 在进行应用的开发前,应了解以下基本概念:
-
- PixelMap:PixelMap 是图像解码后无压缩的位图格式,用于图像显示或者进一步的处理。
-
- 媒体元数据:媒体元数据是用来描述多媒体数据的数据,例如媒体标题、媒体时长等数据信息。
- 为及时释放 native 资源,建议在媒体数据管理 AVMetadataHelper 对象使用完成后,主动调用 release() 方法。
二、媒体元数据获取
① 媒体元数据获取 API
- 媒体元数据是描述多媒体数据的数据,例如媒体标题、媒体时长、媒体的帧数据等。
- 媒体元数据获取相关类 AVMetadataHelper 的主要接口:
接口名 | 描述 |
---|---|
setSource(String path) | 读取指定路径的媒体文件,将其设置为媒体源 |
setSource(FileDescriptor fd) | 读取指定的媒体文件描述符,设置媒体源 |
setSource(FileDescriptor fd, long offset, long length) | 读取指定的媒体文件描述符,读取数据的起始位置的偏移量以及读取的数据长度,设置媒体源 |
setSource(String uri, Map<String, String> headers) | 读取指定的媒体文件Uri,设置媒体源 |
setSource(Context context, Uri uri) | 读取指定的媒体的Uri和上下文,设置媒体源 |
resolveMetadata(int keyCode) | v获取媒体元数据中指定keyCode对应的值 |
fetchVideoScaledPixelMapByTime(long timeUs, int option, int dstWidth, int dstHeight) | 根据视频源中时间戳、获取选项以及图像帧缩放大小,获取帧数据 |
fetchVideoPixelMapByTime(long timeUs, int option) | 根据视频源中时间戳和获取选项,获取帧数据 |
fetchVideoPixelMapByTime(long timeUs) | 根据视频源中时间戳,获取最靠近时间戳的帧的数据 |
fetchVideoPixelMapByTime() | 随机获取数据源中某一帧的数据 |
resolveImage() | 获取音频源中包含的图像数据,比如专辑封面,如果有多个图像,返回任意一个图像的数据 |
fetchVideoPixelMapByIndex(int frameIndex, PixelMapConfigs configs) | 根据指定的图像像素格式选项,获取视频源中指定一帧的数据 |
fetchVideoPixelMapByIndex(int frameIndex) | 获取视频源中指定一帧的数据 |
fetchVideoPixelMapByIndex(int frameIndex, int numFrames, PixelMapConfigs configs) | 根据指定的图像像素格式选项,获取视频源中指定的连续多帧的数据 |
fetchVideoPixelMapByIndex(int frameIndex, int numFrames) | 获取视频源中指定的连续多帧的数据 |
fetchImagePixelMapByIndex(int imageIndex, PixelMapConfigs configs) | 根据指定的图像像素格式选项,获取源图像中指定的图像 |
fetchImagePixelMapByIndex(int imageIndex) | 获取源图像中指定的图像 |
fetchImagePrimaryPixelMap(PixelMapConfigs configs) | 据指定的图像像素格式选项,获取源图像中默认图像 |
fetchImagePrimaryPixelMap() | 获取源图像中默认图像 |
release() | 释放读取的媒体资源 |
② 获取帧数据的流程
- 创建媒体数据管理 AVMetadataHelper 对象,可以通过 setSource 设置要读取的媒体文件,如果不设置或设置不正确,则无法进行后续操作:
AVMetadataHelper avMetadataHelper = new AVMetadataHelper();
avMetadataHelper.setSource("/path/short_video.mp4");
- 指定获取帧数据的选项,以及获取帧的时间,获取媒体源的帧数据:
PixelMap pixelMap = avMetadataHelper.fetchVideoPixelMapByTime(1000L, 0x00);
- 获取到 PixelMap 对象,并完成相关信息处理后,调用 release() 函数释放读取的媒体资源:
avMetadataHelper.release();
③ 获取媒体元数据的流程
- 创建媒体数据管理 AVMetadataHelper 对象,可以通过 setSource 设置要读取的媒体文件,如果不设置或设置不正确,则无法进行后续操作:
AVMetadataHelper avMetadataHelper= new AVMetadataHelper();
avMetadataHelper.setSource("/path/short_video.mp4");
- 指定要获取的媒体元数据的 key,获取媒体元数据。如下代码获取媒体的时长信息:
String result = avMetadataHelper.resolveMetadata(AVMetadataHelper.AV_KEY_DURATION);
- 获取到媒体元数据后,调用 release() 函数释放读取的媒体资源:
avMetadataHelper.release();
④ 获取音频的图像数据
- 创建媒体数据管理 AVMetadataHelper 对象,可以通过 setSource 设置要读取的音频媒体文件,如果不设置或设置不正确,则无法进行后续操作。
AVMetadataHelper avMetadataHelper= new AVMetadataHelper();
avMetadataHelper.setSource("/path/short_video.mp4");
- 获取音频的图像数据:
byte[] data = avMetadataHelper.resolveImage();
- 获取到图像数据后,调用 release() 函数释放读取的媒体资源:
avMetadataHelper.release();
三、媒体存储数据
① 媒体存储数据 API
- 媒体存储是提供了操作媒体图片、视频、音频等元数据的 Uri 链接信息。
- 媒体存储相关类 AVStorage 的主要接口:
接口名 | 描述 |
---|---|
appendPendingResource(Uri uri) | 更新给定的Uri,用于处理包含待处理标记的媒体项 |
appendRequireOriginalResource(Uri uri) | 更新给定的Uri, 用于调用者获取原始文件内容 |
fetchVolumeName(Uri uri) | 获取给定Uri所属的卷名 |
fetchExternalVolumeNames(Context context) | 获取所有组成external的特定卷名的列表 |
fetchMediaResource(Context context, Uri documentUri) | 根据文档式的Uri获取对应的媒体式的Uri |
fetchDocumentResource(Context context, Uri mediaUri) | 根据媒体式的Uri获取对应的文档式的Uri |
fetchVersion(Context context) | 获取卷名为external_primary的不透明版本信息 |
fetchVersion(Context context, String volumeName) | 获取指定卷名的不透明版本信息 |
fetchLoggerResource() | 获取用于查询媒体扫描状态的Uri |
Audio.convertNameToKey(String name) | 将艺术家或者专辑名称转换为可用于分组,排序和搜索的“key” |
Audio.Media.fetchResource(String volumeName) | 获取用于处理音频媒体信息的Uri |
Audio.Genres.fetchResource(String volumeName) | 获取用于处理音频流派信息的Uri |
Audio.Genres.fetchResourceForAudioId(String volumeName, int audioId) | 获取用户处理音频文件对应的流派信息的Uri |
Audio.Genres.Members.fetchResource(String volumeName, long genreId) | 获取用于处理音频流派子目录的成员信息的Uri |
Audio.Playlists.fetchResource(String volumeName) | 获取用于处理音频播放列表信息的Uri |
Audio.Playlists.Members.fetchResource(String volumeName, long playlistId) | 获取用于处理音频播放列表子目录的成员信息的Uri |
Audio.Playlists.Members.updatePlaylistItem(DataAbilityHelper dataAbilityHelper, long playlistId, int oldLocation, int newLocation) | 移动播放列表到新位置 |
Audio.Albums.fetchResource(String volumeName) | 获取用于处理音频专辑信息的Uri |
Audio.Artists.fetchResource(String volumeName) | 获取用于处理音频艺术家信息的Uri |
Audio.Artists.Albums.fetchResource(String volumeName, long id) | 获取用于处理所有专辑出现艺术家的歌曲信息的Uri |
Downloads.fetchResource(String volumeName) | 获取用于处理下载条目信息的Uri |
Files.fetchResource(String volumeName) | 获取用于处理媒体文件的Uri |
Images.Media.fetchResource(String volumeName) | 获取用于处理图像媒体信息的Uri |
Video.Media.fetchResource(String volumeName) | 获取用于处理视频媒体信息的Uri |
② 媒体存储数据
- 以播放视频文件为例:获取媒体外部存储中的视频URI需要使用的预定义字段是: AVStorage.Video.Media.EXTERNAL_DATA_ABILITY_URI;
- 根据媒体存储提供的Uri链接操作媒体元数据:
DataAbilityHelper helper = DataAbilityHelper.creator(context);
try {
DataAbilityPredicates predicates = new DataAbilityPredicates();
// 设置查询过滤条件
predicates.equalTo(AVStorage.Video.Media.DATA, "xxxxx");
// columns为null,查询记录所有字段,当前例子表示查询id字段
ResultSet result = helper.query(AVStorage.Video.Media.EXTERNAL_DATA_ABILITY_URI, new String[]{AVStorage.Video.Media.ID}, predicates);
if (result == null) {
return;
}
while (result.goToNextRow()) {
result.getInt(result.getColumnIndexForName(AVStorage.Video.Media.ID)); // 获取id字段的值
}
result.close();
} catch (DataAbilityRemoteException e) {
// ...
}
- 获取到媒体 ID 后,即可通过设置媒体源来进行业务操作,如:播放。
Uri uri = Uri.appendEncodedPathToUri(AVStorage.Video.Media.EXTERNAL_DATA_ABILITY_URI, String.valueOf(id)); // id为步骤1获取到的id
Player player = new Player(context);
DataAbilityHelper helper = DataAbilityHelper.creator(context);
player.setSource(new Source(helper.openFile(uri, "r")));
四、媒体扫描服务
① 媒体扫描服务 API
- 媒体扫描服务从新创建或下载的媒体文件中读取元数据,并将文件添加到媒体数据库中。
- 媒体扫描服务相关类 AVLoggerConnection 的主要接口:
接口名 | 描述 |
---|---|
performLoggerFile(String path, String mimeType) | 请求通过文件的路径和类型扫描一个媒体文件 |
performLoggerFile(Context context, String[] paths, String[] mimeTypes, AVLogCompletedListener callback) | 一次扫描多个媒体文件 |
connect() | 连接到扫描服务 |
disconnect() | 从扫描服务断开连接 |
isConnected() | 检查扫描服务是否已连接 |
② 媒体扫描服务流程
- 媒体扫描服务分为动态调用和静态调用,以扫描文件为例:
- 动态调用:
-
- 初始化 AVLoggerConnection,并注册回调函数:
public class ScannerDemo implements AVLoggerConnectionClient {
private AVLoggerConnection scanConn;
public ScannerDemo(Context context) {
// 实例化
scanConn = new AVLoggerConnection(context, this);
}
// ...
}
-
- 连接媒体扫描服务:
zScanConn.connect(); // 连接扫描服务
-
- 在 onLoggerConnected 回调函数中执行扫描,开发者通过自定义文件的路径和类型扫描指定媒体文件:
@Override
public void onLoggerConnected() {
scanConn.performLoggerFile(filePaths[i], mimeTypes[i]); // 服务回调执行扫描
}
-
- 在 onLogCompleted 回调函数中通知扫描结果:
@Override
public void onLogCompleted(String path, Uri uri) {
// 回调函数返回URI的值
scanConn.disconnect(); // 断开扫描服务
}
- 静态调用:
-
- AVLoggerConnection 静态方法 performLoggerFile,扫描结果在 onLogCompleted 中通知:
AVLoggerConnection.performLoggerFile(this, filePaths, null, new AVLogCompletedListener(){
@Override
public void onLogCompleted(String path, Uri uri) {
}
});
五、获取视频与图像缩略图
① 获取视频与图像缩略图 API
- 用于应用获取视频文件或图像文件的缩略图。
- 视频与图像缩略图获取相关类 AVThumbnailUtils 的主要接口:
接口名 | 描述 |
---|---|
createVideoThumbnail(File file, Size size) | 创建指定视频中代表性关键帧的缩略图 |
createImageThumbnail(File file, Size size) | 创建指定图像的缩略图 |
② 获取视频与图像缩略图流程
- 获取视频文件的缩略图:
PixelMap resMap = AVThumbnailUtils.createVideoThumbnail(videoFile, size);
- 获取图片文件的缩略图:
PixelMap resMap = AVThumbnailUtils.createImageThumbnail(imageFile, size);
以上是关于HarmonyOS之深入解析媒体数据的管理与操作的主要内容,如果未能解决你的问题,请参考以下文章