Remotion Shorts 技能 是做什麼的?
你將短影音編寫為一個場景 JSON 檔案。捆綁的 Remotion 專案會負責文字排版、根據閱讀速度設定每個場景的時間、將文字保持在無應用程式按鈕遮蓋的安全區域內,並渲染出檢查圖、封面圖和 MP4 影片,使用者可以透過 WoopSocial 發佈。
你不需要為每支影片撰寫 Remotion 程式碼。範本已固定且經過測試;你的工作是腳本:每個畫面要說什麼、順序為何、以及節奏快慢。
0. 環境設定(每台機器一次)
需要 Node 20 或更新版本。使用 node -v 檢查;如果缺少,請引導使用者前往 https://nodejs.org。Remotion 支援 macOS 15 或更新版本、Windows x64 以及使用 glibc 2.35+(Ubuntu 22.04、Debian 12 或更新版本)的 Linux。
node <skill-dir>/scripts/setup.mjs remotion-shorts
這會將專案複製到 ./remotion-shorts 目錄,安裝固定的套件(約 260 MB)並下載 Remotion 渲染所需的無頭瀏覽器(100 到 150 MB)。第一次執行需要 1 到 3 分鐘。當技能更新後重新執行:它會重新整理範本檔案(使用者已修改的檔案會保留為 .bak),且絕不會影響使用者的腳本、素材或輸出檔案。
授權。 Remotion 對個人及不超過 3 人的公司免費。4 人(含)以上的公司需要 Remotion 公司授權,且從腳本渲染視為自動化(remotion.pro/license)。如果使用者是為較大的公司渲染,請在第一次渲染前明確告知一次。
1. 詢問需求(一次訊息,跳過已知項目)
- 素材。 一個主題、文章、網址、筆記、資料、更新日誌或清單。你只能撰寫你可以指出來源的事實。如果使用者給出主題但沒有來源,請找到主要來源(官方統計資料、文件、產品自身的更新日誌)並指出名稱。
- 目標觀眾與單一重點。 一支短影音只說一件事。
- 視覺風格。 一個主題(
ink,paper,volt,ocean,clean)或他們的品牌色彩,以及結尾畫面的使用者名稱。 - 音訊。 內建音效預設為開啟(鉤子出現時有重擊聲、每次轉場有嗖嗖聲、重點處有彈出聲、倒數時有噠噠聲);這些音效是為此範本設計的,在所有應用程式中都是安全的。音樂僅來自他們擁有使用權的檔案(請參閱
references/writing-shorts.md了解為何在三個平台上沒有任何免費音樂庫是安全的)。 - 發佈平台。 TikTok、Reels、Shorts,或全部三個。
2. 編寫腳本
在首次撰寫腳本之前,請先閱讀 references/writing-shorts.md。簡要版本:
- 場景 1 是鉤子,用約 10 個字或更少來陳述影片的賣點:一個數字、一個主張或一個列表承諾(「5 個免費工具取代...」)。它從第 0 幀開始就完整顯示在畫面上。如果鉤子包含數字,請將其放在
big欄位中,使其成為視線最先落點。 - 一個場景一個想法。 一個場景是一個節拍,而非一個段落。統計場景攜帶一個數字及其意義。列表項目遞減或遞增;在鉤子中說明是哪一種。
- 每個場景都有真實資訊。 一個除了模板文字外沒有任何新內容的短影音,被 YouTube 稱為虛假內容,被 Instagram 稱為非原創內容。絕對不要灌水。
- 數字必須精確且有來源。 將來源放在
footer欄位(「資料來源:USGS」)。絕不要將數字四捨五入成不同的主張。 - 以一個行動或一句話結尾,讓結尾能回到鉤子,使循環感覺連續。不要說「謝謝觀看」。
- 長度: 目標為 15 到 45 秒;超過 59 秒時渲染器會發出警告。
在專案資料夾中撰寫 short.json。完整的格式、每種場景類型和所有選項都在 references/short-json.md 中。一個最簡腳本範例:
{
"theme": "ink",
"footer": "資料來源:USGS",
"handle": "@yourhandle",
"scenes": [
{ "type": "hook", "big": "2.5%", "text": "的地球水資源是淡水" },
{ "type": "stat", "value": "96.5", "suffix": "%", "label": "是存在海洋中的鹽水" },
{ "type": "stat", "value": "68.7", "suffix": "%", "label": "的淡水是冰河與冰川", "highlight": "冰河與冰川" },
{ "type": "end", "text": "收藏起來,下次聚會秀一手", "highlight": "收藏起來" }
]
}
3. 渲染前檢查
cd remotion-shorts
node render.mjs short.json --stills
幾秒鐘內,此指令會印出計畫(每個場景的秒數和字體大小)並寫入:
out/short/sheet.jpg:每個場景的最後一幀(畫面上的所有內容),安全區域以細虛線標示(文字必須保持在此區域內)。out/short/cuts.jpg:第 0 幀以及每個剪輯點前後幀,用於檢查動態。out/short/cover.jpg:已完整顯示的鉤子(可作為 Reels 的封面圖上傳)。out/short/report.json:時間、換行和警告。
打開這兩張檢查圖並仔細查看。 檢查:每個場景在手機尺寸下是否清晰可讀、每個場景是否只表達一件事、重點強調是否在關鍵字詞上、是否有任何看起來擁擠的地方、順序是否正確、以及第 0 幀是否顯示了完整的鉤子。修正 JSON 並再次執行 --stills,直到你認為可以發佈為止。
警告會停止影片渲染(退出碼 2):文字過長無法一頁顯示、鉤子太長、重點強調不在文字中、場景速度太快無法閱讀、節奏超出 0.85 到 1.25 的範圍、或短影音超過 59 秒。修正腳本;僅在使用者已看到警告並仍想繼續時才使用 --force。某些問題是 --force 無法覆蓋的錯誤,例如在任何尺寸下文字都超出螢幕寬度:這會導致文字顯示在畫面外。
4. 渲染
node render.mjs short.json
寫入 out/short/short.mp4:1080x1920、30 fps、H.264、yuv420p、AAC(無音樂時為無聲音軌),TikTok、Reels 和 Shorts 皆可接受。一支 30 秒的短影音在近期筆電上約需一分鐘渲染完成。記憶體為 8 GB 的機器一次渲染 2 幀;如果渲染仍因記憶體不足而終止,請加上 --concurrency 1 重新執行。
在展示影片前,抓取三幀畫面(開頭、中間、結尾)並檢查,或者如果你的客戶端支援則直接播放。然後向使用者展示封面圖、檢查表和 MP4 檔案路徑。
多個帳號: 絕不要將相同的檔案發佈到多個帳號。為每個帳號製作一個變體(不同的鉤子、主題或場景順序,儲存為各自的 JSON 檔案),確保沒有兩個帳號發佈近乎相同的內容。
5. 發佈(WoopSocial,需確認)
閱讀 references/woopsocial.md。簡而言之:
- 使用
social_accounts_list尋找帳號(如果需要,先進行連線)。 - 對於 TikTok,使用
social_accounts_get_platform_inputs獲取帳號資訊:隱私設定選項及其允許的最長影片長度。使用者自行選擇隱私設定,沒有預設值。 - 上傳:使用
media_uploads_create_session並提供來自report.json的精確位元組大小,將回應儲存為session.json,執行node upload.mjs session.json out/short/short.mp4,然後持續呼叫media_uploads_complete_session直到狀態變為READY。 - 根據平台撰寫說明文字(TikTok 和 Reels:一行能補充影片內容的文字,加上 3 到 5 個具體的 Hashtag;YouTube:一個少於 100 個字元的標題加上一段描述)。使用
contentOverride來設定不同平台的文字。 - 使用
posts_validate驗證,然後向使用者展示:帳號、各平台說明文字、隱私設定、排程時間(含時區)、封面圖。等待使用者明確同意。然後執行posts_create和posts_get。
揭露欄位:當短影音推廣使用者自己的產品時,TikTok 上設定 isYourBrand: true;僅在涉及逼真的 AI 影像、影片或語音時設定 isAiGeneratedContent(動態文字不需要)。YouTube 的 madeForKids 是法律聲明:必須詢問,絕不猜測。
6. 回報結果
展示:MP4 檔案路徑、長度、檢查表、發佈位置(從 posts_get 取得的連結)或排程時間,以及任何你無法完成的事項。絕不捏造觀看次數或結果;稍後使用 social_account_posts_list 讀取它們,並回報資料收集的日期。
編輯視覺風格
- 品牌色彩:將
theme設定為一個物件(bg、fg、accent、accentText、font、uppercase)。保持文字對比度至少 7:1;也檢查強調色在背景上的對比度。 - 場景後的照片或影片:每個場景使用
image或整個短影音使用background。它們會在主色調下變暗,使文字保持可讀。使用使用者擁有或已取得授權的檔案,並在授權要求時於說明文字中標示來源。 - 內建字型:Anton(緊湊、大寫、醒目)、Poppins、Inter。皆為 OFL 授權。
- 要變更範本本身,請編輯
src/Short.tsx並使用npm run studio預覽。
邊緣情況
- 數字沒有來源: 不要使用。說明缺少什麼。
- 文字無法容納: 拆分場景;不要將字體縮小到低於最小值(渲染器不會允許)。
- 從右到左書寫的文字、CJK 文字或表情符號: 內建字型不支援它們,可能會顯示為空白方塊。請說明情況並將其排除(表情符號可以放在說明文字中)。
- 使用者想要熱門音效: API 發佈無法添加。將 TikTok 的
postMode設為MEDIA_UPLOAD以讓影片進入他們的 TikTok 收件匣,以便在應用程式內完成後續操作。 - 在 Linux 上渲染失敗,缺少函式庫:安裝
references/platform-specs.md中列出的套件。 - Windows: 始終在 JSON 檔案中傳遞屬性,切勿在命令列內嵌。
品質標準
在宣佈完成之前,應通過所有以下檢查:
- 第 0 幀顯示了完整的鉤子(檢查 cuts.jpg);約 10 個字或更少,陳述賣點。
- 每個場景只說一件事;每個場景不超過約 14 個字。
- 每個數字都與其來源相符;來源顯示在畫面上或說明文字中。
- 沒有警告,或者使用者已看到警告並選擇了
--force。 - 已檢查兩張檢查圖:沒有文字超出虛線安全線,重點強調在正確的關鍵字詞上。
- 時間長度在 15 到 59 秒之間。
- 為每個帳號準備了不同的版本。
- 使用者已在任何內容發佈前確認。