Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

SceneTreeTimer

继承： RefCounted < Object

一次性定时器。

描述

由场景树管理的一次性计时器，会在完成时发出 timeout。另见 SceneTree.create_timer。

与 Timer 不同，它不需要实例化节点。常用于创建一次性的延迟计时器，如下面的例子所示：

GDScriptC#

func some_function():
    print("计时开始。")
    await get_tree().create_timer(1.0).timeout
    print("计时结束。")

达到时间后，会释放对该计时器的引用。如果要保留该计时器，你可以保持对它的引用。见 RefCounted。

注意：对计时器的处理发生在当前帧的所有节点节后，即节点的 Node._process 方法是在计时器之前调用的（如果 SceneTree.create_timer 的 process_in_physics 为 true则为 Node._physics_process）。

属性

float

time_left

---

信号

timeout() 🔗

当计时器到 0 时发出。

---

属性说明

float time_left 🔗

• void set_time_left(value: float)

• float get_time_left()

剩余时间（单位为秒）。