可覆盖函数

Godot 的 Node 类提供了虚函数，你可以通过覆盖虚函数来在每帧或发生特定事件时更新节点，比如进入场景树时。

本文档中会展示你会经常用到的那些。

参见

这些函数在引擎内部会依赖 Godot 的底层通知系统。要了解相关学习，请参阅 Godot 通知。

除了类的构造函数之外，还有两个函数可以用来初始化并获取节点：_enter_tree() 和 _ready()。

节点进入场景树时就会被激活，引擎会调用其 _enter_tree() 方法。该节点的子项可能还不是活动场景的一部分。因为你可以从场景树中移除节点然后重新添加，在一个节点的生命期中，这个函数可能会被调用多次。

你在大多数时候用的其实是 _ready()。这个函数只会在节点的生命期中被调用一次，在 _enter_tree() 之后。_ready() 可以保证所有子项都已经进入了场景树，所以你可以安全地去调用 get_node()。

参见

要学习更多关于节点引用的知识，请阅读 节点与场景实例。

另一个有关的回调是 _exit_tree()，引擎会在节点退出场景树时调用。既可以是你调用 Node.remove_child() 时，也可以是你释放这个节点时。

GDScriptC#

  1. # Called every time the node enters the scene tree.
  2. func _enter_tree():
  3.     pass
  5. # Called when both the node and its children have entered the scene tree.
  6. func _ready():
  7.     pass
  9. # Called when the node is about to leave the scene tree, after all its
  10. # children received the _exit_tree() callback.
  11. func _exit_tree():
  12.     pass
  1. // Called every time the node enters the scene tree.
  2. public override void _EnterTree()
  3. {
  4.     base._EnterTree();
  5. }
  7. // Called when both the node and its children have entered the scene tree.
  8. public override void _Ready()
  9. {
  10.     base._Ready();
  11. }
  13. // Called when the node is about to leave the scene tree, after all its
  14. // children.
  15. public override void _ExitTree()
  16. {
  17.     base._ExitTree();
  18. }

虚函数 _process() 和 _physics_process() 可以分别用来对节点进行每帧和每物理帧的更新。要了解更多信息，请阅读专门的文档：空闲处理与物理处理。

GDScriptC#

  1. # Called every frame, as often as possible.
  2. func _process(delta):
  3.     pass
  5. # Called every physics frame.
  6. func _physics_process(delta):
  7.     pass
  1. public override void _Process(float delta)
  2. {
  3.     // Called every frame, as often as possible.
  4.     base._Process(delta);
  5. }
  7. public override void _PhysicsProcess(float delta)
  8. {
  9.     // Called every physics frame.
  10.     base._PhysicsProcess(delta);
  11. }

还有两个关键的内置节点回调函数 Node._input() 和 Node._unhandled_input()。两者都可以用来接收并处理单独的输入事件。如果按键、鼠标点击等事件没有被 _input() 回调或用户界面组件处理，_unhandled_input() 方法才会收到这个事件。游戏中的输入通常是使用后者处理的。_input() 回调可以用来在 _unhandled_input() 获取前拦截并处理输入事件。

要学习更多关于 Godot 中输入的内容，请参阅输入章节。

GDScriptC#

  1. # Called once for every event.
  2. func _unhandled_input(event):
  3.     pass
  5. # Called once for every event, before _unhandled_input(), allowing you to
  6. # consume some events.
  7. func _input(event):
  8.     pass
  1. // Called once for every event.
  2. public override void _UnhandledInput(InputEvent @event)
  3. {
  4.     base._UnhandledInput(event);
  5. }
  7. // Called once for every event, before _unhandled_input(), allowing you to
  8. // consume some events.
  9. public override void _Input(InputEvent @event)
  10. {
  11.     base._Input(event);
  12. }

还有 Node._get_configuration_warning() 等更多的可覆盖函数。特定的节点类型也会提供很多回调，比如 CanvasItem._draw() 可以用程序来绘图，Control._gui_input() 可以处理 UI 元素上的点击和输入。