harmony 鸿蒙使用AVImageGenerator提取视频指定时间图像(ArkTS)

2025-06-12
浏览 (5)

使用AVImageGenerator提取视频指定时间图像(ArkTS)

使用AVImageGenerator可以实现从原始媒体资源中获取视频指定时间的缩略图，本开发指导将以获取一个视频资源的缩略图作为示例，向开发者讲解AVImageGenerator相关功能。

获取视频资源的缩略图的全流程包含：创建AVImageGenerator对象，设置资源，获取缩略图，销毁资源。

开发步骤及注意事项

使用createAVImageGenerator()创建实例。

   import { media } from '@kit.MediaKit';
   let avImageGenerator: media.AVImageGenerator = await media.createAVImageGenerator();

设置资源：需要设置属性fdSrc（表示文件描述符）。 > 说明： > > 开发者需根据实际情况，确认资源有效性并设置fdSrc： > - 可以使用ResourceManager.getRawFd打开HAP资源文件描述符，使用方法可参考ResourceManager API参考。 > > - 也可以使用应用沙箱路径访问对应资源（必须确认资源文件可用），参考获取应用文件路径。应用沙箱的介绍及如何向应用沙箱推送文件，请参考文件管理。 > > - 不同AVImageGenerator或者AVMetadataExtractor，如果需要操作同一资源，需要多次打开文件描述符，不要共用同一文件描述符。

   import { common } from '@kit.AbilityKit';
   // 获取当前组件所在Ability的Context，并通过Context获取应用文件路径。
   let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
   // 设置fdSrc，H264_AAC.mp4为rawfile目录下的预置资源，需要开发者根据实际情况进行替换。
   avImageGenerator.fdSrc = await context.resourceManager.getRawFd('H264_AAC.mp4');

获取指定时间图像：调用fetchFrameByTime()，可以获取到一个PixelMap对象，该对象可用于图片显示。 “`ts import { image } from ‘@kit.ImageKit’;

// pixelMap对象声明，用于图片显示。 @State pixelMap: image.PixelMap|undefined = undefined;

// 初始化入参。 let timeUs = 0; // 需要获取的缩略图在视频中的时间点。 let queryOption = media.AVImageQueryOptions.AV_IMAGE_QUERY_NEXT_SYNC; // AV_IMAGE_QUERY_NEXT_SYNC表示选取传入时间点或之后的关键帧。 // 输出缩略图的格式参数。 let param: media.PixelMapParams = { width : 300, // 输出的缩略图宽度。 height : 300 // 输出的缩略图高度。 };

// 获取缩略图（promise模式）。 this.pixelMap = await avImageGenerator.fetchFrameByTime(timeUs, queryOption, param);


4. 释放资源：调用release()销毁实例，释放资源。
   ```ts
   // 释放资源（promise模式）。
   avImageGenerator.release();

运行示例工程

参考以下示例，获取一个视频指定时间的缩略图。

新建工程，下载完整示例工程，并将示例工程的资源复制到对应目录。 AVImageGeneratorArkTS entry/src/main/ets/ └── pages └── Index.ets (获取缩略图界面) entry/src/main/resources/ ├── base │ ├── element │ │ ├── color.json │ │ ├── float.json │ │ └── string.json │ └── media │ └── rawfile └── H264_AAC.mp4 (视频资源)
编译新建工程并运行。