打造Figma式弹簧手感:AdditiveAnimator真实物理弹簧动画setSpring参数全解析
打造Figma式弹簧手感:AdditiveAnimator真实物理弹簧动画setSpring参数全解析
android_additive_animations 库的 AdditiveAnimator 现在支持真实物理弹簧动画:只需一行 setSpring(stiffness, dampingRatio),就能让 Android View 获得和 Figma 组件库里 "gentle" 曲线、Compose spring() 一样自然的手感。本文将完整解析 setSpring 与 setSpringWithDuration 两个方法的参数含义、背后的阻尼振子数学原理,以及项目 demo 中的实战用法,帮你快速调出想要的"弹感"。
为什么需要物理弹簧动画?
传统 Android 动画靠 TimeInterpolator(时间插值器)驱动:给定固定时长,曲线决定快慢节奏。它的局限在于——时长是"写死"的,动画越快,运动越生硬;而且中途打断再续动时,速度会突变,看起来"不跟手"。
物理弹簧动画的思路完全不同:
- 不再关心"多久走完",而是描述弹簧本身:多硬(stiffness)、阻力多大(dampingRatio)
- 时长由物理模型自动算出(弹簧"稳定"需要多久)
- 中途打断、改目标,速度平滑衔接,观感接近 iOS / Figma 的交互
AdditiveAnimator 的弹簧能力实现在 BaseAdditiveAnimator.java 中,内部由 AnimationTiming.kt 与 SpringSolver.kt 共同支撑。
两种调用方式,覆盖全部场景
setSpring(stiffness, dampingRatio):直接指定弹簧物理参数
AdditiveAnimator.animate(view)
.setSpring(100, 0.7f) // 刚度100 + 欠阻尼0.7 = 温和回弹
.centerX(x).centerY(y)
.start();
参数1:stiffness(刚度)——弹簧有多"硬",值越大运动越快越脆爽。源码注释给出的典型值:
| stiffness | 手感 | 适用场景 |
|---|---|---|
| 100 | gentle,缓慢柔和 | 大元素位移、背景层过渡 |
| 300 | medium,适中 | 一般卡片、按钮位移 |
| 1000 | stiff,干脆利落 | 小控件、快速跟手 |
参数2:dampingRatio(阻尼比)——决定要不要"来回晃动":
| dampingRatio | 类型 | 观感 |
|---|---|---|
| < 1.0 | 欠阻尼 | 到达目标后弹跳几下,最"Q弹" |
| = 1.0 | 临界阻尼 | 不晃动,且到达最快(Material 风格) |
| > 1.0 | 过阻尼 | 缓慢滑入,无弹性,略显迟滞 |
| 0 | 无阻尼 | 理论上无限震荡,实际不建议 |
调用 setSpring 后,动画时长会自动计算为弹簧稳定所需时间,无需再手动 setDuration。
setSpringWithDuration(durationMs, dampingRatio):由期望时长反推刚度
如果你更习惯"这段动画大概 1300ms 完成"的思维方式(类似 iOS 的 UIView.animate(withDuration:usingSpringWithDamping:)),可以用这个方法:
animator.setSpringWithDuration(1300, 0.7f) // 期望约1.3秒稳定,阻尼0.7
.x(event.getX()).y(event.getY()).start();
它会反解出刚好让弹簧在该时长内"落地"的 stiffness,你只需给时长 + 阻尼两个直觉参数即可。实现见 AnimationTiming.kt 的 withDuration。
弹簧引擎内部发生了什么?
每个动画值都由一个阻尼谐振子解析解驱动,求解器 SpringSolver.kt 直接解微分方程 x''(t) + 2ζω₀x'(t) + ω₀²x(t) = ω₀²·target,三种阻尼区间各有闭式解:
- 欠阻尼:
target + e^(-γt)·(A·cos(ωd·t) + B·sin(ωd·t)),产生来回震荡 - 临界阻尼:
target + (A + B·t)·e^(-ω₀·t),无震荡最快到达 - 过阻尼:双指数项叠加,缓慢趋近
两个工程细节让体验更"稳":
- 稳定判定阈值:剩余位移 < 总位移的 0.1% 时视为落地(
DEFAULT_SETTLING_THRESHOLD = 0.001f),不会提前截断尾部微小的回弹 - 10% 安全余量:settlingDurationMs() 用
t = -ln(threshold) / (ζ·ω₀)算出理论稳定时间后,再乘以 1.1,确保 ValueAnimator 不会掐掉弹簧尾巴
另外 SpringSolver 还暴露了 velocity() 接口并可传入 initialVelocity,为将来的"速度交接"(fling 跟手)预留了能力。
Demo 实战:两行代码对比不同弹簧
项目 demo 里有两个可直接参考的真实用例:
① 跟手拖拽(TapToMoveDemoFragment.java):
AdditiveAnimator.animate(animatedView)
.setSpring(100, 0.7f) // 温和弹簧 + 轻微回弹
.centerX(event.getX()).centerY(event.getY())
.start();
拖动时方块以弹簧方式追随手指,0.7 的欠阻尼带来明显的"甩出去再弹回来"的 Figma 式手感。
② 自定义绘制对象(DemoView.java):
new AdditiveRectAnimator()
.targets(mRects, 50)
.setSpringWithDuration(1300, 0.7f) // 约1.3秒稳定,带回弹
.x(event.getX()).y(event.getY()).rotation(rotationTarget).start();
同一个 AdditiveAnimator 对 5 个自绘矩形做错开(stagger 50ms)的弹簧动画——说明 spring 计时与多目标、链式 API 完全兼容。
与旧版 SpringInterpolator 的区别
早期版本提供的 SpringInterpolator.java 是用衰减余弦曲线近似弹簧手感(振幅 0.13、频率 13.5 之类的手调参数),它始终跑固定时长,并不建模真实的刚度/阻尼。该类已被标记 @Deprecated,官方注释明确建议迁移到 setSpring(stiffness, dampingRatio) 或 setSpringWithDuration(durationMs, dampingRatio)。如果你还有一堆 SpringInterpolator.bouncySpring() 的旧代码,可以放心替换。
常用参数速查表
| 想要的效果 | 推荐写法 |
|---|---|
| Figma 式温和回弹 | setSpring(100, 0.7f) |
| 快速跟手、略有弹性 | setSpring(300, 0.8f) |
| 干脆利落不晃动 | setSpring(1000, 1.0f) |
| 不写时长、只要手感 | setSpringWithDuration(500, 0.9f) |
| 缓慢优雅滑入 | setSpring(100, 1.2f)(过阻尼) |
💡 调参小技巧:先固定
dampingRatio = 0.7f试不同 stiffness 找"速度感",再微调 damping 找"弹跳感",两两组合基本能覆盖全部设计需求。
小结
AdditiveAnimator 的弹簧动画把"手感调参"从玄学变成了两个物理参数:stiffness 管快慢,dampingRatio 管弹不弹,时长由解析解自动推导,配合 AdditiveAnimator 本身的多目标、链式(then / thenWithDelay)能力,一行 setSpring(100, 0.7f) 就能做出媲美 Figma 预览的弹簧交互。相关核心实现集中在 additive_animator 与 helper 两个包,感兴趣可以深入阅读。
