Reels 範本
本技能內建十五個資料驅動的 Remotion 範本(1080x1920,60 fps),位於 assets/reels-kit/。一個影片即是一個 JSON 工作檔案:選擇範本、填入屬性、渲染。一般工作無需撰寫 React。
下列以 reels/ 開頭的路徑是指工作目錄,而非此技能目錄。切勿為了工作而編輯技能資料夾內的檔案。
可無人值守執行。 此技能專為自主代理程式設計。請求者 是發起工作的人:協調代理程式、管道或真人。根據此檔案中的規則做出所有決定,切勿為了請求步驟核准而停下。僅在遇到無法解決的障礙時(缺少工具、缺少或無法讀取的媒體、持續失敗的渲染)才停下並回報。每個工作皆以報告結尾(第 4 節)。
0. 設定工作區
每個專案僅需執行一次,於第一個工作開始之前。
- 檢查工具:Node.js 18 或更新版本(
node -v),以及ffmpeg和ffprobe是否在 PATH 中。若缺少任一項,則停下並回報為障礙。請勿自行安裝系統軟體。 - 若工作目錄中已有
reels/render.mjs,則使用該工作區並跳至第 1 節。 - 否則,將此技能的
assets/reels-kit/資料夾複製到工作目錄的reels/中(例如cp -R <skill-dir>/assets/reels-kit reels),然後在reels/內執行npm install。 - 建立資料夾
reels/public/(媒體)和reels/jobs/_local/(暫存工作)。若工作目錄是 git 儲存庫,則將reels/node_modules/、reels/public/、reels/out/、reels/exports/和reels/jobs/_local/加入其.gitignore檔案。
工作區包含 render.mjs(渲染工作)、clean.mjs(釋放磁碟空間,請參閱第 6 節)、src/(範本與共用套件)、jobs/examples/(每個範本各一個範例工作)、public/<name>/(每個工作的輸入媒體)、out/stills/(品質檢查靜態圖)和 exports/<name>/(每個工作的完成影片)。
偏好
此儲存庫不帶任何人的品味。文字樣式、字型、強調色、文案語氣、語言、音樂以及要優先使用的格式,皆來自請求者的簡報以及你對該品牌已知的資訊,絕非來自寫入範本或此檔案中的數值。當簡報中指定偏好時,請將其套用至工作檔案。若未指定,則使用範本預設值,並在報告中列出。請勿將個人或品牌的偏好寫入範本、範例工作或此技能中。
1. 選擇範本
當影片應感覺像是某人發布的內容時,請以社交原生範本為起點。當素材本身即為影片主體時,則使用廣告範本。
社交原生(觀看者熟悉的介面即為鉤子)
| 範本 | 使用時機 | 需要素材 |
|---|---|---|
ChatStory | 以文字訊息對話講述故事,然後揭露產品 | 訊息(+ 一張產品照片以傳送)、回饋片段 |
NotesList | 筆記應用列表自動打字:「送禮地雷 vs 她留下的那個」 | 標題 + 1 至 7 行、回饋片段 |
SearchHook | 顧客的問題輸入搜尋列,由素材回答 | 查詢(+ 建議)、1 個以上片段 |
NotificationStack | 鎖定螢幕充滿訂單、訊息、評論:社會證明與錯失恐懼症 | 1 至 6 則通知、背景、回饋片段 |
PolaroidDump | 剪貼簿照片牆搭配手寫標題 | 2 至 8 張照片 |
Ranking | 盲測排名:項目掉入編號列表,#1 最後 | 2 至 6 個片段、每個項目一個標籤與排名 |
PollSticker | 素材上的限時動態投票:兩個選項、點擊、結果 | 一個問題、兩個選項與百分比、片段 |
廣告格式(素材優先,文字疊加其上)
| 範本 | 使用時機 | 需要素材 |
|---|---|---|
BeatCutAd | 從素材剪輯產品廣告的預設選項:多個鏡頭、鉤子、CTA | 1 個以上影片片段 |
UgcCaptions | 有人對著攝影機說話;逐字字幕 | 1 個含語音 + 逐字時間戳記的片段 |
Listicle | 「三個理由為什麼」、祕訣、功能、步驟 | 2 至 7 個片段,每個對應一個要點 |
BeforeAfter | 轉變或對比(mode:wipe 或 split) | 2 個片段或照片 |
ProductSlideshow | 僅有產品照片存在,或快速型錄;可選價格標籤 | 2 張以上照片或片段 |
Testimonial | 社會證明:含星級的評論卡片 | 1 個背景片段 + 評論文字 |
CommentReply | 回答異議或常見問題;評論泡泡是鉤子 | 1 個以上片段 + 評論 |
OfferPromo | 促銷、折扣碼、截止日期 | 1 個以上片段 + 優惠 |
若簡報不適合任何範本,請參閱第 7 節。請勿將範本扭曲成它原本不是的樣子。
官方 Remotion 技能(remotion-best-practices,可使用 npx skills add remotion-dev/skills --skill remotion-best-practices 個別安裝)是撰寫 Remotion 程式碼的參考。若尚未安裝,請改用 Remotion 文件 https://www.remotion.dev/docs。對於在此儲存庫中製作影片,此技能在兩者有所差異時優先適用:建立工作檔案而非新專案或合成、檢查靜態圖而非開啟 Studio,以及在靜態圖通過後使用 render.mjs 進行渲染,無需等待指示。
2. 建立工作
- 選擇工作名稱(小寫、數字和
-,例如xmas-ornament)。它將作為工作檔案的name、輸入資料夾reels/public/<name>/和輸出資料夾reels/exports/<name>/。僅將此工作會用到的檔案複製到reels/public/<name>/中,並將原始檔案留在原位。在報告中註明每個輸入的來源,以及public/中的副本是否為唯一一份(下載或產生的檔案)。將每個src寫為<name>/<file>。對每個檔案執行ffprobe以取得其長度。媒體永不提交:public/已被 git 忽略,因此範例工作中的路徑(footage.mp4、music.m4a、demo/…)在你放入自己的檔案之前僅是佔位符。 - 在擺放文字前先查看素材:為每個鏡頭擷取一個影格(
ffmpeg -ss <t> -i <file> -frames:v 1),並注意產品所在位置。 - 讀取
reels/jobs/examples/<Template>.json。它列出了該範本接受的每個屬性。將其複製到reels/jobs/<job>.json並編輯。對於不應進入 git 的工作,請使用reels/jobs/_local/。
工作檔案:
{ "template": "BeatCutAd", "name": "xmas-ornament", "lang": "en",
"props": { },
"i18n": { "ja": { "hook": { "lines": ["…", "…"] }, "cta": { "lines": ["…"], "button": "…" } } } }
i18n.<lang> 會合併到 props 之上,因此它僅包含已翻譯的字串。物件陣列會逐項合併(null 則保留基礎項目);字串陣列則會取代。
每個範本共用的屬性:
hook:{ lines (1-3)、band、size、duration }。從 0 秒開始顯示,預設 2.2 秒。cta:{ lines、button、band、size、duration }。在最後duration秒顯示,預設 2.5。其他字幕在其開始時結束。music:{ src、volume }。結束時淡出。在語音下方使用約 0.15 的音量。brand:{ accent(十六進位)、font:poppins | montserrat | anton、textStyle:outline | box | caption }。outline(預設)和box是華麗的廣告風格。caption是原生應用程式字幕外觀:白色句子大小寫文字,位於一個深色圓角矩形內,在其帶狀區域頂部淡入;將其寫成第一人稱故事行,最多兩行,每行最多 30 個字元。- 一個片段:
{ src、start(進入來源的秒數)、duration(在畫面上的秒數)、speed、focus(center | top | bottom | "50% 30%")、transition(cut | flash | zoom | whip | focus) }。transition定義該片段如何進入。
片段也接受模擬攝影機:zoom(1-2.5,推進同時保持 focus 點的位置)、tilt(度數,-15 到 15,荷蘭角度)和 push(0-0.6,攝影機在片段進入時伴隨短暫模糊向前猛衝,然後穩定)。
工作檔案中省略的屬性即為關閉:沒有 hook 的工作就沒有鉤子,無論範例顯示為何。
src 是 public/ 內的路徑或 https URL。.jpg/.png/.webp 檔案會獲得緩慢推進效果,而非直接播放。
3. 規則
- 安全區域。 所有文字應位於 x 140-940、y 288-1248 範圍內。範本透過三個帶狀區域強制執行此規則:
top(y 288-600)、middle(600-930)、lower(930-1248)。你只需選擇帶狀區域。 - 讓文字避開產品,除非簡報希望文字放在產品上。根據你擷取的影格選擇每個帶狀區域。若在一個鏡頭中,每個帶狀區域都覆蓋了產品,則縮短文字的
duration或更換鏡頭。 - 簡短行。 文字會縮小以適合 800 像素,因此長行會變小。目標為每行 22 個拉丁字元或 12 個日文字元。用
*星號*包圍一個單詞,以使用強調色為其著色。 - 片段長度。
start + duration * speed不得超過來源的結尾。影片的總長度為所有片段持續時間的總和(BeforeAfter使用duration;Testimonial為評論加上 CTA 的長度)。 - 配合節拍剪輯 當有音樂時:讓片段持續時間加總起來符合節拍位置。
- 字型。 支援拉丁文、越南文(montserrat 或 anton,以及所有介面卡片)和日文。韓文、泰文、阿拉伯文和其他語言需要先在
reels/src/lib/kit.tsx中新增字型。
少量靜態片段,多種角度。 當素材是一兩個固定鏡頭,而簡報要求快速多角度剪輯(展示間導覽或趨勢舞蹈剪輯)時,請使用 BeatCutAd,並以不同的 focus、zoom、tilt 和 push 多次重複使用每個來源:以廣角鏡頭開場(zoom 約 1.02),然後每個節拍一個細節(文字、角色、姓名、手部、下擺),交替更改 tilt 的正負號,在 768 像素來源上將 zoom 保持在 1.7 或以下,最後以廣角結束。使用 cut 過場;push 即是過場效果。這會重新構圖素材;但無法創造真正的全新攝影角度。
範本備註:
ChatStory、NotesList、NotificationStack:介面先播放,然後clips(回饋片段)閃入,CTA 在它們上方顯示。其長度為介面部分加上片段的長度。省略hook:卡片填滿安全區域。background是卡片後方變暗的媒體。ChatStory:訊息根據閱讀時間自行調整節奏;僅在需要強制配合節拍時設定at(秒)。訊息可以攜帶image(產品照片)代替text,或與text共存。NotesList:check:true會在一行打出來後打勾,highlight:true則標記該行。將產品行放在最後。SearchHook:pick是被選取的建議。將查詢保持在 34 個字元以內。NotificationStack:icon是一個表情符號,color是其磚塊顏色。根據語言翻譯now和date。PolaroidDump:接近正方形的照片效果最佳。title是手寫體;說明文字保持在 20 個字元以內。沒有片段:照片本身就是影片。Ranking:items按照寫入的順序播放,因此請先寫最低排名,排名 1 最後。標籤保持在 20 個字元以內。PollSticker:percent值由你設定;當簡報中有真實數字時請使用真實數字,切勿將發明的數字呈現為調查數據。- 在這些介面中撰寫文案時,請模仿人們發簡訊和發文的方式:可以使用小寫、短行,以及在一般人會使用表情符號的地方使用表情符號。其中的姓名、訊息和評論僅為說明用途,除非簡報提供了真實內容,因此請勿將其歸因於真實人物。
UgcCaptions:words是{ text、start、end },以輸出時間軸上的秒為單位。從帶有逐字時間戳記的逐字稿中獲取;請勿猜測時間點。keepAudio預設為 true。一個「單詞」可以是短語,搭配wordsPerPage:1。CommentReply和OfferPromo:省略hook。泡泡或標題已經使用了頂部帶狀區域。OfferPromo:CTA 預設位於下方帶狀區域。Testimonial:將 CTA 帶狀區域設定為middle。ProductSlideshow:badge接受\n以分為兩行;使用badgeBand放置。
4. 檢查,然後渲染
從 reels/ 執行這些指令。
node render.mjs jobs/<job>.json --still=1,6,12 --guides # 安全區域帶狀線條繪製在頂部
node render.mjs jobs/<job>.json --still=1,6,12 --lang=en,ja
node render.mjs jobs/<job>.json # 所有語言 -> exports/<name>/
靜態圖會以半尺寸輸出到 out/stills/。開啟並檢查:文字避開產品、無內容被裁剪、每種語言都符合。在鉤子、中間字幕和 CTA 中選擇靜態圖的時間點。檔案名包含 _GUIDES 的僅供檢查用;切勿將其作為結果交付。
僅在靜態圖通過後才渲染影片。如果靜態圖失敗,修正工作並再次檢查;經過三輪失敗後,將其回報為障礙。渲染時會為每個檔案輸出一行,包含其路徑和長度。除非簡報要求,否則請勿發布或上傳影片。
每個工作結束時,向請求者提供一份報告。報告應涵蓋:
- 輸出路徑和長度;
- 所使用的範本,以及簡報未提及時所使用的預設值;
- 每個輸入的來源,以及
public/中是否為唯一副本; - 第 6 節中的清理作業移除了哪些內容,以及釋放的空間量。
5. Instagram 尺寸
渲染出的影片約為 16 Mbps。若要壓縮以利上傳:
ffmpeg -i in.mp4 -c:v libx264 -crf 20 -maxrate 10M -bufsize 20M -c:a aac -ar 48000 -b:a 192k -movflags +faststart out.mp4
6. 媒體與磁碟空間
媒體是佔用磁碟空間的主要元兇。輸入(素材、照片、音樂複製到 public/<name>/)和輸出(exports/<name>/ 中的影片,15 秒約 30 MB per 語言)都屬於同一個工作,使用相同名稱。請保持此結構,因為清理作業是按工作進行的。其他所有項目均為暫存:out/ 中的品質檢查靜態圖,以及 Remotion 寫入作業系統暫存資料夾的臨時套件(每個套件都包含 public/ 的完整副本;render.mjs 會刪除自己的暫存,但崩潰的執行和 Studio 會留下一些)。node_modules/.cache 中的 webpack 快取會增長到數百 MB。node_modules/(約 1.3 GB,包含無頭瀏覽器)是一次性成本。重新渲染工作會以相同名稱覆寫其檔案,因此重複渲染一個工作不會堆積。
如果缺少 reels/clean.mjs(工作區是從較舊的套件建立的),請先將此技能 assets/reels-kit/ 中的 clean.mjs 和 render.mjs 複製到 reels/。
從 reels/ 執行這些指令,且切勿在渲染進行中執行:
node clean.mjs --auto --keep=<…>
[因原始內容截斷而截斷]