• 音视频
• 移动开发

Open Video Editor是一款基于 Media3 和 Jetpack Compose 打造的开源 Android 视频编辑器。它的导出功能支持选择 H.264/H.265 等编码、调整分辨率、裁剪媒体类型（仅视频/仅音频）等，是新手最容易踩坑的环节。本文用一张导出设置速查表和逐项解读，帮你在 5 分钟内选对每个选项。

一、导出前的 3 步操作

1. 打开一个视频（或.ove工程文件）进入编辑界面；
2. 点击右上角 ⋮ 菜单，选择Export；
3. 在弹出的对话框中确认各项设置后点击Export，再选择文件保存位置即可开始渲染。

导出对话框的全部选项逻辑位于 VideoEditorScreen.kt，保存路径由 VideoEditorActivity.kt 中以video/mp4类型创建的文档决定，即最终文件固定为 MP4 容器。

二、媒体类型怎么选（Media to Export）

对应设置项见 TransformManager.kt 中的ExportSettings。

三、H.264 还是 H.265？视频编码对比

Video Type下拉框提供：Original（保持原编码）、video/3gpp（H.263）、video/avc（H.264）、video/hevc（H.265）、video/mp4v，选项定义在 TransformManager.kt。

注意：设备 API 24 以下不支持 H.265 输出，系统支持列表见 CustomFrameworkMuxer.java。拿不准就选H.264，兼容性最稳。

四、分辨率调整：三种 Layout 模式

分辨率不在导出对话框里，而是通过编辑界面的Resolution效果设置（在 UserEffects.kt 中实现）。填入目标宽/高后，有三种布局：

• Scale to fit：等比缩放，画面完整，可能留黑边；
• Scale to fit with crop：等比缩放并裁掉超出部分，无黑边；
• Stretch to fit：强制拉伸填满，画面会变形。

💡 小贴士：竖屏短视频发横屏平台（如 YouTube）时，用 "Scale to fit with crop" 最省心。

五、速度、帧率与无损剪切

• Speed：播放倍速，如2表示 2 倍速；
• Framerate：目标帧率，必须低于原片帧率（程序会自动校验并提示）；
• Lossless cut：开启后直接通过 FFmpeg 拷贝视频流（-c:v copy）完成剪切，速度极快、零画质损失，但只导出剪切部分，其他效果不生效。注意开启剪切功能后此选项才可用，见 TransformManager.kt 中的export流程。

六、HDR 模式与音频编码

HDR Mode针对 HDR 视频导出：

• Keep HDR：保留 HDR 信息（默认）；
• HDR as SDR：直接按 SDR 显示，可能过曝；
• HDR to SDR (Mediacodec / OpenGL)：硬件/软件色调映射，转为普通 SDR，推荐发给普通设备观看时使用。

Audio Type可选Original、audio/aac、audio/amr-nb、audio/amr-wb。日常分享选 AAC 即可；AMR 两种编码体积最小但音质低，主要用于语音场景。

七、导出失败？常见错误速查

导出进度条实时刷新，完成后会自动触发媒体库扫描，稍等即可在相册中查看新文件。

八、导出设置速查表

更多功能（Grayscale、Scale、Rotate 等）可参考项目说明 README.md。掌握以上选项，你就能在 Open Video Editor 中完成高质量导出了。🎬

• 音视频
• 移动开发