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之深入解析媒体数据的管理与操作的主要内容,如果未能解决你的问题,请参考以下文章

HarmonyOS之深入解析视频的功能和使用

HarmonyOS之深入解析通知的使用

HarmonyOS之深入解析线程管理

HarmonyOS之深入解析图像的位图操作和属性解码

HarmonyOS之深入解析自定义组件与布局的实现

HarmonyOS之深入解析线程间的通信