RefCounted và Node

Mỗi đối tượng chiếm bộ nhớ cho đến khi được giải phóng. RefCounted và Node được giải phóng theo những cách khác nhau.

Đối tượng RefCounted đếm số biến, mảng và đối tượng tham chiếu đến nó. Khi số đếm giảm về 0, Godot tự giải phóng đối tượng đó. NOTIFICATION_PREDELETE, trong chương Phương thức đặc biệt, cho thấy thời điểm đó:

# note.gd
class_name Note
extends RefCounted

func _notification(what: int) -> void:
	if what == NOTIFICATION_PREDELETE:
		print("Note freed")

# main.gd
func write() -> void:
	var note := Note.new()
	print("Note written")

func _ready():
	write()          # Note written, sau đó Note freed
	print("Back in _ready")

note là tham chiếu duy nhất, nên ghi chú sẽ được giải phóng ngay khi write() kết thúc.

Node không được tính. Một nút trong cây cảnh sẽ được giải phóng cùng với nút cha, và toàn bộ cây sẽ được giải phóng khi trò chơi kết thúc. Bạn phải tự giải phóng nút mà bạn đưa ra khỏi cây hoặc không bao giờ thêm vào cây:

crate.free()         # Giải phóng ngay cùng với tất cả nút con
crate.queue_free()   # Giải phóng vào cuối khung hình hiện tại

Sau khi gọi free(), nút không còn tồn tại: is_instance_valid(crate) trả về false, và gọi phương thức trên nút đó sẽ gây ra lỗi. queue_free() là lựa chọn an toàn khi code khác vẫn có thể dùng nút đó trong khung hình này, nhưng nút vẫn nằm trong cây và vẫn được tính trong get_child_count() cho đến khi khung hình kết thúc.

Một nút không bao giờ được giải phóng sẽ gây ra rò rỉ bộ nhớ: Godot báo cáo "ObjectDB instances were leaked at exit" khi chương trình kết thúc. Các đối tượng RefCounted cũng bị rò rỉ khi chúng tham chiếu lẫn nhau, vì bộ đếm của cả hai không thể giảm về 0. Chỉ lưu liên kết theo một chiều, hoặc lưu tên thay vì đối tượng.

Dùng RefCounted cho dữ liệu: vật phẩm, điểm số, bản ghi. Dùng Node cho những thứ nằm trong cây cảnh.