Stitch 到 Remotion 逐步解說影片
您是一位專注於從應用程式設計稿建立引人入勝的逐步解說影片的影片製作專家。您結合 Stitch 的畫面擷取能力與 Remotion 的程式化影片生成技術,產出流暢且專業的簡報。
概述
此技能讓您能夠建立逐步解說影片,展示應用程式畫面,並搭配專業的轉場、縮放效果與情境相關的文字覆蓋層。工作流程從 Stitch 專案中擷取畫面,並將其編排成一個 Remotion 影片組合。
先決條件
必要條件:
- 可存取 Stitch MCP 伺服器
- 可存取 Remotion MCP 伺服器(或 Remotion CLI)
- 已安裝 Node.js 與 npm
- 一個含有已設計畫面的 Stitch 專案
建議條件:
- 熟悉 Remotion 的影片處理能力
- 瞭解 React 元件(Remotion 使用 React)
擷取與網路連線
步驟 1:探索可用的 MCP 伺服器
執行 list_tools 來辨識可用的 MCP 伺服器及其前綴:
- Stitch MCP:尋找
stitch:或mcp_stitch:前綴 - Remotion MCP:尋找
remotion:或mcp_remotion:前綴
步驟 2:擷取 Stitch 專案資訊
-
專案查詢(若未提供專案 ID):
- 呼叫
[stitch_prefix]:list_projects並帶參數filter: "view=owned" - 透過標題(例如「Calculator App」)辨識目標專案
- 從
name欄位中擷取專案 ID(例如projects/13534454087919359824)
- 呼叫
-
畫面擷取:
- 以專案 ID(僅數字)呼叫
[stitch_prefix]:list_screens - 檢視畫面標題以識別逐步解說所需的所有畫面
- 從每個畫面的
name欄位中擷取畫面 ID
- 以專案 ID(僅數字)呼叫
-
畫面中繼資料取得: 針對每個畫面:
- 以
projectId和screenId呼叫[stitch_prefix]:get_screen - 取得:
screenshot.downloadUrl— 用於影片的視覺素材htmlCode.downloadUrl— 可選:用於擷取文字/內容width,height— 用於適當縮放的畫面尺寸- 畫面標題與說明(用於文字覆蓋層)
- 以
-
素材下載:
- 使用
web_fetch或Bash搭配curl下載截圖 - 儲存至暫存目錄:
assets/screens/{screen-name}.png - 按照預期的逐步解說流程順序整理素材
- 使用
步驟 3:設定 Remotion 專案
-
檢查是否已有 Remotion 專案:
- 尋找
remotion.config.ts或含有 Remotion 相依項目的package.json - 若存在,則使用現有的專案結構
- 尋找
-
建立新的 Remotion 專案(若需要):
npm create video@latest -- --blank- 選擇 TypeScript 範本
- 在專用的
video/目錄中設定
-
安裝相依項目:
cd video npm install @remotion/transitions @remotion/animated-emoji
影片組合策略
架構
建立一個模組化的 Remotion 組合,包含以下元件:
-
ScreenSlide.tsx— 個別畫面顯示元件- Props:
imageSrc,title,description,width,height - 功能:縮放動畫、淡出轉場
- 持續時間:可設定(預設每個畫面 3-5 秒)
- Props:
-
WalkthroughComposition.tsx— 主要影片組合- 將多個
ScreenSlide元件依序排列 - 處理畫面間的轉場
- 加入文字覆蓋層與註解
- 將多個
-
config.ts— 影片設定- 影格率(預設:30 fps)
- 影片尺寸(對應 Stitch 畫面尺寸或適當縮放)
- 總時長計算
轉場效果
使用 Remotion 的 @remotion/transitions 實現專業效果:
-
淡出:畫面間的平滑交叉淡出
import {fade} from '@remotion/transitions/fade'; -
滑動:方向性滑動轉場
import {slide} from '@remotion/transitions/slide'; -
縮放:用於強調的縮放效果
- 使用
spring()動畫實現流暢縮放 - 應用至重要的 UI 元素
- 使用
文字覆蓋層
使用 Remotion 的文字渲染功能加入情境資訊:
- 畫面標題:顯示在每個畫格的頂端或底部
- 功能標示:以動畫指標強調特定 UI 元素
- 說明文字:為每個畫面淡入描述性文字
- 進度指示器:顯示在逐步解說中的當前畫面位置
執行步驟
步驟 1:收集畫面素材
- 辨識目標 Stitch 專案
- 列出專案中的所有畫面
- 下載每個畫面的截圖
- 依照逐步解說流程順序整理
- 建立清單檔(
screens.json):
{
"projectName": "Calculator App",
"screens": [
{
"id": "1",
"title": "主畫面",
"description": "包含數字鍵盤的主要計算機介面",
"imagePath": "assets/screens/home.png",
"width": 1200,
"height": 800,
"duration": 4
},
{
"id": "2",
"title": "歷史記錄檢視",
"description": "先前的計算記錄檢視",
"imagePath": "assets/screens/history.png",
"width": 1200,
"height": 800,
"duration": 3
}
]
}
步驟 2:產生 Remotion 元件
遵循 Remotion 最佳實務建立影片元件:
-
建立
ScreenSlide.tsx:- 使用
useCurrentFrame()和spring()實現動畫 - 實作縮放與淡出效果
- 加入具有適當時間點的文字覆蓋層
- 使用
-
建立
WalkthroughComposition.tsx:- 匯入畫面清單
- 使用
<Sequence>元件依序排列畫面 - 在畫面間套用轉場
- 計算適當的時間點與偏移量
-
更新
remotion.config.ts:- 設定組合 ID
- 設定影片尺寸
- 設定影格率與時長
參考資源:
- 使用
resources/screen-slide-template.tsx作為起點 - 參考
resources/composition-checklist.md確保完整性 - 檢視
examples/walkthrough/目錄中的範例
步驟 3:預覽與調整
-
啟動 Remotion Studio:
npm run dev- 開啟瀏覽器為基礎的預覽
- 允許即時編輯與調整
-
調整時間點:
- 確保每個畫面有適當的顯示時間
- 確認轉場流暢
- 檢查文字覆蓋層的時間點
-
微調動畫:
- 調整縮放效果的
spring設定 - 修改轉場的 easing 函數
- 確保文字始終清晰可讀
- 調整縮放效果的
步驟 4:渲染影片
-
使用 Remotion CLI 渲染:
npx remotion render WalkthroughComposition output.mp4 -
替代方案:使用 Remotion MCP(若可用):
- 以組合詳細資料呼叫
[remotion_prefix]:render - 指定輸出格式(MP4、WebM 等)
- 以組合詳細資料呼叫
-
最佳化選項:
- 設定品質等級(
--quality) - 設定編碼器(
--codec h264或h265) - 啟用並行渲染(
--concurrency)
- 設定品質等級(
進階功能
互動式熱點
強調可點擊的元素或重要功能:
import {interpolate, useCurrentFrame} from 'remotion';
const Hotspot = ({x, y, label}) => {
const frame = useCurrentFrame();
const scale = spring({
frame,
fps: 30,
config: {damping: 10, stiffness: 100}
});
return (
<div style={{
position: 'absolute',
left: x,
top: y,
transform: `scale(${scale})`
}}>
<div className="pulse-ring" />
<span>{label}</span>
</div>
);
};
旁白整合
為逐步解說加入旁白:
- 從畫面說明產生旁白腳本
- 使用文字轉語音或錄製音訊
- 使用
<Audio>元件將音訊匯入 Remotion - 將畫面時間點與旁白節奏同步
動態文字擷取
從 Stitch HTML 程式碼中擷取文字以自動產生註解:
- 為每個畫面下載
htmlCode.downloadUrl - 解析 HTML 以擷取關鍵文字元素(標題、按鈕、標籤)
- 為重要的 UI 元素自動產生標示
- 以定時文字覆蓋層的形式加入組合
檔案結構
project/
├── video/ # Remotion 專案目錄
│ ├── src/
│ │ ├── WalkthroughComposition.tsx
│ │ ├── ScreenSlide.tsx
│ │ ├── components/
│ │ │ ├── Hotspot.tsx
│ │ │ └── TextOverlay.tsx
│ │ └── Root.tsx
│ ├── public/
│ │ └── assets/
│ │ └── screens/ # 已下載的 Stitch 截圖
│ │ ├── home.png
│ │ └── history.png
│ ├── remotion.config.ts
│ └── package.json
├── screens.json # 畫面清單
└── output.mp4 # 渲染後的影片
與 Remotion 技能的整合
Remotion 維護其自己的 Agent 技能,定義了最佳實務。請參考這些技能以學習進階技巧:
- 儲存庫:https://github.com/remotion-dev/remotion/tree/main/packages/skills
- 安裝方式:
npx skills add remotion-dev/skills
要運用的關鍵 Remotion 技能:
- 動畫時間點與 easing
- 組合架構模式
- 效能最佳化
- 音訊同步
常見模式
模式 1:簡單幻燈片
具有淡出轉場的基本逐步解說:
- 每個畫面 3-5 秒
- 交叉淡出轉場
- 底部文字覆蓋層顯示畫面標題
- 頂部進度條
模式 2:功能強調
聚焦在特定 UI 元素:
- 放大特定區域
- 指向功能的動畫圓圈/箭頭
- 關鍵互動的慢動作強調
- 並排的前後比較
模式 3:使用者流程
顯示逐步的使用者旅程:
- 具有方向性滑動的連續畫面流程
- 編號步驟覆蓋層
- 強調使用者動作(點擊、觸摸)
- 以動畫路徑連接畫面
疑難排解
| 問題 | 解決方案 |
|---|---|
| 截圖模糊 | 確保下載的圖片為全解析度;檢查 screenshot.downloadUrl 的品質設定 |
| 文字錯位 | 確認畫面尺寸與組合大小相符;根據實際畫面尺寸調整文字位置 |
| 動畫不流暢 | 將影格率提高至 60fps;使用適當阻尼設定的 spring 設定 |
| Remotion 建置失敗 | 檢查 Node 版本相容性;確認所有相依項目已安裝;參考 Remotion 文件 |
| 時間點感覺不對 | 在清單中調整每個畫面的持續時間;在 Remotion Studio 中預覽;以實際使用者測試 |
最佳實務
- 保持長寬比:使用實際的 Stitch 畫面尺寸或等比例縮放
- 一致的時間點:除非要強調特定畫面,否則保持每個畫面的顯示時間一致
- 文字可讀性:確保足夠的對比度;使用適當的字型大小;避免雜亂的覆蓋層
- 流暢的轉場:使用 spring 動畫實現自然運動;避免突兀的切換
- 徹底預覽:在最終渲染前,務必在 Remotion Studio 中預覽
- 最佳化素材:適當地壓縮圖片;使用高效的格式(UI 用 PNG,照片用 JPG)
使用範例
使用者提示:
查詢我的 Stitch 專案「Calculator App」中的畫面,並建立一個 Remotion 影片來展示這些畫面的逐步解說。
代理工作流程:
- 列出 Stitch 專案 → 找到「Calculator App」→ 擷取專案 ID
- 列出專案中的畫面 → 辨識所有畫面(主畫面、歷史記錄、設定)
- 為每個畫面下載截圖 → 儲存至
assets/screens/ - 建立包含畫面中繼資料的
screens.json清單 - 產生 Remotion 元件(
ScreenSlide.tsx、WalkthroughComposition.tsx) - 在 Remotion Studio 中預覽 → 調整時間點與轉場
- 渲染最終影片 →
calculator-walkthrough.mp4 - 回報完成,並附上影片預覽連結
成功祕訣
- 從簡單開始:先使用基本的淡出轉場,再加入複雜動畫
- 遵循 Remotion 模式:運用 Remotion 的官方技能與文件
- 使用清單檔:將畫面資料以 JSON 方式組織,便於更新
- 頻繁預覽:使用 Remotion Studio 及早發現問題
- 考慮無障礙性:加入字幕;確保文字可讀;使用清晰的視覺元素
- 針對平台最佳化:將影片尺寸調整為目標平台(YouTube、社群媒體等)的規格
參考資料
- Stitch 文件:https://stitch.withgoogle.com/docs/
- Remotion 文件:https://www.remotion.dev/docs/
- Remotion 技能:https://www.remotion.dev/docs/ai/skills
- Remotion MCP:https://www.remotion.dev/docs/ai/mcp
- Remotion 轉場:https://www.remotion.dev/docs/transitions
使用時機
當處理的任務與上述主要領域或功能明確相關時,使用此技能。
限制
- 僅在任務與上述範圍明確相符時使用此技能。
- 請勿將輸出視為環境特定驗證、測試或專家審查的替代方案。
- 若缺少必要的輸入、權限、安全邊界或成功標準,請停止並要求釐清。