匯出與分享

匯出會直接將當前編排渲染到本地檔案，並報告任務的每個階段。

選擇格式

格式	影片編解碼器選擇	音訊編解碼器	可用性
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 上尋求幫助前，請先複製該報告。