Motion 程式碼動畫 是做什麼的?
影片即程式碼。 我撰寫一個程式,以單一時鐘 t 繪製每一幀,逐幀渲染後組合成 MP4。因此,Hex 顏色、品牌字型與數字都能完全精確:它們是寫出來的,而非由生成器解讀的。因此,要求「放慢 30%」或「改為 9:16」只須修改一行,無須重做整支影片。
不適用範圍: 拍攝人物、地點或產品;從零產生照片級寫實圖像;猜測品牌。品牌的真實照片、影片與畫面須以檔案形式提供,程式碼則動畫化所提供的內容。
真實影片基底須以幀序列方式導入,絕不使用 <video>:ffmpeg -i base.mp4 -q:v 3 frames/f%04d.jpg,並在 draw 中使用 floor(t × fps) + 1 的幀圖像,按需載入。使用 <video> 會導致渲染伺服器無法處理 Range 請求(無法跳轉),且媒體連線永不關閉(networkidle 會逾時)。
需求: Python 3.10+,pip install playwright + playwright install chromium(腳本使用 chrome 頻道;若未安裝 Chrome,請在 abrir() 中切換為預設 Chromium),與 PATH 中的 ffmpeg 及 ffprobe。
此技能的檔案:
assets/template.html:引擎,包含單一時鐘、固定隨機種子、Easing、Stagger、播放器(含時間軸與場景名稱)及安全區域。scripts/render.py:逐幀渲染 MP4、短版片段及校對表。tecnicas.md:7 大類共 39 種技術,包含各技術的參數與依目標的組合方式。exemplos/reel-resultado-8s.html:8 秒成品範例(數字亂序 → 長條圖 → 含彩花的 CTA),附範例資料。
工作目錄:每個影片獨立資料夾(例如 motion/<品牌>/<影片>/)。HTML、素材(Logo、照片、字型)、MP4 與校對表皆存放於此。
步驟 0 — 品牌素材包
每個品牌只需建立一次,依據手冊、官網或委託人提供的資料:
| 項目 | 如何導入 |
|---|---|
| 色板 | Hex 與用途:背景、文字、強調色、數字色。3 到 4 種顏色;7 種顏色代表顏色過多、對比不足 |
| 字型 | 確切名稱。Google Fonts → <link>;自有字型 → 資料夾中的 檔案 + @font-face |
| Logo | 檔案(SVG 或透明 PNG)。絕不從零繪製 Logo 或以文字描述:若無檔案,則要求提供 |
| 動態風格 | 2 到 3 個形容詞(平靜、活力、高級、大眾)→ 定義 Easing 與剪輯點 |
| 數字 | 真實數字,包含小數點與字型。未確認的數字 → 我會要求提供,否則螢幕上會標示 「範例資料」 |
| 優惠、CTA、@/網站 | 來自簡報。僅在有實際截止日期時才加入急迫感 |
| 配樂 | 品牌授權檔案或圖庫音樂 + BPM 與 Drop 秒數 |
將素材包儲存為品牌資料夾中的 motion.md。從第二支影片開始,直接讀取,無須重建。
步驟 1 — 篩選:6 個元件
清單重印,每次只問一個問題,已填項目不再重開,且簡報已回答的項目直接預填。若缺少某個元件,我將自行決定,且通常與您的預期不同。
1. 格式 — 比例 + 解析度 + 長度 + fps
2. 場景 — 出現什麼、順序、每段秒數
3. 文字 — 確切句子,用引號標示(封閉清單,逐字精確)
4. 技術 — 依名稱(tecnicas.md)
5. 節奏與音效 — Easing、Stagger、BPM / 配樂
6. 交付 — MP4 · 6 秒短版 · 校對用播放器 · LP 循環 HTML · 透明背景
依平台的格式:
| 比例 | 解析度 | 適用平台 | 典型長度 |
|---|---|---|---|
| 9:16 | 1080×1920 | Reels、Stories、TikTok、Shorts | 8–15 秒,第 1 幀即鉤子 |
| 4:5 | 1080×1350 | IG/FB 動態 | 6–15 秒 |
| 1:1 | 1080×1080 | 動態、部分廣告版位 | 6–15 秒 |
| 16:9 | 1920×1080 | YouTube、簡報、大螢幕、網站 | 5 秒(片頭)至長篇解說 |
| LP | 頁面寬度(例如 1440) | 首屏與區塊 | 5–10 秒輕量循環,以 HTML 交付 |
30 fps 幾乎涵蓋所有情況。60 fps 僅用於縮放、快速粒子與攝影機運動。廣告影片:務必準備一個 6 秒版本,維持相同簽名,供 A/B 測試。
步驟 2 — 含時間軸的腳本(閘門)
在撰寫程式碼之前,先展示腳本並 等待核准:
格式:9:16 · 1080×1920 · 15 秒 · 30 fps · 配樂 120 BPM(剪輯點在 3 / 7 / 11 秒)
品牌包:背景 #050505 · 強調色 #E50914 · 數字色 #FFDD00 · Morganite / IBM Plex Sans · logo.svg
| 場景 | 時間 | 技術 | 發生什麼事 | 文字(逐字) | 入場 / 出場 |
腳本規則:
- 每個場景一個想法。 若場景需要兩句話,那就是兩個場景。
- 每個場景 2 到 4 秒。 少於 2 秒,文字來不及閱讀。
- 閱讀時間: 每 3 個字 1 秒 + 1 秒緩衝。單一數字:1.5 秒 · 3 個字:2 秒 · 6 個字:3 秒 · 9 個字:4 秒。需要超過 4 秒的句子對一個場景來說太長:應拆分或刪減字詞(刪減已核准的文案字詞是核准者的決定)。
- 說明如何入場與出場。 出場方式連接下一場景。
- 前 3 秒為鉤子(9:16 與 4:5)。主要訊息絕不放在結尾。
- 在拍點上剪輯: 拍點 = 60 ÷ BPM 秒;小節 = 4 拍。場景長度為小節的倍數時,剪輯最流暢(120 BPM:拍點 0.5 秒,小節 2 秒 · 128:0.47 / 1.88 · 100:0.6 / 2.4 · 90:0.67 / 2.67)。
步驟 3 — 建構
將 assets/template.html 複製到工作目錄,並填入 CFG、BRAND 與 SCENES。程式碼法則,因為它們決定了 MP4 是否與播放器中核准的內容一致:
- 一切都是
t的函數。 不使用setTimeout、Date.now()、CSS transition/animation 或幀之間的累積狀態。1.4 秒時的第 3 個字母永遠在同一個位置。 - 固定隨機種子(
rng(CFG.SEED + i))應用於所有隨機數值。沒有固定種子,匯出結果會與核准內容不同。 - 模擬(物理、Boids、布料):使用
t的解析公式,或載入時以固定步長(1/240 秒)預先計算,按幀儲存並以索引讀取。絕不在draw內部進行積分。 - 字型放在
CFG.FONTS,素材放在CFG.ASSETS:引擎會在第一幀之前等待載入完成。未載入的字型會無警告地回退為通用字型,這是最常見的錯誤。 - 9:16 的安全區域: 文字、數字與 Logo 應位於離頂部 250 px、離底部 350 px、離右側 120 px、離左側 60 px 的範圍內(近似值,依應用程式而異)。
- Easing 需有明確意圖:
inOut為預設;back(overshoot)用於文字、圖釘與數字的入場;linear僅用於連續旋轉與滾動;bounce僅用於落下的物體。字母間的 Stagger 為 0.07 秒,卡片間為 0.15 秒。 - 層級: 主要數字應是場景中最大的元素。
- 每個場景頂部附上時間與技術的註解。
長片或技術密集(Shader、模擬):一次製作一個場景。建構、校對並核准該場景後,再合併。短片(約 15 秒以內,4 個輕量場景)可一次完成,但校對仍需逐場景進行。
步驟 4 — 展示前校對
python ~/.claude/skills/motion/scripts/render.py peca.html --sheet auto --safe
產生包含每個場景中間與結尾幀的校對表,並繪製安全區域。使用 VER → 放大 → 確認 方法閱讀校對表(對小文字、數字與 Logo 進行放大裁剪),並通過 6 個層級:
| 層級 | 檢查項目 |
|---|---|
| 1. 技術 | 長度、解析度與 fps 符合要求;開頭與結尾無黑幀 |
| 2. 品牌 | Hex 顏色正確;品牌字型已載入,非通用字型;Logo 無變形、旋轉或顏色錯誤;動態風格相符 |
| 3. 可讀性 | 每個場景一個想法;每個文字停留時間符合規則;文字與背景對比度足夠;主要數字為最大元素 |
| 4. 平台 | 比例正確;無元素超出安全區域;前 3 秒為鉤子;無聲時仍可理解 |
| 5. 數據 | 數字與提供的一致,無四捨五入;包含小數點與字型;範例數據在螢幕上標示;無任何虛構數字 |
| 6. 版權 | 配樂已授權、為品牌自有或生成;照片與畫面已獲得授權;第三方品牌僅在許可下使用;優惠承諾已驗證 |
若要檢查特定時間點:--sheet 1.5,2.9,3.1。發現問題我會在展示前自行修正。
素材的第三次觀看,應在手機上、關閉音效進行,這是核准者的責任。 我檢查的是幀,而非影片播放時的整體感受。交付時,請明確要求核准者進行此步驟。
步驟 5 — 渲染與交付
python ~/.claude/skills/motion/scripts/render.py peca.html # 完整 MP4
python ~/.claude/skills/motion/scripts/render.py peca.html --segments 0-3,11-15 -o peca_6s.mp4 # 短版
python ~/.claude/skills/motion/scripts/render.py peca.html --audio trilha.mp3 # 含配樂
渲染後:使用 ffprobe 確認解析度、fps、幀數與長度。交付:
- MP4(H.264、yuv420p、+faststart),可直接上傳;
- 6 秒版本(若為廣告);
- 含播放器的 HTML(可在瀏覽器中開啟:播放、暫停、時間軸、場景名稱、安全區域)。核准者藉此指出需要調整的準確秒數。
LP:交付的是循環播放的 HTML 本身,而非 MP4。輕量優先:不得拖慢頁面。
配樂: 此技能可混入音檔(--audio),並將剪輯點對齊所指定的 BPM。以程式碼生成配樂尚未實作;若有人要求,請直接說明,而非臨時湊合。未經授權的第三方音樂會導致廣告被下架:絕不使用。
步驟 6 — 調整
第一版為草稿。好的調整應指出 場景或秒數、說明 調整幅度,並指定 保留部分:「在場景 1(0–3 秒),將 +248% 停留 1.5 秒後再切換。其餘部分不變。」我只修改受影響的部分並重新渲染。
| 症狀 | 可能原因 | 修正方式 |
|---|---|---|
| 動作機械化 | Easing 為 Linear | 使用 inOut,入場用 back |
| 所有元素同時進入 | 無 Stagger | 字母間 0.07 秒,卡片間 0.15 秒 |
| 字型與品牌不同 | 字型未載入 | 檢查 CFG.FONTS / @font-face 與資料夾中的檔案 |
| 文字在 9:16 中被裁切 | 佈局以 16:9 為設計 | 在 1080×1920 網格中重新製作,並遵守安全區域 |
| 播放器卡頓 | 粒子或 Shader 過多 | 播放器中減少元素,僅在渲染時使用完整數量 |
| 匯出結果與播放器不同 | 無固定種子的隨機或累積狀態 | 步驟 3 的法則 1 至 3 |
| 剪輯點不在拍子上 | 場景長度與 BPM 無關 | 將長度設為拍點的倍數 |
| 數字錯誤 | 數據未提供 | 嚴格使用提供的清單,不進行四捨五入 |
發佈後: 若留存率下降發生在前 3 秒,僅更換場景 1;若發生在中間某場景,縮短或僅更換該場景;若點擊率未提升,測試不同的結尾方式(彩花、旋轉印章、QR Code),其餘保持不變。一次只改變一個變數。
帳戶素材庫
影片核准後 → 在品牌的 motion.md 中記錄:已核准的腳本、使用的技術、HTML 路徑,以及(若有的話)前 7 天的數據。下一支影片將從已驗證效能的內容開始,且品牌的標準結尾(最終簽名含 Logo 與 CTA)將重複使用,無須重新製作。