Se connecter aux signaux

connect() prend la fonction à exécuter, sous la forme d’un Callable. Indique un nom de méthode sans parenthèses, ou écris une fonction lambda :

chest.opened.connect(_on_chest_opened)          # une méthode de ce script
chest.opened.connect(quest_log.add_entry)       # une méthode d'un autre objet
chest.opened.connect(func(): print("Creak!"))   # une fonction lambda

Godot nomme une méthode d’écoute _on_, puis l’émetteur, puis le signal : _on_chest_opened. Un signal peut avoir plusieurs fonctions connectées, qui s’exécutent dans l’ordre où elles ont été connectées.

Un objet qui écoute se connecte généralement lui-même dans une méthode qui reçoit l’émetteur :

# quest_log.gd
class_name QuestLog
extends RefCounted

var chests_opened := 0

func track(chest: Chest) -> void:
	if not chest.opened.is_connected(_on_chest_opened):
		chest.opened.connect(_on_chest_opened)

func untrack(chest: Chest) -> void:
	if chest.opened.is_connected(_on_chest_opened):
		chest.opened.disconnect(_on_chest_opened)

func _on_chest_opened() -> void:
	chests_opened += 1

Connecter deux fois la même fonction au même signal est une erreur, tout comme déconnecter une fonction qui n’est pas connectée. is_connected() vérifie d’abord. disconnect() cesse l’écoute, et le prochain signal émis n’exécute plus cette fonction.

Transmets CONNECT_ONE_SHOT comme deuxième argument et la connexion se supprime après son premier appel : chest.opened.connect(_on_first_open, CONNECT_ONE_SHOT).

Une lambda conserve la valeur qu’avait une variable locale au moment de sa création. count += 1 dans une lambda connectée modifie cette copie, et count dans _ready() reste à 0. Conserve un compteur dans une variable membre d’un objet écouteur, comme le fait QuestLog.