Communitygithub.com

文本消息动画

将聊天脚本转换为引人入胜的对话视频:气泡逐一出现,每次回复前有打字指示器闪烁,发送时伴有音效,线程自动滚动以保持最新消息在画面中。

文本消息动画 是什么?

该技能专为生成“伪短信”或聊天故事视频而设计,适用于TikTok、Reels和Shorts等9:16垂直格式。它能够模拟iMessage、WhatsApp或SMS对话,通过精心编排的动画节奏(包括打字指示器、气泡弹出、音效同步和自动滚动)来保持观众的高留存率。核心数据模型基于一个消息数组,支持从JSON或CSV脚本批量生成多个视频,使制作流程高度可重复。该技能基于Remotion框架实现,所有动画(气泡进入、打字脉冲、滚动偏移和音效)都完全由帧驱动,确保无头渲染一致性。它严格遵循特定应用的外观和感觉(如蓝色/绿色气泡、灰色收件气泡、已读回执等),并提供详细的时序控制和安全区域指南,以适配9:16垂直格式的视频制作。

兼容平台~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. 一次只显示一条消息,并保持节奏。 留存率来自于逐步释放:先是一段打字,然后一个气泡弹出,接着停顿供阅读。绝不要在0帧时就把整个对话全部展示——要像真实对话一样有节奏(在接收到的回复前显示打字指示器,每个气泡后短暂停顿供阅读)。
  2. 界面必须立即被识别为真实应用。 发送的消息靠右,蓝色(iMessage)或绿色(SMS)/ WhatsApp绿色;接收的消息靠左,灰色。同一发送者的连续气泡中最后一个带有气泡尾巴。圆角约为18-22像素,状态栏和标题正确。如果观众在开头半秒内无法分辨是哪个应用,幻象就破灭了。

数据模型——先写脚本,后渲染

一切基于一个消息数组。将故事编写为数据;渲染器只负责播放。这使得格式可批量处理:一个模板 × 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: "❓" },
];

据此数组推导每个帧的时间戳——详见下方“时序”。仅保留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(深色)。短信发送绿色#37C24A。WhatsApp发送#005C4B,接收#202C33,聊天壁纸#0B141A,带对勾标记(灰色=已发送,蓝色#53BDEB=已读)。完全匹配一个应用;不要混用iMessage界面与WhatsApp对勾。

逐条出现 + 打字指示器

每个气泡从其自身入场帧开始,从略下方弹起并带有轻微缩放弹出效果。接收的消息前会有一个三点打字气泡脉冲,然后被真实气泡替换。

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>
  );
};

// 三点打字指示器——点以正弦波呼吸,帧驱动(无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>之前放置,使其先显示,然后切换到真实气泡。只有接收的消息需要打字;发送的消息直接弹出(你不会看自己打字)。

时序——将数组转换为帧

遍历消息,以毫秒为单位累积一个游标。这是弹簧入场、打字窗口、音效和自动滚动都读取的唯一真实数据源。

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 PM”)是一个居中的灰色分隔线,显示在新时间块的第一个消息上方——不要给每个气泡都加时间戳。
  • 回应/轻点回应在目标气泡出现后约400ms在其角落缩放进来,带有轻微的过冲。锚定到该气泡的enterMs + 400,而不是全局帧。

自动滚动——保持最新消息在画面中

当消息堆栈超出可见区域时,整体向上平移整个线程,使最新消息位于画面下方三分之一处。每次消息落地时,用弹簧将滚动偏移向目标值动画化——应该平滑滑动,而不是跳跃。

// 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),以免在快速对话中重叠。永远不要使用计时器触发音效——在帧时间线上调度它,以便在无头渲染中可靠工作。

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

区域保持清晰原因
顶部状态栏约120px你的假状态栏/刘海位于此处;不要让气泡出现在其下方
应用标题栏约150px(头像 + 名字)联系人标题栏定义了应用——保持固定且不被遮挡
底部输入栏 + UI约360px假输入栏和平台的字幕/CTA/音频UI都会挤占底部
侧边距居中约88%宽度气泡从不接触屏幕边缘——边缘空间让界面看起来像“手机”

在标题栏和输入栏之间的区域运行实时对话。将每个新气泡落在这个区域的下三分之一(输入栏上方),然后自动滚动——这是眼睛期望看到最新消息的位置。

输出检查清单

  • 由一个消息数组驱动一切;时间戳推导得出,非手工放置。
  • 一次只显示一条消息:阅读间隔 → 打字(仅接收)→ 弹出,按调整好的节奏。
  • 端到端正确的应用界面(颜色、尾巴、标题栏、回执)——不混用应用。
  • 发送靠右/蓝或绿,接收靠左/灰;每个连续对话的最后一条有尾巴。
  • 最后一条发送消息下有回执;每个时间块有时间戳分隔线;轻点回应带有过冲。
  • 自动滚动使最新消息保持在下方三分之一,远离安全区域。
  • 每个消息有一个弹出/叮声音效,在帧时间线上调度(非计时器)。
  • 标题栏固定在状态栏下方;对话在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动画计时器——因此任何帧在无头渲染时都完全相同。可交付物 = out/*.mp4 + 项目(可用新脚本重新渲染)。默认输出9:16竖屏(1080×1920)。时长由数据决定,因此在 calculateMetadata 中根据时间线游标计算 durationInFrames,绝不要手工设置。

验证循环——渲染静帧 → 检查 → 编码。 揭示时机和滚动位置是容易出问题的地方;在花费时间编码之前检查确切的帧。

# 使用传递的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:
#  - 第24帧显示左侧(接收)的三点打字指示器,尚无真实气泡
#  - 在中间帧,刚弹出的气泡位于正确的侧边/颜色,带有尾巴;回执/回应位置正确
#  - 对话已自动滚动,最新气泡位于下方三分之一,未被输入栏遮挡
#  - 应用界面一致(状态栏、标题栏),位于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 并选择打字、中间和结束帧。如需快速无构建预览,相同的布局可作为独立的HTML页面渲染,并带有 ?t=N 寻找控制柄——参见 references/bubble-recipes.md。

完成前:

  1. 静帧在打字帧、中间弹出帧和最后一个气泡帧处渲染清晰——无缺失字体/音频。
  2. 在打字帧,指示器(而非气泡)显示在接收侧;气泡在之后才弹出。
  3. 每个气泡位于正确的侧边/颜色,带有正确的尾巴;回执/时间戳/回应出现在预期位置。
  4. 自动滚动在每个检查帧都将最新气泡保持在下方三分之一且位于9:16安全区域内。
  5. 仅使用帧驱动(无 Date.now()/Math.random()/计时器);传递的props正确渲染;生成MP4及可选的GIF。

参考文件

  • references/bubble-recipes.md — 可复制构建:iMessage/WhatsApp/SMS界面和调色板、消息数据模型 → 帧时间线、弹簧气泡+尾巴、三点打字指示器、已读回执/时间戳/轻点回应、自动滚动、每消息音效调度、完整的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.

相关技能