Lua缓动函数：六种曲线的运动对比

【语法算法】

单行代码拆解：指数衰减*正弦振荡+1——先拆这一行。弹性缓动的全部数学都在这一行的正弦衰减里：二 的负十次方是指数衰减的包络线，正弦是来回弹的振荡波，两根线相乘就是弹一下又弹一下越弹越小的弹性运动。这篇把缓动函数库整套写法拆开：配置表、六种曲线、并行对比、定时器、调试按钮，一段一段照抄能跑。

一、效果演示：六种曲线的运动对比

演示场六行赛道每行一颗蓝球——六颗球从左到右同时出发，各自走各自的缓动曲线。线性匀速最先到但最无聊；二次起步慢收尾快；三次起步更慢收尾更快；四次前半段几乎不动后半段突然冲线；弹性先冲过头再弹回来稳住。左上角的进度条实时播报当前的进度值。演示里试两笔账：同一时刻六条赛道的进度值差异和到终点的时间差——曲线不同到达的时刻也不同，这就是缓动的全部意义。缓动函数教的是曲线：位置不是直给的，是曲线弯出来的。

flowchart TD
A[计时从零到一] --> B[逐行取缓动值]
B --> C[缓动值映射位置]
C --> D[六行同时上屏]
D --> E{计满了吗}
E -- 否 --> A
E -- 是 --> F[全部到终点 停]

 演示

二、底层原理：六条缓动曲线加一排并行对比

模块的机关是一组搭档。六条缓动曲线：线性匀速、二次加速、二次减速、三次加速、三次减速、弹性回弹——六条曲线从左到右同时跑，同一时刻的进度值各不相同。并行对比：六颗球排在六行赛道上同时出发——同一时刻的位置差就是六条曲线的差异可视化。和单一缓动的分野在"并行对比让差异变得一眼可辨"：单一缓动只能看到一条曲线，并行对比能看到六条曲线在同一时刻的进度差异——差异可见了，选择才有了依据。

三、核心代码：完整模块（上·骨架）

-- @file EasingLib.lua
-- 缓动函数 —— 六种曲线的运动对比

local EasingLib = {}

local 参数配置 = {
    DURATION      = 2.0,
    CURVE_COUNT   = 6,

    AUTOINC_BASE  = 1186000,
}

local _t         = 0
local _loop      = true
local _scheduler = nil
local _autoInc   = 0

local function Linear(k)
    return k
end

local function QuadIn(k)
    return k * k
end

local function QuadOut(k)
    return 1 - (1 - k) * (1 - k)
end

local function CubicIn(k)
    return k * k * k
end

local function CubicOut(k)
    return 1 - math.pow(1 - k, 3)
end

local function Elastic(k)
    if k == 0 then return 0 end
    if k == 1 then return 1 end
    return math.pow(2, -10 * k)
        * math.sin((k * 10 - 0.75) * 2.094) + 1
end

四、核心代码：完整模块（下·六线并行与调度）

local CURVES = { Linear, QuadIn, QuadOut, CubicIn, CubicOut, Elastic }
local NAMES  = { "Linear", "QuadIn", "QuadOut",
    "CubicIn", "CubicOut", "Elastic" }

if not _scheduler then
    _scheduler = 定时调度接口(function(dt)
        _t = _t + dt
        if _t > 参数配置.DURATION then
            if _loop then
                _t = 0
            else
                _t = 参数配置.DURATION
            end
        end
    end, 0.02)
end

定时调度接口Once(function()
    调试按钮绑定接口("重放", function()
        EasingLib.Restart()
    end)
    ShowTip("技能已加载: 缓动函数 (调试按钮触发)")
end, 1.0)

function EasingLib.Restart()
    _t = 0
end

function EasingLib.Unload()
    if _scheduler then SL:Unschedule(_scheduler) end
    _t = 0
end

return EasingLib

五、机制问答

问：六种缓动哪种最常用？
答：三次减速——起步快收尾慢的手感最自然，按钮、面板、弹窗都常用它。

问：弹性缓动适合什么场景？
答：奖励展示、抽卡结果、跳跃落地——凡是需要"弹一下"来引起注意的场景都适合。

问：线性缓动是不是最没用的？
答：不是——进度条和倒计时用线性，因为匀速代表公平和可预期。

问：缓动的输入永远是零到一吗？
答：是——缓动函数的标准接口是接受零到一的进度值返回零到一的结果值，超范围的输入要自己钳。

问：缓动可以叠加吗？
答：可以——缓动套缓动就是嵌套动画，外层控总进度内层控局部进度，两套曲线叠加出复杂节奏。

六、调参与实战怎么用

六种缓动的选用不是"哪个最好"而是"哪个合适"——线性给进度条、减速给按钮、加速给出手、弹性给奖励，每种曲线有自己的岗位。常见坑：缓动函数的输入没有钳到零到一导致越界；弹性缓动在进度接近一的时候震荡过久。

写完留一句给做动画系的同学：缓动函数卖的是"位置不是直给的"——那六颗同时出发但进度各不相同的蓝球，是把"什么时候到"升级成"怎么到"的六条路。

问：这个机制在多人场景下需要注意什么？
答：多人场景最大的变化是状态的所有权——单机模式里状态归模块管，多人模式里状态归属要明确到每个玩家。如果状态是共享的，要加锁或者排队；如果是独立的，要按玩家分开存储。这一步没想清楚，多人测试的时候就会出现串号、互踩、幽灵状态等一堆问题。

问：这类机制在热重载环境里最容易出什么问题？
答：最常见的是事件监听的重复注册——热重载重新执行模块顶层代码的时候，旧的监听还没解绑，新的监听又挂上去了，同一个事件触发两次回调。解法是在注册之前先解绑一次，或者用一个标记位记录是否已注册，第二次加载跳过注册。

问：如果要把这个机制移植到别的项目要注意什么？
答：注意框架接口的差异——框架前缀开头的接口是当前框架特有的，换一个框架这些接口全要换。解法是把框架接口集中在一个适配层里，业务逻辑只调适配层不直接调框架——换框架的时候只换适配层不改业务层，移植成本就降到了最低。

问：如果需求变了要加新功能，从哪里下手最安全？
答：从配置表下手最安全——加一个新字段不会影响已有的逻辑，只要在消费端加一个判断就能接通新功能。如果要在核心逻辑里加分支，先跑一遍回归测试确认旧功能没被改坏，再加新功能。

关于参数的调优顺序——先调影响最大的参数（通常是时长或频率），确认方向对了再调影响较小的参数（通常是数值或偏移）。调参的顺序反了会浪费大量时间在小参数上打转，大参数一动小参数全要重调。

关于参数的文档——每个参数都写一行注释说明它的物理含义、单位、典型值和调整方向，这四样写全了后来人接手才不会一头雾水。注释不是写给自己看的，是写给三个月后的自己看的——三个月后你不会记得零点五是秒还是毫秒，是越大越好还是越小越好。

关于测试的覆盖——一个模块至少要测三个边界：参数最大值、参数最小值、参数为零。最大值测会不会过冲，最小值测会不会失效，零值测会不会死循环。三个边界都跑通了，中间的正常值基本不会出问题。如果时间允许，再加一组异常值测试——负数、超大数、非数——看模块的鲁棒性。