游戏引擎 / 系统课时
动态加载 Prefab 和图片
动态加载 Prefab 和图片
异步加载可能在界面关闭以后才返回,加载成功也不等于资源已经展示。本节分别加载 Prefab 与 SpriteFrame,完成实例化和绑定,并给脚本主动持有的资源建立引用释放责任。
学习目标
- 按指定类型加载资源与子资源
- 在回调中检查消费对象是否有效
- 成对管理脚本持有的资源引用
为两个资源准备不同出口
准备 assets/resources/prefabs/Enemy.prefab 和 assets/resources/textures/Coin.png,确认后者导入为可用 SpriteFrame。在 Canvas 下创建空节点 SpawnRoot,另建可见 Sprite 节点 Icon。Prefab 用 instantiate 创建节点,再加入 SpawnRoot;SpriteFrame 则绑定到现有 Sprite,不需要当成节点实例化。

加载完成前可以显示占位状态,失败后给出重试入口。不能在发出 load 后立刻使用尚未返回的变量;两个加载的完成顺序也没有保证。本节两条路径独立,任意一条失败都会报告对应错误。
在回调中接入对象
保存为 AsyncAssets.ts 并挂到 SpawnRoot,将 Icon 的 Sprite 绑定到 icon。Prefab 的节点位置预先设为原点附近,保证加入 Canvas 后可见。
import { _decorator, Component, resources, Prefab, SpriteFrame, Sprite, instantiate, Asset } from 'cc';
const { ccclass, property } = _decorator;
@ccclass('AsyncAssets')
export class AsyncAssets extends Component {
@property(Sprite) icon: Sprite | null = null;
private owned: Asset[] = [];
start(): void {
resources.load('prefabs/Enemy', Prefab, (error, prefab) => {
if (error) { console.error('prefab-load-failed', error.message); return; }
if (!this.isValid) return;
prefab.addRef(); // 本组件明确持有资源
this.owned.push(prefab);
const enemy = instantiate(prefab);
this.node.addChild(enemy);
enemy.setPosition(0, 0, 0);
console.log('enemy-created');
});
resources.load('textures/Coin/spriteFrame', SpriteFrame, (error, frame) => {
if (error) { console.error('image-load-failed', error.message); return; }
if (!this.isValid || !this.icon?.isValid) return;
frame.addRef();
this.owned.push(frame);
this.icon.spriteFrame = frame;
console.log('icon-bound');
});
}
onDestroy(): void {
for (const asset of this.owned) asset.decRef();
this.owned.length = 0;
}
}预期结果:SpawnRoot 下出现一个 Enemy 实例,Icon 显示金币图片,日志含 enemy-created 与 icon-bound,两者先后顺序不作要求。场景在回调前退出时不再创建节点或修改已经销毁的 Sprite。
让缓存与生命周期有明确责任
load 会经过引擎资源管理与缓存,不能把每次调用都理解为重新下载文件。这里的 addRef/decRef 只管理本组件主动持有的引用;不要强制 releaseAsset 删除仍被其他界面或实例使用的共享资源。已有消费者的引用关系同样需要正确管理。
若组件停用但未销毁,isValid 仍可能为真,本例仍会完成加载;需要“关闭面板就取消本次结果”的业务,应加请求代号或启用状态判断。重新请求不同角色图片时也要防止旧请求晚到覆盖新选择。资源加载失败、场景销毁、快速重复打开三种场景都要验证,不能只测试第一次成功路径。