打造Figma式弹簧手感:AdditiveAnimator真实物理弹簧动画setSpring参数全解析

原创2026-10-22 17:22:171,866 阅读

打造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 的交互

Android弹簧动画链式演示

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),无震荡最快到达
  • 过阻尼:双指数项叠加,缓慢趋近

两个工程细节让体验更"稳":

  1. 稳定判定阈值:剩余位移 < 总位移的 0.1% 时视为落地(DEFAULT_SETTLING_THRESHOLD = 0.001f),不会提前截断尾部微小的回弹
  2. 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 两个包,感兴趣可以深入阅读。

登录后查看全文
android_additive_animations