Khai báo và phát tín hiệu

Khai báo tín hiệu bằng từ khóa signal và một tên ở đầu lớp, bên cạnh các biến. Tên tín hiệu mô tả một sự kiện đã xảy ra, theo định dạng snake_case: died, door_opened, leveled_up. Một lớp (class) khai báo số tín hiệu tùy theo nhu cầu:

# 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()

Phát tín hiệu đúng lúc sự kiện xảy ra, và chỉ vào lúc đó. add_xp(50) trên người chơi mới không phát ra tín hiệu nào. add_xp(250) sau đó đưa xp lên 300: leveled_up được phát ra hai lần, mỗi lần ứng với một cấp độ tăng, còn max_level_reached được phát ra một lần, khi tăng cấp lên cấp 3.

Bộ thiết lập thuộc tính là nơi thích hợp để phát tín hiệu, vì tín hiệu sẽ kích hoạt bất cứ khi nào có đoạn code thay đổi giá trị:

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()

was_alive ngăn died được phát ra lần nữa khi một anh hùng có 0 HP bị đánh thêm lần nữa.

Bạn cũng có thể truy cập một tín hiệu bằng tên dưới dạng văn bản: emit_signal("died") phát tín hiệu đó, hero.connect("died", _on_hero_died) kết nối với tín hiệu đó và hero.has_signal("died") trả về true. Nếu kết nối với tên mà đối tượng không khai báo, dòng đó sẽ gây lỗi khi chạy.