Communitygithub.com

文字訊息動畫

將聊天腳本轉換成引人注目的對話影片:氣泡逐一出現,輸入指示器在回覆前跳動,傳送時伴有音效,聊天串自動滾動以保持最新訊息在畫面中。

文字訊息動畫 是什麼?

「文字訊息動畫」是一款專為短影音平台(如 TikTok、Reels、Shorts)設計的 Remotion 組合,能根據一組訊息陣列驅動,自動生成模擬 iMessage、WhatsApp 或 SMS 對話的直式(9:16)影片。其核心價值在於透過「逐條揭露」的節奏(閱讀間隔 → 輸入指示器 → 氣泡彈出 → 音效同步)來最大化觀眾留存率,每條訊息都獨立編排入場時間、打字動畫、已讀回執與反應貼圖,完全由 frame 驅動(不使用 setTimeout 或 CSS 動畫計時器),確保每次渲染結果一致。開發者只需提供 `Message[]` 陣列(或透過 CSV 批次匯入),即可自動計算影片時長、自動滾動聊天串、並輸出 1080×1920 的 MP4 檔案。支援 iMessage 藍/綠、WhatsApp 綠與深/淺色模式,且嚴格遵循 9:16 安全區域(頂部狀態列、應用程式標頭、底部輸入欄與側邊間距皆預留空間),讓成品像真實的手機螢幕截圖。整個流程透過 `npx remotion render` 指令即可完成,並提供 `scripts/` 中的 contact-sheet 與 probe 工具協助驗證關鍵幀(打字中、氣球彈出、最後一條訊息)。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ItsMeMal/mallss3d-motion/tree/HEAD/.claude/skills/text-message-animation

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

文字訊息動畫 是做什麼的?

將聊天腳本轉換成引人注目的對話影片:氣泡逐一出現,輸入指示器在回覆前跳動,音效在傳送時爆發,聊天串自動滾動以保持最新訊息在畫面中。這是最能留住觀眾的匿名短影音格式之一——一個以 iMessage/WhatsApp/SMS 氣泡呈現的故事,讓觀看者彷彿在偷看某人的手機。

使用時機

  • 為 TikTok、Reels 和 Shorts 製作「假簡訊」/ 聊天故事影片(9:16 直式)。
  • 根據腳本製作 iMessage、WhatsApp 或一般 SMS 對話動畫。
  • 回覆/留言反應影片,逐步揭露爆點的聊天串。
  • 從一個模板搭配訊息陣列或 CSV 批次產出多部聊天影片。

兩個不可妥協的原則

  1. 一次揭露一條訊息,依節奏進行。 留住觀眾的關鍵在於逐步釋出:先是一拍打字節奏,然後氣泡彈出,再暫停讓觀眾閱讀。絕對不要在 frame 0 就把整個聊天串全部顯示——要像真實對話一樣鋪陳(收到回覆前顯示輸入指示器,每個氣泡後短暫停留給讀取時間)。
  2. 對話框必須立即讓人認出是真實的應用程式。 傳送的訊息靠右、藍色(iMessage)或綠色(SMS)/ WhatsApp 綠色;接收的靠左、灰色。同一發送者連續訊息的最後一個氣泡要有尾巴,圓角約 18–22px,狀態列和標題欄要正確。如果觀眾在半秒內無法辨認是哪個應用程式,幻覺就破了。

資料模型 — 先撰寫腳本,再進行渲染

一切由一個訊息陣列驅動。以資料形式撰寫故事,渲染器僅負責播放。這就是為什麼這個格式可以批次處理:一個模板 × N 個腳本 → N 部影片。

type Message = {
  from: "me" | "them";        // me = 傳送 (右/藍), them = 接收 (左/灰)
  text: string;
  typingMs?: number;          // 在此訊息前顯示輸入指示器的時間長度(僅接收方)
  delayMs?: number;           // 在前一個氣泡之後、此氣泡之前的閱讀間隔
  status?: "delivered" | "read";  // 在最後一個傳送氣泡下方的送達/已讀回執
  reaction?: "❤️" | "👍" | "😂" | "‼️" | "❓"; // 回饋表情,在氣泡出現後約 400ms 顯示
};

const thread: Message[] = [
  { from: "them", text: "等等你現在在哪", typingMs: 900 },
  { from: "me",   text: "你家門口 🙂", delayMs: 600, status: "read" },
  { from: "them", text: "...", typingMs: 1400, reaction: "❓" },
];

