游戏引擎 / 系统课时

用资源目录管理游戏素材

用资源目录管理游戏素材

资源能在编辑器中看到,不代表运行时可以用任意文件路径加载。本节建立小型 resources 目录,明确运行时资源键、静态引用和打包范围,避免把整个素材库都变成动态加载入口。

学习目标

  • 区分工程文件路径与 resources 加载键
  • 按静态引用和动态需求组织素材
  • 保留资源与 meta 文件的关联

按加载方式安排目录

固定场景需要的背景和 UI 图片,优先通过属性检查器直接绑定,依赖关系清晰,也便于构建分析。运行时按类型或关卡选择的 Prefab,可以放入 assets/resources/prefabs。本例保存 Enemy.prefab,其运行时键为 prefabs/Enemy,不含 assets/resources/ 前缀和扩展名。

图片 assets/resources/textures/Coin.png 可通过对应子资源键 textures/Coin/spriteFrame 加载 SpriteFrame;要先确认资源导入类型和实际子资源。把 PNG 路径直接当成 SpriteFrame 键,可能加载到不同类型或失败。大小写应与工程一致,Windows 上未暴露的问题可能在目标环境出现。

验证一个明确的资源键

将一个含 Sprite 的 Enemy 节点拖到 resources/prefabs 生成 Prefab,确认编辑器资源名称是 Enemy。保存 ResourcePathProbe.ts,挂到激活节点。示例只加载并打印资源名,不创建实例,也不要求场景中已有 Enemy。

ts
import { _decorator, Component, resources, Prefab } from 'cc';
const { ccclass } = _decorator;

@ccclass('ResourcePathProbe')
export class ResourcePathProbe extends Component {
    start(): void {
        const key = 'prefabs/Enemy'; // 相对 resources,省略扩展名
        resources.load(key, Prefab, (error, prefab) => {
            if (error) {
                console.error('resource-failed:' + key, error.message);
                return;
            }
            if (!this.isValid) return; // 场景已退出则不继续消费
            console.log('prefab:' + prefab.name);
        });
    }
}

预期结果:控制台出现 prefab:Enemy。若没有该资源,明确出现 resource-failed:prefabs/Enemy,而不是静默返回一个假对象。资源加载成功不代表实例已加入节点树,显示验证留给下一步实例化。

控制打包与引用范围

resources 是运行时可寻址入口,放入其中的内容会影响构建收录与资源元数据规模。不要把所有美术源文件、备用大图或测试资源无差别放入。规模增长时可按关卡或功能使用 Asset Bundle,并为每个 bundle 明确加载与释放责任。

移动和重命名素材时优先使用编辑器并保留关联 meta。版本控制应同时记录资源与 meta,不能只提交图片而丢失 UUID 关系。不要把 library、临时构建缓存当成源资源复制到项目中。

建立一张小型资源清单,记录键、类型、所属关卡和拥有者。发布前在构建产物中走一遍真正的动态加载路径,确认大小写、分包与远程配置没有改变键的含义。官方动态加载说明 可用于核对 resources 与子资源规则。

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

目录与阅读设置

阅读设置

17

记录一个想法

用资源目录管理游戏素材

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

登录哪都通