渲染與交付
請先執行 pnpm mg check <客戶>/<專案>;僅在報告沒有問題時才進行渲染。
渲染
pnpm mg render <客戶>/<專案> 全部片段
pnpm mg render <客戶>/<專案> lt-ceo 一個片段
pnpm mg render <客戶>/<專案> --force 即使未變更也重新渲染
輸出:renders/<片段>_v<序號>.<副檔名>。每個改變像素的渲染會獲得下一個版本號;舊版本會保留。renders/manifest.json 記錄影響像素的所有內容的雜湊值(屬性、解析後的代幣、字型/標誌/素材內容、預設集、工具包版本、客戶端範本程式碼)。未變更的片段會跳過。
預設集
| 預設集 | 檔案 | 用途 |
|---|---|---|
overlay(預設) | ProRes 4444 .mov 含 Alpha 通道 | 在 Resolve/Premiere/FCP 中覆蓋在素材上的下三分之一與標題 |
delivery | H.264 .mp4,透明區域為黑色 | 審閱連結、全幀圖形 |
webm-alpha | VP9 .webm 含 Alpha 通道 | 網頁播放器;大多數編輯器忽略 WebM Alpha |
可依片段設定("preset")、依專案設定(project.json)或依執行指令設定(--preset)。
交付
當使用者交付出專案(或表示圖形已是最終版本)時:
pnpm mg deliver <客戶>/<專案> [片段…]
它會渲染已變更的內容,驗證每個檔案(overlay/webm-alpha 的 Alpha 通道、幀大小、FPS),凍結專案,並將最終檔案複製到 deliver/<YYYY-MM-DD>/<片段>.<副檔名>。如果驗證失敗,則不會凍結或複製任何內容;請修復報告的問題並重新執行。告知使用者 deliver/ 資料夾路徑。
凍結意味著:後續的內部、客戶或變體編輯不會改變此專案的渲染結果。
套用品牌變更
在使用者變更客戶或變體代幣(新的顏色、字型、標誌)後:
- 預覽:
pnpm mg rebrand <客戶>(或<客戶>/<專案>用於單一專案)。它不會做任何修改,並按專案列出當前品牌會更改的內容。設定為"extends": "none"的專案會跳過。 - 向使用者顯示清單,詢問要更新哪些:全部、部分專案,或都不更新(僅新作品)。
- 套用使用者選擇的項目:
pnpm mg rebrand <客戶> --apply或按專案執行pnpm mg rebrand <客戶>/<專案> --apply。凍結的專案會重新鎖定到當前品牌;所有列出的專案會渲染成新版本。舊版本保留在renders/中。 - 對新渲染執行
motion-qa。對於使用者再次交付的專案,執行pnpm mg deliver以重新整理deliver/。
不執行重新品牌化也是有效的答案:凍結的專案保持其交付的外觀,只有未凍結的專案在下次渲染時跟隨品牌。
其他品牌指令:
pnpm mg diff <客戶>/<專案>:查看單一專案與其鎖定(凍結)或上次渲染(未凍結)之間的差異。- 對一個自上次渲染後品牌已變更的未凍結專案進行渲染,會列印包含變更的警告。
- 在凍結專案上僅編輯專案代幣:編輯
tokens.json,然後執行pnpm mg rebrand <客戶>/<專案> --apply。
失敗情況
- 命名屬性、代幣、字型或文字寬度的錯誤來自驗證;請修正 JSON,而非範本。
pnpm mg check會一次列出所有問題。 - 瀏覽器啟動、缺少函式庫、編碼器或路徑錯誤:請執行
pnpm mg doctor。