التصريح والإطلاق

أعلِن عن إشارة باستخدام الكلمة المفتاحية 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()

يمنع was_alive إصدار died مرة أخرى عندما يُصاب بطل لديه 0 من نقاط الصحة مجددًا.

يمكن أيضًا الوصول إلى الإشارة من خلال اسمها كنص: يصدرها emit_signal("died")، ويربط بها hero.connect("died", _on_hero_died)، ويُرجع hero.has_signal("died") القيمة true. ويُعدّ الربط باسم لا يعرّفه الكائن خطأً عند تنفيذ ذلك السطر.