【前端接口】GUI:ActionMoveTo 与 runAction：控件动画的动作系统

实战应用：用在哪里

控件会动才有生命：GUI:ActionMoveTo、ActionFadeIn、ActionScaleTo 等动作家族配合 runAction 让控件位移、淡入、缩放。飘字的飞出、弹窗的弹入、图标的跳动，前端动画的表现力全部来自这套动作系统。

动作的创建与执行

---移动动作 duration:秒 x/y:目标坐标
function GUI:ActionMoveTo(duration, x, y) end

-- 飘字三拍子：出现、上飞、淡出
local function floatDamage(parent, x, y, dmg)
    local txt = GUI:Text_Create(parent, "dmg", x, y, 18, "#FF6600", "-" .. dmg)
    local fly = GUI:ActionMoveTo(0.6, x, y - 50)
    local fade = GUI:ActionFadeOut(0.3)
    txt:runAction(fly)
    txt:runAction(fade)
end

动作家族按效果分类：Move 系管位移、Fade 系管透明度、Scale 系管缩放、Rotate 系管旋转，每个动作的构造参数带时长与目标值。runAction 把动作挂到控件上执行，动作执行完自动结束。动作的组合：ActionSequence 串联多个动作、ActionSpawn 并联同时播放、ActionRepeat 循环，组合器让复杂动画（先弹入再摇摆再淡出）在一个动作编排里完成。

缓动与节奏

-- 缓动弹窗：弹性缩放入场
local popIn = GUI:ActionEaseBackIn(GUI:ActionScaleTo(0.35, 1.0))
popWin:runAction(popIn)
-- 动作回调：动画结束后发消息
local withEnd = GUI:ActionSequence(GUI:ActionMoveTo(0.5, 400, 300), GUI:ActionFadeOut(0.4))

缓动系列（EaseBack、EaseBounce、EaseElastic）给动作加物理感的节奏：弹窗的回弹入场、奖励图标的弹性缩放，缓动是动画高级感的一半。动作完成的事件回调让动画与逻辑衔接：动画播完再发协议、动画结束再销毁控件，表现与逻辑的时序用动作回调对齐。stopActionByTag 与 stopAllActions 的停止接口处理动画的中断场景。

验证与监控

同屏并行动作的数量监控，动作堆积的界面在低端机的帧率崩塌最明显。

踩坑记录

动作的目标坐标曾经用了控件父坐标系与世界坐标系的混用，convertToNodeSpace 的坐标转换是跨坐标系动画的必经步骤。动作执行中控件被销毁曾经引发空引用报错，控件销毁时 stopAllActions 的清理配对是生命周期的纪律。

上线要点

动画的时长规范：反馈类动画 0.2 到 0.4 秒、转场类 0.5 秒内，动画的克制是品质感的前提。动作的复用：相同的飘字动画封装成函数，动画的参数化让调用方一行代码获得标准动效。动画与 reduced-motion 的可访问性考虑：系统开启减弱动态时动画的降级开关预留。