如何从视频里量出动效?top-welcome-screens MOTION_SPEC:30fps还原精确动画时间轴
如何从视频里量出动效?top-welcome-screens MOTION_SPEC:30fps还原精确动画时间轴
top-welcome-screens 是一个用 React Native + Expo 复刻 10 个顶级 iOS 应用启动页动画的开源项目。它最值钱的一份"文档"不是代码,而是一份从 30fps 参考视频中逐帧测量出来的动效时间轴——docs/MOTION_SPEC.md。下面这篇指南带你读懂这份"量出来的动画规格"是怎么写、怎么用、怎么保证精确的。
为什么动效要"逐帧测量",而不是凭感觉?
大多数人对"动画时长 0.5 秒"的直觉误差能到 ±15%,但对顶级 App 的复刻来说,100ms 的偏差就足以让动效"看起来不对"。
项目的做法很朴素但非常有效:
- 所有时间都来自 30fps 的录屏,每一帧 = 1/30 秒 ≈ 33.3ms;
- 规格表里的每个时间点都是帧的整数倍,例如
0.400s恰好是第 12 帧,0.567s是第 17 帧; - 文档开头有一句关键声明:"Times are measured from the supplied 30 fps clips. Small codec-only pixel changes are excluded." —— 只有真实的内容变化才被记录,纯编码噪声的像素抖动被排除,这避免了把视频压缩伪影误判成动效。
换句话说:这份 MOTION_SPEC 是一份可以直接用于审计实现的动画测量报告。
读懂 MOTION_SPEC:10 个启动页的时间轴速查表
打开 docs/MOTION_SPEC.md,每个 App 一个小节,"总时长 + 时间段列表"就是全部信息。摘录如下:
| 启动页 | 总时长 | 最有代表性的片段 |
|---|---|---|
| Duolingo | 2.667s | 0.400–0.567 第一次眨眼 |
| Strava | 6.600s | 5.133 硬切到最终页 |
| MyFitnessPal | 8.867s | 2.900 文案从 Updating... 切到 Loading... |
| Perplexity | 无动效 | 仅最终静态状态 |
| Yazio | 1.733s | 1.167–1.700 图标逐个弹簧入场 |
| onX Hunt | 1.467s | 1.067 硬切到登录页 |
| Speak & Learn | 4.940s | 3.567–3.800 强 ease-out 滑入 |
| Hallow | 4.500s | 0.233–0.467 紫色渐变插值 |
| SCRL | 1.999s | 1.300–1.800 分层淡入 |
| Speak: Language | 5.070s | 2.833–3.100 页面横滑切换 |
这张表的价值在于:它把"视频里看到的感觉"变成了可执行、可测试的数值。
动效的三种"语言":溶解、硬切、错落弹簧
逐帧测量最大的收获,是发现真实 App 的过渡方式远比想象中"粗粝"。MOTION_SPEC 里明确区分了三类:
1. 溶解(Dissolve)——真正的渐变 Yazio 的 0.567–0.800s,启动页溶解进目标外壳;Hallow 的 2.767–3.033s,整个 loader 溶解进最终页。
2. 硬切(Hard Cut)——一帧之内直接换画面
这是最容易"凭感觉做错"的地方。Strava 在 5.133s 硬切到最终页,MyFitnessPal 在 7.333s 硬切到轮播页,SCRL 在 1.200s 硬切到骨架屏。如果用渐隐渐显去"美化"这些片段,动效就失准了——所以规格表专门标注了 hard cut。
3. 错落弹簧(Staggered Springs)——元素逐个入场
Yazio 在 1.167–1.700s 之间,胡萝卜、苹果、时钟、日历、厨师帽各自以独立的阻尼弹簧错开入场,而不是整体淡入。代码里每个元素都有自己的入场窗口(如 <a href="https://link.gitcode.com/i/1d1277e2d10c97ca98f393b1c304183e" target="_blank">1167, 1410]、[1233, 1490] 毫秒),来源见 [src/welcome-screens/yazio.tsx。
还有一个值得学习的克制:Perplexity 只测出了最终静帧、没有动效片段,实现就干脆渲染最终状态,不编造入场动画。不确定的地方不猜,这正是测量型动效文档的纪律。
从规格表到代码:一条 0–1 时间轴驱动一切
MOTION_SPEC 里的毫秒数如何变成代码?项目用了一套非常统一的机制,核心只有两个共享工具:
① 一条线性时间轴 — src/welcome-screens/shared/timeline.ts
useWelcomeTimeline(durationMs) 返回一个从 0 线性走到总时长的共享值 time,并自动处理 autoplay={false} 时直接渲染最终态、以及系统"减弱动态效果"偏好下跳过动画。
② 把时间点变成 0–1 进度 — src/welcome-screens/shared/geometry.ts
segment(timeMs, startMs, endMs) 是全局通用的"窗口函数":传入 MOTION_SPEC 里的起止毫秒,得到该动画段内的归一化进度,再配合 Easing 曲线就能还原任何过渡。
举个真实例子。Strava 的规格是"0.867–5.133s spinner 旋转,5.133s 硬切",对应 src/welcome-screens/strava.tsx 里:
- splash 层:
opacity: time.value < 5133 ? 1 : 0—— 注意是瞬间归零,这就是"硬切"的代码形态; - spinner 层:
time.value >= 867 && time.value < 5133才可见。
再配合统一的 640×1385 参考画布 src/welcome-screens/shared/reference-canvas.tsx,所有布局都在同一坐标系下校准后响应式缩放——所以"量出来的时间"和"画出来的位置"都能对得上。
保证数字精确的四条纪律
如果你要复刻这份方法论,这四条来自项目的规则值得抄进自己的工作流:
- 固定帧率:用 30fps 录屏,时间分辨率就是 33.3ms,规格表天然自洽;
- 过滤编码噪声:只记录内容级变化,忽略"codec-only pixel changes";
- 校准而非猜:README 中写明,动效实现是在 iPhone 模拟器上对着 30fps 参考资料逐段校准的;
- 改动必须回写文档:贡献指南要求"任何时间改动都必须记录在
docs/MOTION_SPEC.md",规格表和代码永远同步。
另外注意一个版权细节:原始参考视频刻意不放进仓库,仓库只分发"测得的时间笔记 + 新生成的参考图"。生成资产清单可查 docs/ASSET_PROVENANCE.md,展示图的合成脚本在 scripts/render-showcase.swift。
可以抄走的清单:从视频量动效的 6 步流程
把上面的方法压缩成一份可执行清单,适用于任何"想复刻一段 UI 动效"的场景:
- 录屏:30fps 固定帧率,覆盖完整动效 + 少量前后静帧;
- 找变化点:逐帧做像素差异,标记出内容真正变化的帧;
- 算时间:帧号 ÷ 30 = 秒,起止帧各记一个,得到
[start, end]区间; - 给过渡分类:dissolve / hard cut / spring / slide,写明 easing 方向(如 strong ease-out);
- 写成规格表:模仿 MOTION_SPEC 的格式,"总时长 + 时间段列表",不确定就留白,绝不编造;
- 代码对照:用"线性时间轴 + segment 窗口函数"实现,再回模拟器逐帧比对。
想动手验证,直接克隆仓库运行即可:
git clone https://gitcode.com/gh_mirrors/to/top-welcome-screens
cd top-welcome-screens
npm ci
npm run ios
默认路由打开 Duolingo 页面,/strava、/yazio 等 10 个路由直达各启动页;带 motion=0 参数可跳到确定性最终态,改 replay 查询值可重播动画——这些 API 本身就是"动效规格可复现"的一部分。
一句话总结
top-welcome-screens 证明了:动画"手感"可以被测量。一份 30fps 逐帧量出来的 MOTION_SPEC,加上"线性时间轴 + 窗口函数"的实现方式,让 10 个顶级 App 的启动页动效变成了可读、可改、可审计的数值工程。下次再遇到"这个动画大概多少秒"的争论,答案很简单——去量,别猜。

