导出与分享

导出会直接将当前编排渲染到本地文件，并报告任务的每个阶段。

选择格式

格式	视频编解码器选择	音频编解码器	可用性
WebM	VP9、VP8、AV1 中第一个可编码的编解码器	Opus	默认格式；要求存在可编码的视频编解码器，并且在包含音频时需要 Opus。
MP4	AVC / H.264	AAC	要求 AVC 编码器。AAC 在可用时使用 WebCodecs，然后回退到 Beam 的 Mediabunny AAC 编码器。

编码器可用性

当设备没有提供兼容的编码器时，某种格式可能不可用。Beam 会在导出之前或期间报告这一点。

选择分辨率

选项	可用性	输出行为
720p	原生画布高度至少为 720 px	目标高度为 720 px，不进行放大。
1080p	原生画布高度至少为 1080 px	目标高度为 1080 px，不进行放大。
最大	始终可用	保留原生输出画布尺寸。
所有选项	不适用	保留宽高比，并将宽度和高度四舍五入为正偶数。

选择帧率和质量

设置	值	默认值或建议
帧率	24、30、60 fps	源帧率不低于 50 fps 时为 60；不高于 27 fps 时为 24；其他情况为 30。
质量	低、中、高	中
低码率系数	0.055 × 宽度 × 高度 × fps	限制在 0.5–40 Mbps。
中码率系数	0.095 × 宽度 × 高度 × fps	限制在 0.5–40 Mbps。
高码率系数	0.16 × 宽度 × 高度 × fps	限制在 0.5–40 Mbps。

Screenshot pendingAdd the image at:website/docs/public/screenshots/reference/export-panel.webp

选择目标文件前，先选择渲染设置。

更多选项

选项	值	默认值	行为
包含音频	开启或关闭	开启	关闭时创建静音文件。如果没有启用的音频片段具有正时长，也会省略音频。
音频输出	48 kHz、立体声、128 kbps	包含音频时	启用的音频片段会逐步混合到选定的容器编解码器中。

监控导出

进度视图会报告百分比和已完成帧数，并提供“复制报告”。取消会停止活动导出。关闭或取消目标文件选择器会结束任务，但不会报告错误。导出开始后进行的实时编辑不会改变进行中的文件，因为 Beam 导出的是快照。

阶段	Beam 的操作
验证资源	检查快照、本地资源、格式、编解码器和渲染不变量。
加载资源	加载视觉、音频、光标、字体和背景资源。
编码	渲染编排帧，混合启用的音频，并写入编码后的块。
完成	关闭轨道并完成媒体容器和目标文件。

验证和边界情况

条件	结果
缺少资源	导出会因验证问题停止，并指出相关资源或片段。
不受支持的来源或编解码器	导出会报告不受支持的格式、编解码器或解码失败。
没有兼容的输出编码器	会报告选定的 WebM 或 MP4 格式无法在设备上编码。
动画 GIF	动画 GIF 目前无法进行确定性导出。
Canvas 2D 不可用	导出会停止，因为无法渲染编排帧。
取消	活动 worker 和输出流会中止，不完整的导出不会被报告为失败。
音频混合器不可用	Beam 会报告 Chromium 构建中离线音频混合不可用。

结果和诊断

导出成功后，Beam 会报告保存的文件名，并提供“打开文件”和“复制报告”操作。如果导出失败，面向用户的消息会隐藏本地文件系统路径，而详细报告会保留配置、编解码器、环境、进度和瓶颈信息以便排查。在 Discord 或 GitHub 上寻求帮助前，请先复制该报告。