從這個陣列推導出每個 frame 的時間戳記——請參閱下方的「時間安排」。保持 text/from 為唯二必填欄位,這樣 CSV(from,text,typingMs,delayMs,status)可以直接對應。

氣泡佈局與對齊

氣泡是一個最大寬度的藥丸形狀,並對齊到各自的側邊。傳送氣泡貼齊右側,接收氣泡貼齊左側。依傳送順序垂直堆疊;同一發送者連續訊息的最後一個氣泡要有尾巴。

const BUBBLE: React.CSSProperties = {
  maxWidth: "74%",                // 永遠不佔滿寬度——保留「這是手機螢幕」的邊距
  padding: "14px 18px",
  borderRadius: 22,
  fontSize: 34,                   // 在 1080px 寬下接近 iMessage 比例
  lineHeight: 1.25,
  wordBreak: "break-word",
};
const SENT: React.CSSProperties = {
  ...BUBBLE, alignSelf: "flex-end", background: "#0A84FF", color: "#fff",      // iMessage 藍色
};
const RECEIVED: React.CSSProperties = {
  ...BUBBLE, alignSelf: "flex-start", background: "#3B3B3D", color: "#fff",    // 深色模式灰色
};

色彩快速參考:iMessage 傳送 #0A84FF(淺色背景 #1C1C1E),接收 #E9E9EB 文字 #000(淺色)/ #3B3B3D(深色)。SMS 傳送綠色 #37C24A。WhatsApp 傳送 #005C4B,接收 #202C33 在 #0B141A 聊天背景上,並有勾勾(灰色 = 傳送,藍色 #53BDEB = 已讀)。請完全選定一個應用程式,不要混用 iMessage 外觀與 WhatsApp 勾勾。

逐步出現 + 輸入指示器

每個氣泡從略低的位置彈出,帶有微小的縮放效果,並錨定到各自的入場 frame。接收訊息前會顯示一個三點的輸入氣泡跳動,然後被真實氣泡取代。

import { useCurrentFrame, useVideoConfig, spring, interpolate, Sequence } from "remotion";

const Bubble: React.FC<{ enterFrame: number; sent: boolean; children: React.ReactNode }> =
({ enterFrame, sent, children }) => {
  const frame = useCurrentFrame();
  const { fps } = useVideoConfig();
  const p = spring({ frame: frame - enterFrame, fps, config: { damping: 14, mass: 0.7 } });
  return (
    <div style={{
      alignSelf: sent ? "flex-end" : "flex-start",
      transform: `translateY(${interpolate(p, [0, 1], [24, 0])}px) scale(${interpolate(p, [0, 1], [0.85, 1])})`,
      opacity: interpolate(p, [0, 1], [0, 1]),
      transformOrigin: sent ? "bottom right" : "bottom left",
    }}>{children}</div>
  );
};

// 三點輸入指示器——點點以正弦波方式呼吸,由 frame 驅動(不使用 CSS 動畫計時器)
const Typing: React.FC = () => {
  const frame = useCurrentFrame();
  const dot = (i: number) => 0.4 + 0.6 * (0.5 + 0.5 * Math.sin((frame / 8) - i * 0.9));
  return (
    <div style={{ ...RECEIVED, display: "flex", gap: 8, padding: "18px 20px" }}>
      {[0, 1, 2].map(i => (
        <span key={i} style={{ width: 12, height: 12, borderRadius: 6, background: "#aaa", opacity: dot(i) }} />
      ))}
    </div>
  );
};

將輸入指示器放在一個 <Sequence from={typingStart} durationInFrames={typingLen}> 中,緊接在氣泡的 <Sequence> 之前,這樣它會先顯示,然後切換成真實氣泡。只有接收訊息需要打字動畫;傳送訊息直接彈出(你不會看自己打字)。

時間安排 — 將陣列轉換為 frame

遍歷訊息,以毫秒為單位累積遊標。這是彈簧入場、打字視窗、音效和自動滾動的唯一資料來源。

