Déclarer et émettre

Déclare un signal avec le mot-clé signal et un nom, en haut de la classe, à côté de ses variables. Le nom d’un signal décrit un événement qui s’est déjà produit, en snake_case : died, door_opened, leveled_up. Une classe déclare autant de signaux qu’elle en a besoin :

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

Émettez un signal au moment où l’événement correspondant se produit, et uniquement à ce moment-là. add_xp(50) sur un nouveau joueur n’émet rien. add_xp(250) après que cela a porté xp à 300 : leveled_up est émis deux fois, une fois par niveau gagné, et max_level_reached une fois, lors de la montée de niveau qui atteint le niveau 3.

Un accesseur de propriété est un bon endroit pour émettre un signal, car celui-ci se déclenche alors quel que soit le code qui modifie la valeur :

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 empêche died d’être émis à nouveau lorsqu’un héros ayant 0 PV est touché une fois de plus.

On peut aussi accéder à un signal par son nom sous forme de texte : emit_signal("died") l’émet, hero.connect("died", _on_hero_died) s’y connecte, et hero.has_signal("died") renvoie true. Se connecter à un nom que l’objet ne déclare pas provoque une erreur lorsque cette ligne s’exécute.