你还在为音视频录制功能发愁吗？

HarmonyOS 的 AVRecorder，就是你一直在寻找的那把“万能钥匙”！

一、功能全面，兼容性强，开箱即用

AVRecorder 是 HarmonyOS 平台上强劲的音视频录制组件，支持以下主流格式：

• 音频编码格式：AAC、MP3等
• 视频编码格式：264 / AVC、H.265 / HEVC等
• 封装格式：MP4、M4A等

无论是会议备忘录音、K歌自嗨，还是VLog记录生活场景的功能开发，AVRecorder 都能轻松应对！

典型应用：智能录音笔、自定义相机、看家监控等！

二、开发门槛低，功能强劲，支持多种语言

ArkTS 开发

C/C++ NDK 开发

• 与底层硬件深度整合，适用于相机、音视频引擎等复杂项目
• 高性能音视频采集与处理

三、开发流程清晰，代码结构规范，易于维护

音视频录制流程（ArkTS 示例）：

// 1. 创建 AVRecorder 实例

const avRecorder =await media.createAVRecorder;

// 2. 配置参数并准备录制

const avConfig = {

audioSourceType: media.AudioSourceType.AUDIO_SOURCE_TYPE_MIC,

videoSourceType: media.VideoSourceType.VIDEO_SOURCE_TYPE_SURFACE_YUV,

profile: {

audioBitrate: 112000,

audioChannels: 2,

audioCodec: media.CodecMimeType.AUDIO_AAC,

fileFormat: media.ContainerFormatType.CFT_MPEG_4,

videoBitrate: 200000,

videoCodec: media.CodecMimeType.VIDEO_AVC,

videoFrameWidth: 640,

videoFrameHeight: 480，

},

url: ‘fd://xx’， // 参考应用文件访问与管理开发示例新建并读写一个文件。

};

await avRecorder.prepare(avConfig);

// 3. 获取 Surface ID，传递给相机模块

await avRecorder.getInputSurface;

// 4. 开始/暂停/恢复/停止录制

avRecorder.start;

avRecorder.pause;

avRecorder.resume;

avRecorder.stop;

// 5. 释放资源

avRecorder.reset;

avRecorder.release;

四、NDK 开发：

示例代码片段（C++）：

// 1. 创建 AVRecorder 实例 OH_AVRecorder* avRecorder = OH_AVRecorder_Create;

// 2. 配置参数并准备录制

OH_AVRecorder_Config config;

config.audioSourceType = AVRECORDER_MIC;

config.profile.audioBitrate = 96000;

config.profile.audioChannels = 2;

config.profile.audioCodec = AVRECORDER_AUDIO_AAC;

config.profile.audioSampleRate = 48000;

config.profile.fileFormat = AVRECORDER_CFT_MPEG_4;

config.fileGenerationMode = AVRECORDER_APP_CREATE;

config.metadata.location.latitude = 27.791863;

config.metadata.location.longitude = 64.574687;

OH_AVRecorder_Prepare(avRecorder, &config);

// 3.启动相机，获取 Surface ID，传递给相机模块
OH_AVRecorder_GetInputSurface(avRecorder, &window);

// 4. 开始/暂停/恢复/停止录制

OH_AVRecorder_Start(avRecorder);

OH_AVRecorder_Pause(avRecorder);

OH_AVRecorder_Resume(avRecorder);

OH_AVRecorder_Stop(avRecorder);

// 5. 释放资源

OH_AVRecorder_Reset(avRecorder);

OH_AVRecorder_Release(avRecorder);

五、开发提议

• 严格遵守状态机规则：只有在 started状态下才能调用 pause，在 paused 状态下才能调用 resume。
• 资源释放不可忽视：录制结束后务必调用 release避免内存、线程等系统资源泄漏。
• 权限管理要到位：当需要使用麦克风时，需提前申请麦克风权限。

六、为什么选择 AVRecorder？

• 高效稳定，轻松构建专业级音视频应用
  AVRecorder 提供了方便快捷的音视频录制能力，协助开发者快速构建稳定流畅的多媒体应用，生成音视频文件。
• 原生支持，无缝加入鸿蒙生态
  作为鸿蒙系统原生的录制框架，AVRecorder 与系统深度集成，兼容性强，能充分发挥鸿蒙设备的硬件能力，为开发者提供更顺畅的开发体验和更佳的用户体验。
• 灵活配置，满足多样化需求
• 支持多种音视频格式、编码参数和录制模式的自定义配置，开发者可根据不同应用场景灵活调整录制设置，打造个性化的音视频解决方案。
• 开放文档与社区支持，快速上手
  提供完善的官方文档和丰富的示例代码，配合活跃的开发者社区支持，协助开发者快速掌握 AVRecorder 的使用技巧，提升开发效率。

七、立即行动，开启你的音视频开发之旅！

点击了解完整开发示例与 API 文档

加入 HarmonyOS 社区，共创未来！

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

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

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

题图来自Unsplash，基于 CC0 协议。