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

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

还在手动拼装播放器、录屏、录制、元数据解析逻辑？
别急——这份 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. 视频播放流程

流程说明：应用从XComponent组件获取窗口SurfaceID，获取方式参考XComponent。应用把媒体资源、SurfaceID传递给AVPlayer接口。Player Framework把视频ES数据流输出给解码HDI，解码获得视频帧（NV12/NV21/RGBA）。Player Framework把音频PCM数据流输出给Audio Framework，Audio Framework输出给音频HDI。Player Framework把视频帧（NV12/NV21/RGBA）输出给Graphic Framework，Graphic Framework输出给显示HDI。

（2）SoundPool：播放短音频

📌 1. 功能简介

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

📌 2. 交互关系图

流程说明：

音频应用将媒体资源传递给SoundPool接口。Player Framework将音频PCM数据流输出给Audio Framework，再由Audio Framework输出给音频HDI。

（3）AVRecorder：录制音视频

📌 1. 功能简介

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

📌 2. 交互关系图

流程说明：

应用通过AVRecorder接口从录制服务获取SurfaceID。应用将SurfaceID设置给相机服务，相机服务可以通过SurfaceID获取到Surface。相机服务通过视频HDI捕获图像数据送至框架层的录制服务。相机服务通过Surface将视频数据传递给录制服务。录制服务将音频参数设置给音频服务，并从音频服务获取到音频数据。录制服务通过编码服务将音视频数据编码。