山高月小,水落石出。

Godot Tween

Tween 是 Godot 中用于“在代码里顺手做一小段动画”的轻量级工具。它的核心用途很单纯:将一个属性从当前值平滑地插值到目标值,创建后自动运行,完成后自动释放,非常适合 UI 反馈、简单的位移/透明度变化、镜头震动这类“即用即弃”的动效。 🧱 先建立正确的心智模型 使用 Tween 时,有几个前置规则需要先刻在脑子里: ① 必须用 create_tween() 创建 Tween.new() 是无效的,不能用来做补间。正确的入口只有两个: 1 2 3 4 5 # 方式一:从节点创建,Tween 会绑定到该节点的生命周期 var tween = create_tween() # 方式二:从场景树创建,不绑定特定节点 var tween = get_tree().create_tween() ② Tween 本质上是一条“时间线” 你往这条时间线上添加的每一个 tween_property()、tween_callback()、tween_interval(),都是一个 Tweener。默认情况下,这些 Tweener 会按添加顺序一个接一个地串行执行。 ③ 默认是串行,set_parallel(true) 可以改为并行 这是控制 Tween 行为最关键的一个开关,后面会用具体示例展开。 ✂️ 核心 API:你只需要先掌握这几个 方法 作用 tween_property(object, property, final_val, duration) 最核心的方法,在 duration 秒内将 property 插值到 final_val tween_callback(callable) 在时间线的某个点执行一个函数 tween_interval(time) 在时间线上插入一段纯等待 set_parallel(true) 让后续的 Tweener 并行执行,而不是串行 chain() 从并行模式切回串行模式 set_loops(n) 设置循环次数,0 或不传参表示无限循环 set_ease() / set_trans() 控制缓动曲线(加速/减速的节奏) .from(value) 指定起始值,不依赖属性的当前值 .as_relative() 将目标值视为相对偏移量 🍳 常用可运行示例 以下示例均假设脚本挂在某个节点上,可以直接复制到 _ready() 或按钮回调中运行。 ...

November 4, 2026 · 3 min · zwdart