Was ist ein Signal?

Während ein Spiel läuft, passieren Dinge mit Objekten: Eine Münze wird eingesammelt, eine Tür öffnet sich, die hp des Helden sinkt auf 0. Andere Teile des Programms reagieren auf diese Ereignisse: Der Punktestand steigt, ein Ton erklingt, der Game-Over-Bildschirm erscheint.

Ein Signal ist eine Nachricht, die ein Objekt sendet, wenn etwas mit ihm geschieht. Das Objekt sendet das Signal aus, und jede mit diesem Signal verbundene Funktion wird ausgeführt:

# coin.gd
class_name Coin
extends RefCounted

signal collected

func collect() -> void:
	print("Coin picked up")
	collected.emit()

signal collected deklariert das Signal und collected.emit() sendet es. Die Münze weiß nicht, wer zuhört. Der Code, der sich für Münzen interessiert, verbindet eine seiner eigenen Funktionen mit dem Signal:

# main.gd
func _ready():
	var coin := Coin.new()
	coin.collected.connect(_on_coin_collected)
	coin.collect()
	print("Done")

func _on_coin_collected() -> void:
	print("Score +1")

Die Ausgabe lautet Coin picked up, Score +1, Done. Beim Auslösen werden die verbundenen Funktionen sofort ausgeführt, bevor die Zeile nach emit() ausgeführt wird. Ein Signal ohne verbundene Funktionen bewirkt beim Auslösen nichts.

Ohne ein Signal müsste collect() den Code für die Punktzahl selbst aufrufen, sodass jede Münze eine Referenz auf die Punktetafel bräuchte. Mit einem Signal kündigt die Münze nur das Ereignis an, und beliebig viele Listener oder auch gar keiner können darauf reagieren.

Godots eigene Knoten funktionieren genauso: Ein Button löst pressed aus, wenn er angeklickt wird, und ein Timer löst timeout aus, wenn seine Zeit abläuft.