如何从视频里量出动效?top-welcome-screens MOTION_SPEC:30fps还原精确动画时间轴

原创2026-11-15 09:50:572,275 阅读

如何从视频里量出动效?top-welcome-screens MOTION_SPEC:30fps还原精确动画时间轴

top-welcome-screens 是一个用 React Native + Expo 复刻 10 个顶级 iOS 应用启动页动画的开源项目。它最值钱的一份"文档"不是代码,而是一份从 30fps 参考视频中逐帧测量出来的动效时间轴——docs/MOTION_SPEC.md。下面这篇指南带你读懂这份"量出来的动画规格"是怎么写、怎么用、怎么保证精确的。

top-welcome-screens 复刻的 10 个 iOS 启动页动效展示:Duolingo、Strava、MyFitnessPal、Perplexity、Yazio

为什么动效要"逐帧测量",而不是凭感觉?

大多数人对"动画时长 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 只测出了最终静帧、没有动效片段,实现就干脆渲染最终状态,不编造入场动画。不确定的地方不猜,这正是测量型动效文档的纪律。

onX Hunt、Speak & Learn、Hallow、SCRL、Speak 五个启动页动效的复刻效果展示

从规格表到代码:一条 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,所有布局都在同一坐标系下校准后响应式缩放——所以"量出来的时间"和"画出来的位置"都能对得上。

保证数字精确的四条纪律

如果你要复刻这份方法论,这四条来自项目的规则值得抄进自己的工作流:

  1. 固定帧率:用 30fps 录屏,时间分辨率就是 33.3ms,规格表天然自洽;
  2. 过滤编码噪声:只记录内容级变化,忽略"codec-only pixel changes";
  3. 校准而非猜:README 中写明,动效实现是在 iPhone 模拟器上对着 30fps 参考资料逐段校准的;
  4. 改动必须回写文档:贡献指南要求"任何时间改动都必须记录在 docs/MOTION_SPEC.md",规格表和代码永远同步。

另外注意一个版权细节:原始参考视频刻意不放进仓库,仓库只分发"测得的时间笔记 + 新生成的参考图"。生成资产清单可查 docs/ASSET_PROVENANCE.md,展示图的合成脚本在 scripts/render-showcase.swift。

可以抄走的清单:从视频量动效的 6 步流程

把上面的方法压缩成一份可执行清单,适用于任何"想复刻一段 UI 动效"的场景:

  1. 录屏:30fps 固定帧率,覆盖完整动效 + 少量前后静帧;
  2. 找变化点:逐帧做像素差异,标记出内容真正变化的帧;
  3. 算时间:帧号 ÷ 30 = 秒,起止帧各记一个,得到 [start, end] 区间;
  4. 给过渡分类:dissolve / hard cut / spring / slide,写明 easing 方向(如 strong ease-out);
  5. 写成规格表:模仿 MOTION_SPEC 的格式,"总时长 + 时间段列表",不确定就留白,绝不编造;
  6. 代码对照:用"线性时间轴 + 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 的启动页动效变成了可读、可改、可审计的数值工程。下次再遇到"这个动画大概多少秒"的争论,答案很简单——去量,别猜。

登录后查看全文
top-welcome-screens