Patrón Observer

El patrón Observer permite que un objeto, el sujeto, les comunique a muchos otros objetos, los observadores, que ha ocurrido algo. El sujeto no sabe qué hacen los observadores con la noticia; solo la anuncia.

Escrito manualmente, el sujeto mantiene un arreglo de observadores y llama al mismo método en cada uno:

# health.gd
class_name Health
extends RefCounted

var observers: Array = []
var hp := 100

func add_observer(observer) -> void:
	observers.append(observer)

func take_damage(amount: int) -> void:
	hp -= amount
	for observer in observers:
		observer.on_hp_changed(hp)

Godot ya incluye este patrón. Una señal es el anuncio del sujeto, y cada connect() añade un observador, así que ya no se necesitan el array ni el bucle:

# health.gd
class_name Health
extends RefCounted

signal hp_changed(new_hp: int)

var hp := 100

func take_damage(amount: int) -> void:
	hp -= amount
	hp_changed.emit(hp)

Un observador es cualquier objeto con un método cuyos parámetros coinciden con la señal:

# health_bar.gd
class_name HealthBar
extends RefCounted

func on_hp_changed(new_hp: int) -> void:
	print("Bar: ", new_hp, "/100")

# damage_log.gd
class_name DamageLog
extends RefCounted

func on_hp_changed(new_hp: int) -> void:
	if new_hp < 50:
		print("Log: low health!")

# main.gd
var health := Health.new()
var bar := HealthBar.new()
var damage_log := DamageLog.new()
health.hp_changed.connect(bar.on_hp_changed)
health.hp_changed.connect(damage_log.on_hp_changed)
health.take_damage(70)

Bar: 30/100
Log: low health!

Health no tiene ni idea de que existe una barra o un registro. Un efecto de sonido o un logro también pueden escuchar, sin cambiar ni una sola cosa en health.gd.

Tres reglas hacen que los observadores sigan funcionando:

• Conectar el mismo método dos veces es un error. Cuando pueda ocurrir, compruébalo primero con hp_changed.is_connected(bar.on_hp_changed). disconnect() elimina un observador, y desconectar uno que no está conectado también es un error.
• Una conexión no mantiene vivo al observador. Guarda el observador en una variable o en un arreglo: un objeto creado dentro de la llamada a connect() se libera de inmediato y nunca recibe la señal.
• Conecta métodos de los observadores. Una lambda que usa el sujeto y está conectada a la propia señal del sujeto lo mantiene vivo para siempre, lo que Godot informa como una fuga cuando se cierra el juego.