const f = (ms: number) => Math.round((ms / 1000) * fps);
let cursor = 0;
const timeline = thread.map((m) => {
  cursor += m.delayMs ?? 500;                          // 此訊息前的閱讀間隔
  const typingLen = m.from === "them" ? (m.typingMs ?? 800) : 0;
  const typingStart = cursor;
  cursor += typingLen;                                 // 打字動畫在間隔期間播放
  const enterMs = cursor;                              // 氣泡在打字結束瞬間彈出
  cursor += 250;                                       // 穩定時間,然後進入下一個閱讀間隔
  return { ...m, typingStartMs: typingStart, typingLenMs: typingLen, enterMs };
});
const durationMs = cursor + 1000;                      // 尾部填充,確保最後一個氣泡可讀

調整感覺:輕快/有力的對話串使用 delayMs 300–500 和 typingMs 500–900;懸疑揭露則將 typingMs 延長至 1500–2500 再揭曉關鍵對白。在 calculateMetadata 中根據 durationMs 計算 durationInFrames,這樣較長的腳本會自動產生較長的影片。

已讀回執、時間戳與反應

  • 回執(「已送達」/「已讀」)以小型文字靠右顯示在最後一個傳送氣泡下方;在氣泡出現後約 300ms 淡入。在 WhatsApp 上這是雙勾變成藍色。
  • 時間戳(「今天 下午 9:41」)是一個置中的灰色分隔線,顯示在新時間區塊的第一條訊息上方——不需要每條氣泡都標記。
  • 反應 / 回饋表情 在目標氣泡出現後約 400ms 從角落縮放出現,帶有小小的過衝效果。將其錨定到該氣泡的 enterMs + 400,而不是全域 frame。

自動滾動 — 保持最新氣泡在畫面中

當氣泡堆疊超過可視區域時,向上平移整個聊天串,使最新氣泡位於畫面下方三分之一處。每當一條訊息出現時,用彈簧動畫將滾動偏移量平滑移動到目標位置——它應該平滑滑動,而不是跳躍。

// targetY = 所有訊息在可視區域底邊界以上的總高度,在氣泡進入時重新計算
const scroll = spring({ frame: frame - lastEnterFrame, fps, config: { damping: 200 } });
const y = prevY + (targetY - prevY) * scroll;   // 從舊偏移量平滑移動到新偏移量
return <div style={{ transform: `translateY(${-y}px)` }}>{/* 氣泡 */}</div>;

保持最新氣泡遠離底部安全區域(見下方),讓回執/打字點點保持可見。

聲音同步(每條訊息彈出音效)

每次傳送時一個清脆的「嗖/啵」聲和每次接收時一個較柔和的「叮」聲,是讓這格式感覺真實的一半因素。在每條訊息的 enterMs 處放置一個音效提示,與視覺使用相同的時間基準。

import { Audio, staticFile, Sequence } from "remotion";
{timeline.map((m, i) => (
  <Sequence key={i} from={f(m.enterMs)}>
    <Audio src={staticFile(m.from === "me" ? "send.mp3" : "receive.mp3")} />
  </Sequence>
))}

可選地在每個打字視窗期間添加一個安靜的鍵盤敲擊背景音。保持音效簡短(< 300ms),以免在快速對話串中疊加。絕對不要用計時器觸發聲音——要根據 frame 時間線安排,這樣才能在無頭渲染時正常工作。

9:16 安全區域(1080×1920)

區域保持淨空原因
頂部狀態列~120px你的假狀態列 / 瀏海位於此處;不要將氣泡放在它下方
應用程式標頭~150px(頭像 + 名稱)聯絡人標題定義了應用程式——保持固定且不被遮擋
底部輸入欄 + UI~360px假的輸入列以及平台的說明/CTA/音訊 UI 都會佔用底部空間
側邊間距居中 ~88% 寬度氣泡永遠不接觸螢幕邊緣——邊距是讓它看起來像「手機」的關鍵

將對話活動範圍保持在標頭和輸入欄之間的區域。將每個新氣泡落在該區域的下方三分之一處(輸入欄上方),然後自動滾動——那就是觀眾預期新訊息出現的位置。

輸出檢查清單

  • 一個訊息陣列驅動所有內容;時間戳記由資料推導,而非手動放置。
  • 一次一條訊息:閱讀間隔 → 打字動畫(僅接收)→ 彈出,依照調整好的節奏。
  • 從頭到尾使用正確的應用程式外觀(顏色、尾巴、標頭、回執)——不混用應用程式。
  • 傳送靠右/藍或綠,接收靠左/灰;同一發送者連續訊息的最後一條有尾巴。
  • 最後一個傳送氣泡下方有回執;每個時間區塊有時間戳分隔線;回饋表情過衝進入畫面。
  • 自動滾動保持最新氣泡在畫面下方三分之一處,且未進入安全區域。
  • 每條訊息有彈出/叮噹音效,根據 frame 時間線安排(非計時器)。
  • 標頭固定在狀態列下方;對話在 9:16 安全範圍內。

