声明与发出

使用关键字 signal 和一个名称来声明信号，放在类顶部、变量旁边。信号名称用 snake_case 描述已经发生的事件，例如：died、door_opened、leveled_up。类可以根据需要声明任意数量的信号：

# player.gd
class_name Player
extends RefCounted

signal leveled_up
signal max_level_reached

const MAX_LEVEL := 3
var level := 1
var xp := 0

func add_xp(amount: int) -> void:
	xp += amount
	while xp >= 100 and level < MAX_LEVEL:
		xp -= 100
		level += 1
		leveled_up.emit()
		if level == MAX_LEVEL:
			max_level_reached.emit()

仅在事件发生的那一刻发出信号。对新玩家调用 add_xp(50) 不会发出任何信号。之后调用 add_xp(250)，使 xp 达到 300：leveled_up 会发出两次，每升一级发出一次；max_level_reached 会发出一次，在升到 3 级时发出。

属性设置器是发出信号的好地方，因为这样无论哪段代码更改了值，信号都会触发：

signal died

var hp: int = 10:
	set(value):
		var was_alive := hp > 0
		hp = maxi(value, 0)
		if was_alive and hp == 0:
			died.emit()

当生命值为 0 的英雄再次受到攻击时，was_alive 会防止再次发出 died。

也可以通过信号名称的文本形式访问信号：emit_signal("died") 会发出该信号，hero.connect("died", _on_hero_died) 会连接到该信号，而 hero.has_signal("died") 会返回 true。如果连接到对象未声明的信号名称，那么这行代码运行时会出错。