HyperFrames 製作流程
實作已核准的分鏡腳本。如果沒有分鏡腳本,請停止並執行 motion-storyboard。
選擇渲染器
| 情況 | 渲染器 |
|---|---|
| 新工作的預設選項;具備 HTML/CSS/GSAP 技能;需要註冊表區塊 | HyperFrames (npx hyperframes …) |
| 專案已使用 Remotion | 繼續使用 Remotion;相同確定性規則適用 |
產品儲存庫已有自己的工作室(seek(t) + Playwright + FFmpeg) | 使用該工作室;請勿引入第二個 |
| 純粹編輯現有素材 | 跳過此技能 → video-edit-qc |
安裝 HyperFrames CLI 或新增註冊表區塊 (npx hyperframes add …) 會安裝第三方
程式碼:請先與使用者確認,並在 package.json 中鎖定版本。請勿自行執行技能的自動更新
命令(npx hyperframes skills update, npx skills add …)。
合成合約(HyperFrames)
- 獨立根元素:直接在
<body>中使用<div data-composition-id="main" data-width="1920" data-height="1080" data-duration="24">,並設定width/height: 100%— 切勿在根元素上硬編碼像素尺寸。子合成(透過data-composition-src載入)將其根元素包裹在<template>中,並將<style>/<script>保留在內部。 - 每個合成一個暫停時間軸:
window.__timelines["<composition-id>"] = gsap.timeline({ paused: true }),在建置完成後註冊(可能需要在document.fonts.ready內部建置)。渲染長度來自根元素的data-duration。 - 定時片段:帶有
class="clip"及data-start/data-duration的元素會在執行時被顯示和隱藏。切勿在.clip上使用 GSAP 補間display、visibility或autoAlpha;請對子元素進行動畫處理。 - 變形:切勿在同一個屬性上混用 CSS 初始
transform與 GSAP 補間;請使用gsap.fromTo。使用 flex/inset 置中,避免在同時移動的節點上使用translate(-50%,-50%)。 - 媒體:每個
<audio>都必須有id(否則渲染將靜音);媒體上不可有crossorigin;不要在<video>和其父元素上同時放置data-start。 - 字型:每個命名的
font-family都必須有內聯的@font-face,指向已提供的本地檔案。 - 確定性:禁止讀取 wall-clock、未設定種子的
Math.random、渲染時的網路請求、輸入狀態或無限重複(repeat: -1)。需要隨機性時,請使用已設定種子的 PRNG。 - ID:在整個組合頁面中必須唯一;子合成的 ID 請加上合成 ID 作為前綴。
建置順序
- 執行
npx hyperframes init(需先確認)或開啟現有專案。 - 撰寫設計規格(
frame.md/design.md):包含文字標記、字型級別、網格、安全區域、各長寬比設定。先製作靜止畫面 — 每個節拍都必須能獨立作為靜態圖片使用。 - 按照分鏡順序逐場景建置;根據過渡對應表(
motion-choreography)實現接縫,先處理承載元素。 - 從
voice-video-sync放置音訊:背景音樂、配音、音效,並附上從時間軸檔案取得的 ID 與開始時間 — 切勿手動猜測。 - 保持文字清晰:移動容器,而非字形;文字上不要使用
will-change。
驗證
請依此順序執行,並在修正後再進行下一步:
npx hyperframes lint # 合約錯誤;lint 錯誤會停用版面/對比度稽核
npx hyperframes check # 版面、溢出、對比度
npx hyperframes snapshot # 供審閱的靜態畫面;與分鏡腳本的節拍比對
npx hyperframes preview # 為使用者提供本地預覽
然後在本地渲染:npx hyperframes render --quality <draft|high>。先以草稿模式(≤30 秒視窗或低品質)供使用者核准,再進行最終渲染。
對外命令 — publish、cloud、lambda、cloudrun、feedback、auth 及
遙測設定 — 會上傳資料或變更帳號。僅在使用者要求時才執行。
自訂 seek(t) 管線(不使用 HyperFrames 時)
composition(t) → Playwright page.evaluate(seek, t) → 等待字型/圖片 → 截圖
→ 每輸出影格 N 個子影格 → ffmpeg tmix(動態模糊) → x264/x265 → 混流音訊
- 60 fps × 4 子影格,快門 0.5,是良好的預設值;若影響可讀性,可在數字變化的影格上關閉模糊。
- 主編碼(供封存和重新編輯的來源):
-c:v libx264 -pix_fmt yuv420p -crf 16 -preset slow, AAC 320 kbps。平台傳送編碼會從此主編碼在video-edit-qc中衍生。 - 相同時間點渲染兩次必須產生完全相同的像素;請在 3 個隨機影格上測試。
交接
將渲染結果及靜態畫面/聯絡表交付給 video-edit-qc。當 HyperFrames 技能已安裝時(hyperframes-core、hyperframes-animation、hyperframes-creative、hyperframes-cli),使用它們來取得確切旗標、適配器(Lottie、Three.js 等)及註冊表區塊名稱。