交付與驗證(渲染靜態圖 → MP4)

打包好的輔助腳本(scripts/):使用 scripts/contact-sheet.sh sheet.png f-hook.png f-mid.png f-end.png 拼貼你的靜態圖,然後用 scripts/probe-mp4.sh out.mp4 [WxH] [fps] 驗證編碼。詳見 scripts/README.md。

以 Remotion 組合形式交付(<Composition> + zod schema + defaultProps),其 props 為訊息陣列。每個氣泡入場、打字脈衝、滾動偏移量和音效提示均由 useCurrentFrame() 驅動——絕不使用 Date.now() / Math.random() / CSS 動畫計時器——因此任何 frame 在無頭渲染時都會產生相同結果。交付物 = out/*.mp4 + 專案(可使用新腳本重新渲染)。9:16 直式(1080×1920)為預設。時長取決於資料,因此請在 calculateMetadata 中根據時間線遊標計算 durationInFrames,絕不手動設定。

驗證循環 — 渲染靜態圖 → 檢查 → 編碼。 揭示時間和滾動位置是最容易出錯的地方;在花時間進行完整編碼前,先檢查確切的 frame。

# 使用 SHIPPED PROPS(真實的聊天串)渲染靜態圖:打字節奏 / 中間彈出 / 最後一條氣泡
npx remotion still TextThread out/f-typing.png --frame=24  --props='{"threadSrc":"thread.json"}'
npx remotion still TextThread out/f-mid.png    --frame=90  --props='{"threadSrc":"thread.json"}'
npx remotion still TextThread out/f-end.png    --frame=N   --props='{"threadSrc":"thread.json"}'  # N = durationInFrames-1

# 檢查每個 PNG:
#  - frame 24 在左側(接收)顯示三點輸入指示器,尚未有真實氣泡
#  - 在中間 frame,剛出現的氣泡位於正確側邊/顏色,帶有尾巴;回執/反應放置正確
#  - 聊天串已自動滾動,最新氣泡位於下方三分之一處,而非藏在輸入欄下方
#  - 應用程式外觀一致(狀態列、標頭),且在 9:16 安全範圍內;沒有任何內容在頂端瀏海下方

npx remotion render TextThread out/thread.mp4 --props='{"threadSrc":"thread.json"}'   # 靜態圖正確後再進行一次編碼
npx remotion render TextThread out/demo.gif --codec=gif                               # README 證明片段

使用 npx remotion compositions 讀取 durationInFrames/fps,並選取打字/中間/結尾 frame。如需快速無建置預覽,相同佈局可渲染為獨立 HTML 頁面,帶有 ?t=N 搜尋鉤子——請參閱 references/bubble-recipes.md。

完成前:

  1. 在打字 frame、中間彈出 frame 和最後一條氣泡 frame 的靜態圖渲染乾淨——無缺少字型/音訊。
  2. 在打字 frame,指示器(而非氣泡)顯示在接收側;氣泡僅在之後彈出。
  3. 每個氣泡位於正確側邊/顏色,帶有正確的尾巴;回執/時間戳/反應如預期顯示。
  4. 在每個檢查的 frame,自動滾動保持最新氣泡在下方三分之一處,且在 9:16 安全區域內。
  5. 僅由 frame 驅動(無 Date.now()/Math.random()/計時器);shipped props 正確渲染;輸出 MP4 + 可選 GIF。

參考檔案

  • references/bubble-recipes.md — 可直接複製使用的建置:iMessage/WhatsApp/SMS 外觀與調色板、訊息資料模型 → frame 時間線、彈簧氣泡 + 尾巴、三點輸入指示器、已讀回執/時間戳/回饋表情、自動滾動、每條訊息聲音排程、完整的 Remotion 組合含 calculateMetadata,以及帶有 ?t=N 搜尋鉤子的獨立 HTML 預覽。
  • references/data-driven.md — 腳本 → 訊息資料形狀、以 JSON/CSV 撰寫聊天串、將 CSV 對應到 Message[] 型別,以及使用 @remotion/renderer 從一個模板批次渲染多部影片。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能