Mẫu Observer

Mẫu Observer cho phép một đối tượng, gọi là chủ thể, thông báo cho nhiều đối tượng khác, gọi là các đối tượng quan sát, rằng có điều gì đó đã xảy ra. Chủ thể không biết các đối tượng quan sát sẽ làm gì với thông tin đó; nó chỉ thông báo.

Viết thủ công, đối tượng giữ một mảng các bên theo dõi và gọi cùng một phương thức trên từng bên:

# 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 tích hợp sẵn mẫu này. Tín hiệu là thông báo của đối tượng phát đi, còn mỗi lần gọi connect() sẽ thêm một đối tượng quan sát, nên bạn không cần mảng và vòng lặp nữa:

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

Một đối tượng lắng nghe là bất kỳ đối tượng nào có phương thức với các tham số khớp với tín hiệu:

# 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 không biết thanh trạng thái hay nhật ký có tồn tại. Hiệu ứng âm thanh hoặc thành tích cũng có thể lắng nghe mà không cần thay đổi health.gd.

Có ba quy tắc giúp các observer hoạt động ổn định:

• Kết nối cùng một phương thức hai lần sẽ gây ra lỗi. Nếu có thể xảy ra tình huống này, hãy kiểm tra trước bằng hp_changed.is_connected(bar.on_hp_changed). disconnect() xóa một observer, và ngắt kết nối một observer chưa được kết nối cũng gây ra lỗi.
• Kết nối không giữ cho observer tồn tại. Hãy giữ observer trong một biến hoặc một mảng: đối tượng được tạo bên trong lệnh gọi connect() sẽ bị giải phóng ngay lập tức và không bao giờ nhận được tín hiệu.
• Hãy kết nối các phương thức của observer. Một lambda sử dụng đối tượng phát tín hiệu và được kết nối với chính tín hiệu của đối tượng đó sẽ khiến đối tượng phát tín hiệu tồn tại mãi mãi. Godot sẽ báo đây là một rò rỉ khi trò chơi đóng.