游戏引擎 / 系统课时

动态加载 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 后可见。

ts
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 仍可能为真,本例仍会完成加载;需要“关闭面板就取消本次结果”的业务,应加请求代号或启用状态判断。重新请求不同角色图片时也要防止旧请求晚到覆盖新选择。资源加载失败、场景销毁、快速重复打开三种场景都要验证,不能只测试第一次成功路径。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

动态加载 Prefab 和图片

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通