remotion-composition-builder
實際執行的元件。讀取所有其他內容,撰寫 TSX。
觸發時機
remotion-orchestrator計畫中的第四波。- 使用者要求「為 {主題} 建立合成元件」,且品牌設定與分鏡腳本已備妥。
輸入
從同一工作中先前技能的輸出取得:
BrandConfig(來自src/brands/{slug}.ts)— 執行期與行為:語音、旁白、動態、受眾、頻道、禁用詞彙{slug}.design.md(透過src/brands/loadDesign.ts的loadDesign(slug)載入)— 視覺代碼:顏色、字型、間距、元件、佈局、高度- 分鏡腳本 JSON(來自
remotion-screen-storyteller) - 佈局規格(來自
remotion-designer)— 以名稱參考 design.md 代碼 - 動態區塊(
BrandConfig的一部分) - 頻道規格/畫面比例(來自
remotion-marketing-strategist)
請參閱 src/brands/CONTRACT.md 了解 BrandConfig 與 design.md 之間的完整所有權邊界。
方法
- 定位合成元件 —
src/compositions/{Name}.tsx是否存在?- 是 → 就地修補(保留現有 API)。
- 否 → 使用
Explainer.tsx作為模板建立新檔案。
- 匯入處理 — 執行期匯入
import { brands } from '../brands',視覺代碼匯入import { loadDesign, colour, spacing, componentRecipe, typography } from '../design',動態輔助函式從../motion匯入。 - 定義結構 — 使用
z.object定義輸入 props,對應分鏡腳本形狀。 - 組合場景 — 每個分鏡腳本場景對應一個
<Sequence>。每個場景元件讀取cfg = brands[props.brand](用於動態/語音/旁白)與tokens = loadDesign(props.brand)(用於顏色/字型/間距/元件配方),然後進行組合。使用componentRecipe(tokens, 'cta-primary')取得完全解析的 CSS 準備物件,而非內嵌十六進位色碼。 - 音訊 — 若路徑有設定,則為每個場景加入
<Audio src={staticFile(scene.voiceoverAudioPath)} />。 - 在 Root 中註冊 — 在
src/Root.tsx中加入或更新<Composition id="{Name}" ... />。durationInFrames = sum(scene.durationSec) * fps。 - 檔案整潔 — 合成檔案 ≤500 行。若超出此限制,將場景提取至
src/compositions/{Name}/scenes/*.tsx。 - 型別檢查 — 執行
npx tsc --noEmit。若有錯誤,修正後重試一次。
輸出
編輯的檔案:
src/compositions/{Name}.tsx(或場景子檔案)src/Root.tsx(註冊條目)
狀態報告給 remotion-orchestrator:
{ "composition": "Explainer", "filesChanged": [...], "tscPassed": true, "ready": true }
邊界
- 絕不內嵌品牌值(十六進位色碼、字型名稱、間距字面量)— 一律從
tokens(視覺)或cfg(執行期)讀取。請參閱CONTRACT.md了解各側擁有什麼。 - 絕不設定
durationInFrames而未將分鏡腳本場景持續時間 × fps 加總。 - 絕不對不存在的資源路徑使用
staticFile()— 在建置時要大聲失敗,而非在渲染時靜默失敗。 - 入口動態絕不繞過
signatureEntry()— 保持動態語言一致性。 - 絕不在
BrandConfig.ts與{slug}.design.md之間重複宣告代碼。若值存在於.design.md,則.ts不得重新宣告。
被重複使用的資源
src/compositions/Explainer.tsx— 標準模板src/motion/index.ts—signatureEntry、brandFadeIn、staggerStartsrc/colour/index.ts—readableOn、brandGradient、contrastsrc/design/index.ts—loadDesign、colour、spacing、typography、componentRecipe、resolveTokensrc/brands/loadDesign.ts— 用於{slug}.design.md的型別載入器src/brands/CONTRACT.md—BrandConfig↔design.md所有權邊界
交接給
remotion-render-pipeline 進行實際渲染。