motion-graphics
一支影片就是一個 HTML 頁面,其每一個像素都是時間 t 的純函數,在無頭 Chromium 中逐幀渲染,並用 ffmpeg 編碼。目標是達到資深動態設計師的專業水準,絕非幻燈片簡報。
1. 選擇格式
| 需求 | 請閱讀 |
|---|---|
| 為實際產品製作發布、宣傳、商業廣告、功能集錦、應用程式預告 | formats/launch-video.md |
| 短片、Reels、TikTok、垂直解說或故事 | formats/shorts.md |
依照格式檔案來獲取簡報、內容步驟和節拍結構。完成後會回到此處進行建置。在開始撰寫腳本之前,也請閱讀 references/pitfalls.md。
每次運行都是全新概念。 每支影片都應有其獨特的構想、腳本和外觀。當使用者要求不要參考過去作品時,請保持工作區中之前的影片和腳本檔案未被開啟。
2. 工作資料夾
在使用者指定的位置(預設為當前目錄)建立 <slug>-<YYYYMMDD>/ 資料夾:
brief.md 從格式檔案簡報表取得的參數
beats.md 節拍表(時間、文案、素材、動作、轉場、重音提示)
assets/ 螢幕錄製、圖片、字型、音訊
assets/manifest.md 每行一個素材檔案:來源、授權或「從 <畫面> 擷取」、內容說明
motion.html 腳本檔案
motion.json {"size": [W, H], "fps": 60, "duration": 30, "stills": [節拍時間點], "captions": []}
engine/ 從此技能的 engine/ 複製而來
out/ 靜止圖格、渲染成果、連絡表
每個資料夾只需設定一次引擎:
cp -R <this-skill>/engine engine && (cd engine && npm install && npx playwright install chromium)
3. 編排
motion.html 會載入 engine/runtime.css 和 engine/runtime.js,建立其 DOM、註冊場景,然後呼叫 MG.ready()。
| 輔助函式 | 用途 |
|---|---|
MG.scene(start, end, fn, el) | fn(local, t, dur) 在 start <= t < end 期間執行;el 在此區間外隱藏。每次呼叫都需設定所有會動的屬性。 |
MG.always(fn) | 每一幀都執行:背景、噪點、進度條。 |
MG.prog(t, a, b, ease) | 0..1 之間的緩動進度。緩動函式:MG.ease.*(linear, in/out/inOut Quad, Cubic, Quart, Expo, inBack, outBack, outElastic, outBounce)或任何自訂函式。 |
MG.tween(t, [[t0, v0], [t1, v1, ease], …]) | 關鍵影格;數值可以是陣列。 |
MG.spring(t, {stiffness, damping}) | 物理模擬的 0 → 1 回彈效果,含 overshoot。 |
| `MG.split(el, "grapheme" | "word")` |
MG.set(el, {x, y, s, sx, sy, r, o, blur, ...css}) | 每幀對每個元素呼叫一次。 |
MG.clip(videoEl, start, rate) | 從 start 開始,逐幀精確播放螢幕錄製。 |
MG.rng(seed), MG.noise(x, seed) | 確定性亂數和波動。 |
MG.fmt(n, {decimals}) | 數字格式化,用於計數器。 |
MG.captions() | 在底部 UI 區塊上方繪製 motion.json 中的字幕。 |
確定性:渲染邏輯中不得使用 Date、performance.now()、requestAnimationFrame 或 Math.random。允許使用 CSS @keyframes;運行時會在時間 t 將其暫停,因此請使用 animation-delay 來設定時間。僅使用素材清單中列出的字型和圖片。
預覽某一幀:open "motion.html?w=1920&h=1080&t=3.2&guides=1"(guides 會顯示安全區域)。即時預覽:?play=1。字幕僅在渲染時顯示。
4. 工藝標準
- 第 0 幀已處於動作中。 沒有從黑畫面淡入,沒有 logo 開場。
- 每 0.8–2 秒內有有意義的變化:佈局、縮放、顏色、數字或鏡頭。
- 入場使用 spring 或 ease-out-expo,並帶有輕微 overshoot;使用 30–60 毫秒的錯開時間;僅計數器使用線性動畫。
- 僅在快速移動時使用動態模糊;靜止畫面上緩慢推近(縮放 1 → 1.04);在 2–3 個深度層之間創造視差。
- 一種背景系列、一種文字顏色、一種強調色。添加顆粒或漸層噪點,以免大片純色在上傳後出現色塊。
- 文案停留在畫面上的時間足夠閱讀兩次;關鍵文字保持在安全區域內。
- 節拍要與聲音同步:每次變化都伴隨一聲嗖聲、撞擊聲或音樂節拍。
5. 渲染
node engine/render.mjs --html motion.html --config motion.json --stills <t1,t2,...> --stills-dir out/stills
node engine/render.mjs --html motion.html --config motion.json --out out/video.mp4 --workers 4
先用靜止圖格確認佈局:每個節拍一張、每個補間動畫內部一張、每個 spring 的 overshoot 峰值一張。一次只運行一個完整渲染作業(25 秒、1080p60、4 個 worker 約需 10 分鐘)。
6. 音訊
僅使用素材清單中明確列出、授權允許使用,或使用者提供的音樂和音效。若無,則輸出無聲影片並明確說明。混合音軌後進行封裝:
ffmpeg -i music.wav -i whoosh.wav -filter_complex \
"[0]volume=-16dB[m];[1]adelay=1200|1200,volume=-8dB[a];[m][a]amix=inputs=2:normalize=0[out]" -map "[out]" out/mix.wav
ffmpeg -i out/video.mp4 -i out/mix.wav -map 0:v -map 1:a -c:v copy \
-af "loudnorm=I=-14:TP=-1.5:LRA=11" -c:a aac -b:a 256k -shortest -movflags +faststart out/final.mp4
ffmpeg -i out/final.mp4 -af ebur128=peak=true -f null - 2>&1 | grep -E "^ +(I|Peak):"
目標:綜合響度約 −14 LUFS,真實峰值低於或等於 −1 dBFS。音效約 −6 至 −14 dB,音樂約 −14 至 −18 dB。畫面上有文字時,背景音樂應為純音樂。
7. 品質檢查
- 使用
ffprobe確認時長、尺寸和幀率符合簡報要求。 - 製作連絡表:
ffmpeg -i out/final.mp4 -vf "fps=2,scale=360:-1,tile=10x6" -frames:v 1 out/contact.png。檢視連絡表以及每個節拍變化處的全尺寸幀(ffmpeg -ss <t> -i out/final.mp4 -frames:v 1 out/check-<t>.png)。 - 每一幀:邊緣無裁切、無空白或半透明幀、無殘留輔助線、無錯字或預留位置文字、無靜止超過 2 秒的畫面。
- 格式檔案本身的檢查項目。
修正並重新渲染,直到所有檢查通過。將任何新學到的教訓以 日期 · 影片 · 教訓 的格式添加到技能中的 references/pitfalls.md 檔案。
交付
報告最終 MP4 的路徑、長度、大小和幀率、內容說明、音訊狀態(含必要的聲明),以及重新渲染的指令。保留工作資料夾。僅在使用者要求時才上傳或發布。