游戏引擎 / 系统课时
场景通信串起拾取和界面反馈
场景通信串起拾取和界面反馈
这一节用一个可运行的双关卡样例检验场景解耦:角色碰到道具,道具发出拾取信号,关卡协调器计算得分,再刷新常驻 HUD。切换关卡时重新装配对象并释放旧节点,最后用高分宝石替换普通道具,确认无需修改角色和界面。
学习目标
- 用信号把道具拾取、计分规则与界面显示分开。
- 在两次关卡切换后验证信号绑定、旧节点释放和分数重置。
- 通过替换道具奖励检查场景装配的扩展边界。
明确对象职责和信号方向
角色 Hero 只负责移动与碰撞;Pickup 只判断是否碰到玩家,并发出 picked(points);关卡协调器负责订阅当前道具、累计分数;常驻 CanvasLayer 只显示结果。LevelRuntime 是可整体替换的关卡子树,HUD 不放进去,避免每次切关重复创建界面。

运行最小双关卡样例
在 Godot 4 新建根节点为 Node2D 的场景,附加以下 main.gd 并设为主场景。脚本动态创建角色、道具碰撞体和按钮,不依赖外部贴图;方向键使用项目默认的 ui_left 等输入动作。
extends Node2D
class Hero extends CharacterBody2D:
func _ready() -> void:
motion_mode = MOTION_MODE_FLOATING
collision_layer = 1
collision_mask = 0
var hitbox := CollisionShape2D.new()
var circle := CircleShape2D.new()
circle.radius = 12.0
hitbox.shape = circle
add_child(hitbox)
var marker := Polygon2D.new()
marker.polygon = PackedVector2Array([
Vector2(0, -14), Vector2(12, 10), Vector2(-12, 10)
])
marker.color = Color(0.15, 0.50, 0.85)
add_child(marker)
func _physics_process(_delta: float) -> void:
velocity = Input.get_vector(
"ui_left", "ui_right", "ui_up", "ui_down"
) * 180.0
move_and_slide()
class Pickup extends Area2D:
signal picked(points: int)
var reward: int
func _init(points: int) -> void:
reward = points
func _ready() -> void:
collision_layer = 0
collision_mask = 1
var hitbox := CollisionShape2D.new()
var circle := CircleShape2D.new()
circle.radius = 14.0
hitbox.shape = circle
add_child(hitbox)
var marker := Polygon2D.new()
marker.polygon = PackedVector2Array([
Vector2(-12, -12), Vector2(12, -12),
Vector2(12, 12), Vector2(-12, 12)
])
marker.color = Color(0.1, 0.75, 0.62) if reward == 1 else Color(1.0, 0.58, 0.2)
add_child(marker)
body_entered.connect(_on_body_entered)
func _on_body_entered(body: Node2D) -> void:
if body.is_in_group("player") and not is_queued_for_deletion():
picked.emit(reward)
queue_free() # 先发出事件,再在帧末销毁道具
var level_root: Node2D
var hud: Label
var level_index := 0
var score := 0
func _ready() -> void:
var overlay := CanvasLayer.new()
add_child(overlay)
var panel := VBoxContainer.new()
overlay.add_child(panel)
hud = Label.new()
panel.add_child(hud)
var button := Button.new()
button.text = "切换关卡"
panel.add_child(button)
button.pressed.connect(_next_level)
_open_level(0)
func _next_level() -> void:
_open_level((level_index + 1) % 2)
func _open_level(index: int) -> void:
if is_instance_valid(level_root):
remove_child(level_root) # 立即停止旧关卡参与场景树更新
level_root.queue_free()
level_index = index
score = 0
level_root = Node2D.new()
level_root.name = "LevelRuntime"
add_child(level_root)
var hero := Hero.new()
hero.position = Vector2(120, 220)
hero.add_to_group("player")
level_root.add_child(hero)
var rewards := [1, 1] if index == 0 else [1, 5]
for i in range(rewards.size()):
var item := Pickup.new(rewards[i])
item.position = Vector2(220 + i * 100, 220)
item.picked.connect(_on_picked) # 仅装配当前关卡的信号
level_root.add_child(item)
_refresh_hud()
func _on_picked(amount: int) -> void:
score += amount
_refresh_hud()
func _refresh_hud() -> void:
hud.text = "关卡 %d 分数 %d" % [level_index + 1, score]预期结果:启动后左上方显示“关卡 1 分数 0”,方向键向右触碰两枚道具后分数依次为 1、2;点击“切换关卡”显示“关卡 2 分数 0”,再收集两枚道具,分数依次为 1、6。两关角色都是蓝色三角形,普通道具为绿色方块,高分宝石为橙色方块。
验证切关和扩展边界
重复切换两关,并检查旧道具不会再次加分。示例先 remove_child() 让旧关卡立即退树,再 queue_free() 在帧末释放;信号发送者随道具销毁,其连接也随之失效。不要把上一关的玩家或道具缓存到 HUD,更不要在 queue_free() 后继续访问它们。
本例故意按关卡重置 score。若游戏要求跨关保留总分,应把总分状态放在更长寿的会话对象中,而不是偷偷依赖旧关卡节点。把第二关的奖励 [1, 5] 改成 [1, 10],只应改变第二次拾取的分值;角色、信号名称和 HUD 脚本都不需要修改。正式项目可把 Hero、Pickup 和 HUD 分别保存为 PackedScene,沿用相同装配关系。