Padrão Observer

O padrão Observer permite que um objeto, o sujeito, informe a muitos outros objetos, os observadores, que algo aconteceu. O sujeito não sabe o que os observadores fazem com a notícia; ele apenas a anuncia.

Escrito manualmente, o sujeito mantém um array de observadores e chama o mesmo método em cada um:

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

O Godot já tem esse padrão integrado. Um sinal é o anúncio do sujeito, e cada connect() adiciona um observador, então o array e o loop não são mais necessários:

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

Um observador é qualquer objeto que tenha um método cujos parâmetros correspondam ao sinal:

# 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 não faz ideia de que existe uma barra ou um registro. Um efeito sonoro ou uma conquista também pode escutar, sem que seja necessária uma única alteração em health.gd.

Três regras mantêm os observadores funcionando:

• Conectar o mesmo método duas vezes é um erro. Quando isso puder acontecer, verifique primeiro com hp_changed.is_connected(bar.on_hp_changed). disconnect() remove um observador, e desconectar um que não está conectado também é um erro.
• Uma conexão não mantém o observador vivo. Mantenha o observador em uma variável ou em um array: um objeto criado dentro da chamada connect() é liberado imediatamente e nunca recebe o sinal.
• Conecte métodos dos observadores. Uma lambda que usa o sujeito e é conectada ao próprio sinal do sujeito mantém o sujeito vivo para sempre, o que Godot informa como um vazamento quando o jogo é fechado.