HarmonyOS学习路之开发篇—多媒体开发（媒体数据管理开发）_harmonyos 开发

一、媒体数据管理开发概述

HarmonyOS媒体数据管理模块支持多媒体数据管理相关的功能开发，常见操作如：获取媒体元数据、截取帧数据等。

在进行应用的开发前，开发者应了解以下基本概念：

• PixelMap

  PixelMap是图像解码后无压缩的位图格式，用于图像显示或者进一步的处理。

• 媒体元数据

  媒体元数据是用来描述多媒体数据的数据，例如媒体标题、媒体时长等数据信息。

约束与限制

为及时释放native资源，建议在媒体数据管理AVMetadataHelper对象使用完成后，主动调用release()方法。

二、媒体元数据获取开发

场景介绍

媒体元数据是描述多媒体数据的数据，例如媒体标题、媒体时长、媒体的帧数据等。

接口说明

获取帧数据的开发步骤

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

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

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

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

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

avMetadataHelper.release();

获取媒体元数据的开发步骤

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

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

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

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

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

avMetadataHelper.release();

获取音频的图像数据的开发步骤

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

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

2. 获取音频的图像数据。

byte[] data = avMetadataHelper.resolveImage();

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

avMetadataHelper.release();

三、媒体存储数据操作开

场景介绍

媒体存储是提供了操作媒体图片、视频、音频等元数据的Uri链接信息。

接口说明

开发步骤

以播放视频文件为例：

获取媒体外部存储中的视频URI需要使用的预定义字段是：AVStorage.Video.Media.EXTERNAL_DATA_ABILITY_URI

查询数据前需要动态授予权限："ohos.permission.READ_MEDIA"

1. 根据媒体存储提供的Uri链接操作媒体元数据。

Context context = getContext();
DataAbilityHelper helper = DataAbilityHelper.creator(context);
try {
    DataAbilityPredicates dataAbilityPredicates = new DataAbilityPredicates("_id>?");
    dataAbilityPredicates.setWhereArgs(Arrays.asList("0"));
    Uri myUri = AVStorage.Video.Media.EXTERNAL_DATA_ABILITY_URI;
    // columns为null，查询记录所有字段，当前例子表示查询id字段
    ResultSet result = helper.query(myUri, null, dataAbilityPredicates);
    if (result == null) {
        return;
    }
    while (result.goToNextRow()) {
        int id = result.getInt(result.getColumnIndexForName(AVStorage.Video.Media.ID));// 获取id字段的值
    } catch (DataAbilityRemoteException e) {
        // ...
    }
}

2. 获取到媒体ID后，即可通过设置媒体源来进行业务操作，如：播放。

Uri uri = Uri.appendEncodedPathToUri​(AVStorage.Video.Media.EXTERNAL_DATA_ABILITY_URI, String.valueOf(id)); // id为步骤1获取到的id
Context context = getContext();
Player player = new Player(context);
DataAbilityHelper helper = DataAbilityHelper.creator(context);
player.setSource(new Source(helper.openFile(uri, "r")));
player.prepare();
player.play();

四、媒体扫描服务操作开发

场景介绍

媒体扫描服务从新创建或下载的媒体文件中读取元数据，并将文件添加到媒体数据库中。

接口说明

开发步骤

媒体扫描服务分为动态调用和静态调用，以扫描文件为例：

动态调用

1. 初始化AVLoggerConnection，并注册回调函数。

public class ScannerDemo implements AVLoggerConnectionClient {
    private AVLoggerConnection scanConn;
    public ScannerDemo(Context context) {
        // 实例化  
        scanConn = new AVLoggerConnection(context, this);    
    }
 
    @Override
    public void onLoggerConnected() {
        String path = "/path/";
        String mimeType = "video/mp4";
        scanConn.performLoggerFile(path, mimeType); // 服务回调执行扫描，指定要扫描的路径和文件类型    
    }
 
    @Override
    public void onLogCompleted(String path, Uri uri) {
         // 回调函数返回扫描到的URI和path的值
         scanConn.disconnect(); // 断开扫描服务        
    }
    // ...
}

2. 连接媒体扫描服务。

ScannerDemo zScanConn = new ScannerDemo(context);
zScanConn.connect(); // 连接扫描服务

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

@Override
public void onLoggerConnected() {
    scanConn.performLoggerFile(filePaths[i], mimeTypes[i]); // 服务回调执行扫描，指定要扫描的路径和文件类型    
}

4. 在onLogCompleted回调函数中通知扫描结果。

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

静态调用

1. AVLoggerConnection静态方法performLoggerFile, 扫描结果在onLogCompleted中通知。

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

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

场景介绍

用于应用获取视频文件或图像文件的缩略图。

接口说明

开发步骤

获取视频文件的缩略图。

File file = new File("/path/short_video.mp4");
Size size = new Size(400, 400);
PixelMap resMap = AVThumbnailUtils.createVideoThumbnail(videoFile, size);

获取图片文件的缩略图。

File file = new File("/path/short_video.mp4");
Size size = new Size(400, 400);
PixelMap resMap = AVThumbnailUtils.createImageThumbnail(imageFile, size);