【HarmonyOS- 媒体技术 -Media Kit】HarmonyOS 音视频开发全栈解析

 还在手动拼装播放器、录屏、录制、元数据解析逻辑？别急——这份 HarmonyOS Media Kit 文档，就是你通往全场景多媒体开发的“通关指南”；

👉 您可以通过此文档了解到 Media Kit 的 6 大核心功能模块、典型场景以及基础流程，【快速上手】零基础也能秒变“音视频高手”；

一、概述

Media Kit 让开发者可以调用系统的音视频能力，涵盖播放、录制、录屏、元数据提取与转码六大核心功能模块，支撑系统应用与第三方应用在视频播放、内容创作、教学录屏、直播互动等典型场景下的音视频处理需求。系统框架和各核心功能模块介绍如下：

🎯核心功能模块

简要概述播放长短视频、录制、录屏、元数据、转码的功能描述及典型场景

🎯简易架构图

简要描述鸿蒙系统架构、Media Kit 提供的服务以及 TOP 使用 Media Kit 的系统应用和三方应用

二、Media Kit 的核心亮点

• 轻量媒体引擎

占用系统资源少（线程、内存），支持 pipeline 拼装、插件化扩展（source/demuxer/codec）。

• HDR 视频支持

支持 HDR Vivid 格式采集与播放，提升视觉体验。

• 音频池机制（SoundPool）

适用于短音效播放场景（如系统提示音、游戏音效等），支持一次加载、多次低延迟播放。

三、Media Kit 六大功能模块简介

（1）AVPlayer：播放音视频

📌1. 功能简介

AVPlayer 负责将音频/视频资源（如 MP4、MP3、MKV、MPEG-TS 等）解码为可渲染的图像和音频信号，并通过输出设备播放。

它支持：

• 音频播放（如音乐播放器）

• 视频播放（如视频播放器）

📌2. 视频播放流程

流程说明：

1. 应用从 XComponent 组件获取窗口 SurfaceID，获取方式参考XComponent。

2. 应用把媒体资源、SurfaceID 传递给 AVPlayer 接口。

3. Player Framework 把视频 ES 数据流输出给解码 HDI，解码获得视频帧（NV12/NV21/RGBA）。

4. Player Framework 把音频 PCM 数据流输出给 Audio Framework，Audio Framework 输出给音频 HDI。

5. Player Framework 把视频帧（NV12/NV21/RGBA）输出给 Graphic Framework，Graphic Framework 输出给显示 HDI。

（2）SoundPool：播放短音频

📌1. 功能简介

SoundPool 专为短音频播放设计，适用于提示音、通知音等低延迟、高频次播放场景。

📌2. 交互关系图

 流程说明：

1. 音频应用将媒体资源传递给 SoundPool 接口。

2. Player Framework 将音频 PCM 数据流输出给 Audio Framework，再由 Audio Framework 输出给音频 HDI。

（3）AVRecorder：录制音视频

📌1. 功能简介

AVRecorder 可实现音频、视频、音视频混合录制，支持自定义编码格式、封装格式等参数。

📌2. 交互关系图

 流程说明：

1. 应用通过 AVRecorder 接口从录制服务获取 SurfaceID。

2. 应用将 SurfaceID 设置给相机服务，相机服务可以通过 SurfaceID 获取到 Surface。相机服务通过视频 HDI 捕获图像数据送至框架层的录制服务。

3. 相机服务通过 Surface 将视频数据传递给录制服务。

4. 录制服务将音频参数设置给音频服务，并从音频服务获取到音频数据。

5. 录制服务通过编码服务将音视频数据编码。

（4）AVScreenCapture：屏幕录制

📌1. 功能简介

AVScreenCapture 支持屏幕录制功能，分为 录屏存文件 和录屏取码流 两种模式。

📌2. 交互关系图

 流程说明：

1. 应用通过 AVScreenCapture 发起录屏。

2. 录屏服务通过图形服务获取屏幕数据。

3. 录屏服务将音频参数设置给音频服务，并从音频服务获取到音频数据。

4. 录屏服务通过编码服务将音视频数据编码。

（5）AVMetadataExtractor：获取音视频元数据/缩略图

📌1. 功能简介

AVMetadataExtractor 用于从音视频资源中提取元数据，如标题、艺术家、专辑、时长等信息，从视频中提取指定时间点的画面，生成缩略图。

📌2. 交互关系图

 流程说明：

1. 应用通过 AVMetadataExtractor 接口去获取元数据（如标题、艺术家等）/缩略图；

2. 调用解封装/解码能力获取相应数据。

（6）AVTranscoder：视频转码

📌1. 功能简介

AVTranscoder 主要用于将已压缩编码的视频文件按照指定参数转换为另一种格式的视频。

📌2. 交互关系图

流程说明：

1. 应用通过 AVTranscoder 接口进行视频文件的格式转换；

2. 调用 AVCodec 的封装解封装、编解码服务，将音视频数据按照应用配置的新参数进行重新编码封装。

四、参考资料

• HarmonyOS Media Kit 官方文档
  

• AVPlayer 开发指南
  

• SoundPool 开发指南
  

• AVRecorder 开发指南
  

• AVScreenCapture 开发指南
  

• AVMetadataExtractor 开发指南
  

• AVTranscoder 开发指南
  

五、结语

Media Kit 提供了一整套音视频开发工具链，无论你是开发音乐播放器、视频播放器、录音应用，还是屏幕录制工具，都能找到合适的组件来实现功能。

如果你希望打造一款高质量、高性能、高兼容性的音视频应用，Media Kit 就是你不可或缺的开发伙伴。

🌏加入 HarmonyOS 社区，共创未来！

我们诚邀广大开发者一起参与 HarmonyOS 技术生态建设，共建更开放、更智能的未来世界！

👉加入开发者社区，获取最新资讯和技术支持

📎HarmonyOS 官方社区

👉让 Media Kit 成为你开发路上的得力助手，开启你的音视频开发新纪元！🚀