Pola Observer

Pola Observer memungkinkan satu object, yaitu subject, memberi tahu banyak object lain, yaitu observer, bahwa sesuatu telah terjadi. Subject tidak mengetahui apa yang dilakukan observer dengan informasi tersebut; subject hanya mengumumkannya.

Jika ditulis secara manual, subjek menyimpan array observer dan memanggil method yang sama pada setiap observer:

# 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 sudah memiliki pola ini. Sinyal adalah pengumuman dari subjek, dan setiap connect() menambahkan pengamat, sehingga array dan perulangan tidak lagi diperlukan:

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

Observer adalah object apa pun yang memiliki method dengan parameter yang cocok dengan sinyal:

# 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 tidak tahu bahwa bar atau log ada. Efek suara atau pencapaian juga bisa mendengarkan, tanpa mengubah health.gd sedikit pun.

Tiga aturan menjaga pengamat tetap berfungsi:

• Menghubungkan method yang sama dua kali akan menyebabkan error. Jika hal itu mungkin terjadi, periksa terlebih dahulu dengan hp_changed.is_connected(bar.on_hp_changed). disconnect() menghapus pengamat, dan memutuskan koneksi yang belum terhubung juga menyebabkan error.
• Koneksi tidak membuat pengamat tetap hidup. Simpan pengamat dalam variabel atau array: object yang dibuat di dalam pemanggilan connect() langsung dibebaskan dan tidak akan pernah menerima sinyal.
• Hubungkan method milik pengamat. Lambda yang menggunakan subjek dan terhubung ke sinyal milik subjek sendiri akan membuat subjek tetap hidup selamanya, yang dilaporkan Godot sebagai kebocoran saat game ditutup.