游戏引擎 / 系统课时
避免一次加载整张地图
避免一次加载整张地图
大型地图同时加载会造成启动等待和内存峰值,异步读取也不能自动消除实例化卡顿。本课把区域拆成独立资源,用后台加载接口请求资源,再在主线程实例化,并为失败和过期请求设计处理规则。
学习目标
- 能区分后台资源加载与主线程场景实例化
- 能为区域加载设计超时、切换和回收策略
先拆出独立的加载单元
将地图划成能单独保存与引用的区域场景,主场景只保留入口、玩家和区域管理器。不要在主场景内嵌所有区块再期望运行时隐藏就减少加载;依赖关系可能仍使全部资源提前进入内存。用轻量标识记录路径,按进入邻近范围发起加载。
确定预取范围与卸载范围,使用不同边界避免在边缘来回走时反复装卸。区块包含导航、碰撞和任务数据时,还要规定什么时候可以进入。视觉出现不等于玩法依赖已准备好;需要等待的情况应有明确加载提示和输入规则。
并发请求数与活跃区块数都要限制。移动很快时不应为经过的每个区块永久保留资源。给请求附上当前区域或世代编号,完成后检查仍然需要,过期结果不得加入新场景;后台接口没有简单的通用取消操作,仍需管理完成结果与引用。
在完成状态之后取资源
先保存 chunk.tscn,这是可独立加载的最小场景资源。
[gd_scene format=3]
[node name="Chunk" type="Node2D"]再保存完整入口 stream.gd,执行 godot --headless --path . --script stream.gd。本例只请求一个区域,并在五秒内失败退出,避免永远等待。
extends SceneTree
const CHUNK := "res://chunk.tscn"
func _initialize() -> void:
call_deferred("load_chunk")
func load_chunk() -> void:
var error := ResourceLoader.load_threaded_request(CHUNK, "PackedScene")
if error != OK:
push_error("request failed: %s" % error)
quit(1)
return
var deadline := Time.get_ticks_msec() + 5000
while true:
var status := ResourceLoader.load_threaded_get_status(CHUNK)
if status == ResourceLoader.THREAD_LOAD_LOADED:
break
if status == ResourceLoader.THREAD_LOAD_FAILED or status == ResourceLoader.THREAD_LOAD_INVALID_RESOURCE:
push_error("chunk load failed")
quit(1)
return
if Time.get_ticks_msec() >= deadline:
push_error("chunk load timeout")
quit(1)
return
await process_frame # 主线程继续更新,不忙等也不提前阻塞取结果。
var packed := ResourceLoader.load_threaded_get(CHUNK) as PackedScene
if packed == null:
quit(1)
return
var chunk := packed.instantiate() # 在主线程接入活动场景树。
root.add_child(chunk)
print("loaded=", chunk.name)
chunk.queue_free()
await process_frame
quit()预期输出(省略启动横幅):
loaded=Chunkload_threaded_get 在资源未完成时可能阻塞,必须先检查状态。后台加载负责资源读取,不意味着 instantiate、脚本初始化、物理注册与添加节点没有开销。活动场景树不是线程安全的,不要把这段实例化直接搬到自己创建的线程里。

拆开加载与激活的峰值
测量资源完成到画面可用之间的时间,检查 _ready、子场景创建和物理注册。如果实例化仍造成长帧,进一步缩小区块,或把允许延迟的初始化分批执行。不要只看到后台线程在工作就宣布无卡顿;首次材质出现还可能触发另一类成本。
切换时只保留需要的旧区块。先取消它的业务注册与请求归属,再 queue_free,之后清理不再需要的 PackedScene 引用。快速前进再后退,测试预取、过期完成和边界抖动;检查不会重复加入同一区块或生成两套碰撞。
预取还会扩大旧区块、新区块与临时数据的重叠峰值。为加载队列设内存预算,优先处理玩家马上进入的区域;内存不足时停止远处预取,不能只限制显示中的块数。区域依赖的大纹理是否共享也需要清单核对。
不要把所有区块放进脚本的 preload 常量数组,这会使资源在请求前就被脚本持有。使用路径清单与显式状态表,并为每个状态记录资源、实例和归属编号,退出关卡时一起清理。
以失败路径验证管理器
将资源路径改为不存在的文件、故意延迟激活,并在加载时切换关卡,确认出现明确错误或保留旧区域。实际游戏不能在失败后让玩家进入没有地面的空间。成功、失败与过期完成都应有记录,计时数字必须从目标设备采集。
接口与阻塞边界见 Background loading,线程范围见 Thread-safe APIs。