Video Creator
將影片撰寫成一個單一的HTML頁面,其中包含一個函數 render(t),該函數僅根據時間來設定每個元素的狀態:不使用CSS過渡、計時器或先前幀的記憶。Playwright腳本會移動到每個幀的時間點、截圖,然後由ffmpeg將這些幀編碼成影片。由於每個幀都是 t 的純函數,你可以跳到任何時刻、平行渲染,並且每次都能獲得相同的輸出。
你擁有很大的創作空間。這項技能提供給你一個技巧、一些從艱苦經驗中學到的教訓,以及Danny的預設偏好。它不是一個模板。最好的影片來自於一個針對特定主題的強烈想法。
參考實作:website/video/ 位於 https://github.com/dannysmith/astro-editor (README涵蓋了頁面、渲染器、合成音訊和發布)。請為了技巧而閱讀,而不是為了外觀:它的黑暗電影風格適合該產品,但不適合每個產品。
頁面
window.DURATION = 45 // 秒
window.__ready = Promise.all([document.fonts.ready, ...[...document.images].map((i) => i.decode())])
window.render = (t) => { /* 根據 t 設定每個元素 */ }
使用三個輔助函數來構建大部分動畫:一個時間窗口內的0-1進度、緩動曲線和 lerp。為攝影機移動添加關鍵幀列表,並為文字添加一個帶種子的打字輔助函數。支援 ?t=12(凍結在一個時刻)和 ?play(以正常速度循環播放,由 requestAnimationFrame 驅動),這樣Danny就可以在瀏覽器中打開頁面進行檢查。如果兩者都沒有,頁面在調用 render(t) 之前應該什麼都不做,因為渲染器就是這樣載入它的。在渲染第0幀之前解析 __ready,否則早期幀可能會使用後備字體或顯示缺失的圖片。
工作流程
-
研究。弄清楚你必須依據的內容:
- 一個有網站或品牌的專案:提取真實的顏色、字體、螢幕截圖、文案和樣式表,並根據文件檢查產品宣稱。
- 一個品牌很少或沒有UI的專案:從README和文件中獲取實質內容,外觀則來自「House Style」。
- 僅有提示(一個概念、一篇文章、一個虛構產品):提示及其附件是來源。使用「House Style」。對於虛構的東西可以自由發揮,但要保持一致。
如果有重要東西缺失,請詢問。
-
提案。在開始構建之前,給Danny一個簡短的概念來確認:中心思想以及推動場景轉換的元素、按順序的節拍、大概長度、外觀和音訊方法。如果有足夠的背景資訊,提出一個概念。如果資訊很少,則提出兩到三個對比方向,每個用幾行描述。
-
計劃。為你自己寫一個帶時間的故事板(場景、開始、結束、螢幕上顯示的內容)。
-
構建。在當前專案的
video/目錄中工作(除非被要求,否則不要提交),或者如果當前目錄為空,則在當前目錄中工作。為專案編寫一個渲染腳本:複製此技能中的assets/render.mjs作為起點,並根據影片需要進行更改。在需要動畫時用HTML重建UI,對於靜態或蒙太奇時刻使用真實螢幕截圖,對於形狀和插圖使用SVG。 -
審查。渲染聯繫表和靜止幀,修正,重複,在完整渲染之前至少進行兩次(參見「工藝」)。
-
交付。最終的MP4、一個聯繫表以便Danny可以一覽整個影片、如何重新渲染它,以及如果你使用了任何第三方素材的
LICENSES.txt。從編碼後的檔案中抽查一些幀。
除非另有說明:16:9 比例,1920×1080,60fps,長度適合內容(宣傳片約30-60秒),並且在靜音情況下也必須有意義。
工藝
- 找到一個主幹。一個貫穿所有剪輯的裝置:一個視窗、一個形狀、一個游標、一條攝影機路徑、一個攝影機移動的單一世界。沒有的話,影片就會變成帶有淡入淡出效果的動畫幻燈片。偏好匹配剪輯和一個事物轉變為另一個事物,而不是交叉淡入淡出。
- 掌握節奏。節拍大約1.5-4秒。變化它們:最慢的場景應該大約是最快場景的三倍長。至少包含一個暫停的節拍,其中沒有任何移動,並且一句台詞得以沈澱。退場比進場更快。在最初幾秒鐘內說清楚這是什麼。
- 給人們閱讀的時間。文字出現後,至少停留0.6秒加上每個單詞0.3秒。如果一行字在兩秒內讀不完,就刪減單詞。
- 為影片而非網頁設計尺寸。在1080p下,標題至少90px,正文至少32px。1px的線條和低於10%的不透明度在編碼後會消失。全螢幕線性漸層會產生條帶,因此使用純色或徑向填充。
- 避開懶惰的預設:所有東西使用相同的緩動和持續時間,每個進場都是滑入並淡入,每個場景使用相同的交錯,每個剪輯都使用交叉淡入淡出,漸層文字,黑色背景上的紫色或青色光暈,所有東西都置中。
- 使用真實素材。使用來源的真實顏色、文案和UI。檢查出現在螢幕上的每個數字和宣稱。
- 像編輯一樣審查。
- 一張大約每秒一幀的聯繫表可以顯示節奏和構圖。
- 靜止幀會隱藏動畫,因此跨每個過渡平舖間距很近的幀來檢查緩動(在範例渲染器中使用
--sheet 0.05 --from 12 --to 12.6)。 - 使用
getBoundingClientRect()在程式碼中檢查文字溢出和碰撞,而不僅僅是目測。
陷阱
- 幀之間沒有狀態。平行渲染工作器會從影片中途開始,因此任何從較早幀快取的東西都會遺失。從
t推導所有東西,或在每個幀從頁面測量它。 - 保持字體為本地。將網路字體檔案下載到專案中;在渲染時從網路載入是不可靠的。安裝在Mac上的授權字體(如Operator Mono)使用
local()載入。切勿將它們的檔案複製到儲存庫中。 - 為任何隨機性設定種子(打字節奏、抖動、模糊形狀),以便渲染結果完全相同。
- 測量,不要猜測。從
getBoundingClientRect()獲取依賴於佈局的位置(連接線、放置目標、游標路徑)。當在圖片上疊加註釋時,記得加上圖片本身的偏移量。 - 不要播放
<video>元素。使用ffmpeg提取它們的幀,並為t顯示正確的幀。 - Chromium不會在Claude Code沙箱內啟動。在沙箱外部執行渲染。
- 你無法聽到音訊。請這麼說。數值檢查音量並查看波形(參見
references/audio.md)。 - 網路交付:使用
-crf 27 -preset veryslow -tune animation -pix_fmt yuv420p -movflags +faststart的H.264,以及使用loudnorm=I=-16正規化的AAC音訊。
風格指南
專案和提示未明確說明的任何東西的預設值。專案自身的品牌在外觀上優先,而Danny的指示勝過一切。如果他要求不同的風格,或說忽略預設值,請完全丟棄它們:不要出於習慣而沿用調色板、模糊形狀或字體。除非他另有說明,否則語氣、動畫和音訊的預設值仍適用於品牌影片。
顏色
Danny的調色板,基於Notion的顏色:一個品牌灰色 #2f3437 畫布,#191919 用於背景框和較暗的面板,白色文字,以及珊瑚色 #ff7369 用於關鍵詞。柔和400色和飽和500色用於形狀。references/colours.md 有完整的調色板,說明了每種色調的用途,以及danny.is和Flexoki調色板及其使用時機。每個影片使用一個調色板。
字體
預設使用Geist,標題使用粗體。還有:
- Figtree:更友好的無襯線字體。
- Literata:用於引言和評論文章的襯線字體。
- Caveat:用於旁白的手寫字體。謹慎使用。
- Operator Mono:用於程式碼和終端機。它是本地安裝的,所以使用
local('Operator Mono'),並以Fira Code作為後備。 - 系統字體(SF Pro):用於Mac應用專案,以匹配原生UI。
- Inter:用於匹配Danny較舊的Figma簡報。
除了Operator Mono和SF Pro之外,所有字體都在Google Fonts上。
排版
大而粗:標題使用800-900的字重,緊湊的行距和略微負的字距。短標題使用全大寫,陳述句使用句子大小寫。用顏色強調,而不是斜體。左對齊和不對稱多於置中。
語氣
- UK英文。
- 溫暖、樸實、略帶調侃,就像向一個聰明的朋友解釋某事,而不是向陌生人推銷。
- 具體:「Your schemas become forms」,而不是「Supercharge your workflow」。
- 每行一個想法。
- 永遠不要宣稱超過事物本身的能力。
- 歡迎使用表情符號。
- 沒有行銷陳腔濫調(「introducing」、「revolutionise」、「seamless」、「unlock」、「game-changer」)。
Astro Editor和Taskdn的首頁展示了這種語氣。對於旁白或任何比標題更長的內容,請參考 writing:guide。
美學
從專案自身的首頁開始。如果沒有,借用Danny自己簡報和社交圖片(在 references/examples/ 中的螢幕截圖;在設計之前先看看它們)的風格。吸取元素,而不是佈局:
- 一個鑲嵌在較暗框架中的木炭色畫布。
- 帶有珊瑚色高光的大膽白色大號文字。
- 珊瑚色和柔和色調的有機模糊形狀從角落溢出。
- 一條鬆散的手繪波浪線或箭頭。
- 作為插圖的大型表情符號。
- 調色板中的平面向量圖畫。
- 偶爾的全出血彩色卡片。
- 用於程式碼的macOS視窗邊框。
- 充足的空間。
它應該感覺友好、有點俏皮,並且明顯是由一個人製作的。
圖片
偏好你自己繪製的SVG(帶種子的模糊形狀、平面插圖、圖表),而不是照片。只有在照片能增加價值時才使用,來源可以是Unsplash或Pexels。圖示來自Lucide或Phosphor。Apple表情符號原生渲染,適合個人影片;對於商業產品行銷,請使用Fluent Emoji(MIT許可)。
動畫
- 流暢,而不是炫技:沒有旋轉、3D翻轉、縮放模糊、鏡頭光暈或粒子爆發。
- 動畫應該引導注意力,一次一個焦點動作。
- 打字過程應該感覺人性化:不均勻的節奏、在標點符號處暫停、打字時游標是實心的,閒置時閃爍。
- 添加一些背景生命力:漂浮的模糊形狀、上下浮動的表情符號、彈出的勾選標記。
- 目標是創造一個能讓人微笑的時刻。
- 以一個持續的結尾卡片結束。
音訊
每個影片選擇一種音訊方法,並在提案中說明理由:
- 一個找到的曲目,配合影片剪輯。為Danny列出兩到三個備選,因為你無法聽到它們。
- 與螢幕事件鎖定的合成聲音。使用取樣樂器,而不是單純的振盪器。
- 兩者的混合。
- 靜音,用於短片段或任何會自動靜音播放的內容。
保持音效細微:每個有意義的事件一個。references/audio.md 包含了來源、許可證、ffmpeg配方以及檢查你無法聽到的音訊的方法。