HarmonyOS之深入解析媒体数据的管理与操作

一、简介

• HarmonyOS 媒体数据管理模块支持多媒体数据管理相关的功能开发，常见操作如：获取媒体元数据、截取帧数据等。
• 在进行应用的开发前，应了解以下基本概念：
• • PixelMap：PixelMap 是图像解码后无压缩的位图格式，用于图像显示或者进一步的处理。
• • 媒体元数据：媒体元数据是用来描述多媒体数据的数据，例如媒体标题、媒体时长等数据信息。
• 为及时释放 native 资源，建议在媒体数据管理 AVMetadataHelper 对象使用完成后，主动调用 release() 方法。

二、媒体元数据获取

① 媒体元数据获取 API

• 媒体元数据是描述多媒体数据的数据，例如媒体标题、媒体时长、媒体的帧数据等。
• 媒体元数据获取相关类 AVMetadataHelper 的主要接口：

② 获取帧数据的流程

• 创建媒体数据管理 AVMetadataHelper 对象，可以通过 setSource 设置要读取的媒体文件，如果不设置或设置不正确，则无法进行后续操作：

	AVMetadataHelper avMetadataHelper = new AVMetadataHelper();
	avMetadataHelper.setSource("/path/short_video.mp4");

  

 

  
1
  
2
 

• 指定获取帧数据的选项，以及获取帧的时间，获取媒体源的帧数据：

	PixelMap pixelMap = avMetadataHelper.fetchVideoPixelMapByTime(1000L, 0x00); 

  

 

  
1
 

• 获取到 PixelMap 对象，并完成相关信息处理后，调用 release() 函数释放读取的媒体资源：

	avMetadataHelper.release();

  

 

  
1
 

③ 获取媒体元数据的流程

• 创建媒体数据管理 AVMetadataHelper 对象，可以通过 setSource 设置要读取的媒体文件，如果不设置或设置不正确，则无法进行后续操作：

	AVMetadataHelper avMetadataHelper= new AVMetadataHelper();
	avMetadataHelper.setSource("/path/short_video.mp4");

  

 

  
1
  
2
 

• 指定要获取的媒体元数据的 key，获取媒体元数据。如下代码获取媒体的时长信息：

	String result = avMetadataHelper.resolveMetadata(AVMetadataHelper.AV_KEY_DURATION); 

  

 

  
1
 

• 获取到媒体元数据后，调用 release() 函数释放读取的媒体资源：

	avMetadataHelper.release();

  

 

  
1
 

④ 获取音频的图像数据

• 创建媒体数据管理 AVMetadataHelper 对象，可以通过 setSource 设置要读取的音频媒体文件，如果不设置或设置不正确，则无法进行后续操作。

	AVMetadataHelper avMetadataHelper= new AVMetadataHelper();
	avMetadataHelper.setSource("/path/short_video.mp4");

  

 

  
1
  
2
 

• 获取音频的图像数据：

	byte[] data = avMetadataHelper.resolveImage();

  

 

  
1
 

• 获取到图像数据后，调用 release() 函数释放读取的媒体资源：

	avMetadataHelper.release();

  

 

  
1
 

三、媒体存储数据

① 媒体存储数据 API

• 媒体存储是提供了操作媒体图片、视频、音频等元数据的 Uri 链接信息。
• 媒体存储相关类 AVStorage 的主要接口：

② 媒体存储数据

• 以播放视频文件为例：获取媒体外部存储中的视频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) {
	    // ...
	}

  

 

  
1
  
2
  
3
  
4
  
5
  
6
  
7
  
8
  
9
  
10
  
11
  
12
  
13
  
14
  
15
  
16
  
17
 

• 获取到媒体 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")));

  

 

  
1
  
2
  
3
  
4
 

四、媒体扫描服务

① 媒体扫描服务 API

• 媒体扫描服务从新创建或下载的媒体文件中读取元数据，并将文件添加到媒体数据库中。
• 媒体扫描服务相关类 AVLoggerConnection 的主要接口：

② 媒体扫描服务流程

• 媒体扫描服务分为动态调用和静态调用，以扫描文件为例：
• 动态调用：
• • 初始化 AVLoggerConnection，并注册回调函数：

	public class ScannerDemo implements AVLoggerConnectionClient {
	    private AVLoggerConnection scanConn;
	    public ScannerDemo(Context context) {
	        // 实例化  
	        scanConn = new AVLoggerConnection(context, this);    
	    }
	    // ...
	}

  

 

  
1
  
2
  
3
  
4
  
5
  
6
  
7
  
8
 

• • 连接媒体扫描服务：

	zScanConn.connect(); // 连接扫描服务

  

 

  
1
 

• • 在 onLoggerConnected 回调函数中执行扫描，开发者通过自定义文件的路径和类型扫描指定媒体文件：

	@Override
	public void onLoggerConnected() {
	    scanConn.performLoggerFile(filePaths[i], mimeTypes[i]); // 服务回调执行扫描    
	}

  

 

  
1
  
2
  
3
  
4
 

• • 在 onLogCompleted 回调函数中通知扫描结果：

	@Override
	public void onLogCompleted(String path, Uri uri) {
	     // 回调函数返回URI的值
	     scanConn.disconnect(); // 断开扫描服务        
	}

  

 

  
1
  
2
  
3
  
4
  
5
 

• 静态调用：
• • AVLoggerConnection 静态方法 performLoggerFile，扫描结果在 onLogCompleted 中通知：

	AVLoggerConnection.performLoggerFile(this, filePaths, null, new AVLogCompletedListener(){
	    @Override    
	    public void onLogCompleted(String path, Uri uri) {
	
	    }
	});

  

 

  
1
  
2
  
3
  
4
  
5
  
6
 

五、获取视频与图像缩略图

① 获取视频与图像缩略图 API

• 用于应用获取视频文件或图像文件的缩略图。
• 视频与图像缩略图获取相关类 AVThumbnailUtils 的主要接口：

② 获取视频与图像缩略图流程

• 获取视频文件的缩略图：

	PixelMap resMap = AVThumbnailUtils.createVideoThumbnail(videoFile, size);

  

 

  
1
 

• 获取图片文件的缩略图：

	PixelMap resMap = AVThumbnailUtils.createImageThumbnail(imageFile, size);

  

 

  
1
 

六、完整示例

• HarmonyOS之如何使用音视频播放控制框架实现音乐播放功能。

文章来源: blog.csdn.net，作者：Serendipity·y，版权归原作者所有，如需转载，请联系作者。

原文链接：blog.csdn.net/Forever_wj/article/details/118488264