文本消息动画 是做什么的?
将聊天脚本转化为令人驻足的对话视频:气泡逐一显现,每次回复前有打字指示器闪烁,发送时伴有音效,并且线程自动滚动以确保最新消息始终在画面中。这是高留存率的无脸短视频格式之一——一个用iMessage/WhatsApp/SMS气泡讲述的故事,让观众仿佛在偷看别人的手机。
使用时机
- 为TikTok、Reels和Shorts制作“伪短信”/聊天故事视频(9:16竖屏)。
- 根据脚本将iMessage、WhatsApp或通用SMS对话动画化。
- 制作回复/评论反应视频,通过逐条显示消息来揭示笑点。
- 从一个模板加一个消息数组或CSV批量生成多个聊天视频。
两条不可妥协的规则
- 一次只显示一条消息,并保持节奏。 留存率来自于逐步释放:先是一段打字,然后一个气泡弹出,接着停顿供阅读。绝不要在0帧时就把整个对话全部展示——要像真实对话一样有节奏(在接收到的回复前显示打字指示器,每个气泡后短暂停顿供阅读)。
- 界面必须立即被识别为真实应用。 发送的消息靠右,蓝色(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。
完成前:
- 静帧在打字帧、中间弹出帧和最后一个气泡帧处渲染清晰——无缺失字体/音频。
- 在打字帧,指示器(而非气泡)显示在接收侧;气泡在之后才弹出。
- 每个气泡位于正确的侧边/颜色,带有正确的尾巴;回执/时间戳/回应出现在预期位置。
- 自动滚动在每个检查帧都将最新气泡保持在下方三分之一且位于9:16安全区域内。
- 仅使用帧驱动(无
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从一个模板批量渲染多个视频。