游戏引擎 / 系统课时

运行时动态生成对象

运行时动态生成对象

敌人波次、发射的子弹和掉落物无法全部预先摆进场景。本课使用 Cocos Creator 3.8 的 Prefab 与 instantiate,让脚本在运行时生成两只敌人,同时掌握编辑器引用和 resources.load 两种资源取得方式。

学习目标

  • 使用预制体资源创建彼此独立的运行时节点。
  • 正确设置新节点的父节点与局部坐标。
  • 区分编辑器直接引用与异步加载,并处理失败和清理问题。

准备生成容器和预制体

先准备一份包含可见 Sprite 的 Enemy.prefab,并在 Canvas 下创建空节点 SpawnRoot,用它集中管理本次生成的敌人。新建 GameSpawner.ts,将组件挂到场景中的一个常驻节点,例如 Canvas。

  1. 在 GameSpawner 的属性检查器中,把 SpawnRoot 节点拖入 spawnRoot 字段。
  2. 直接引用方案:把 Enemy.prefab 拖入 enemyPrefab 字段;该资源可放在普通 assets/prefabs 目录中。
  3. 动态加载方案:把资源放到 assets/resources/prefabs/Enemy.prefab,并让 enemyPrefab 保持为空,脚本会通过相对路径 prefabs/Enemy 加载它。

两种方案只需要选择一种。直接引用最适合关卡里已知且经常使用的资源;路径加载适合需要按条件取得的资源,回调完成前不能使用尚未加载到的 Prefab。

创建流程与坐标归属

关键顺序是得到资源 → instantiate 创建节点 → addChild 挂入场景 → 设置位置。instantiate 产生的新节点彼此独立,修改其中一只敌人的位置或生命值不会直接改动另一只。

运行时从预制体资源取得到实例挂载和定位的数据流程

这里的 setPosition 使用父节点 SpawnRoot 的局部坐标。它应位于显示敌人的 Canvas 节点层级下;如果改用世界坐标或挂到不同父节点,生成位置可能与预期不同。

编写完整生成脚本

下面是 GameSpawner.ts 的完整示例:优先使用属性面板已绑定的 Prefab,否则异步加载 resources 目录中的资源。脚本只在 start 中生成一次,避免每帧重复创建。

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

@ccclass('GameSpawner')
export class GameSpawner extends Component {
    @property({ type: Prefab })
    enemyPrefab: Prefab | null = null;

    @property({ type: Node })
    spawnRoot: Node | null = null;

    start() {
        if (!this.spawnRoot) {
            console.error('SpawnRoot is not assigned');
            return;
        }
        if (this.enemyPrefab) {
            this.spawnPair(this.enemyPrefab);
            return;
        }
        // 未绑定资源时,按 resources 目录的相对路径异步加载。
        resources.load('prefabs/Enemy', Prefab, (err, prefab) => {
            if (err || !prefab) {
                console.error('Cannot load Enemy prefab', err);
                return;
            }
            if (!isValid(this.node) || !this.spawnRoot || !isValid(this.spawnRoot)) return;
            this.spawnPair(prefab);
        });
    }

    private spawnPair(prefab: Prefab) {
        const root = this.spawnRoot;
        if (!root) return;
        [-150, 150].forEach((x, index) => {
            const enemy = instantiate(prefab);
            // 确定父节点后,设置相对于 SpawnRoot 的局部坐标。
            root.addChild(enemy);
            enemy.name = `Enemy_${index + 1}`;
            enemy.setPosition(x, 0, 0);
            console.log(`Spawned ${enemy.name}: x=${enemy.position.x}`);
        });
    }
}

运行验收和生命周期边界

运行场景后,应在 SpawnRoot 下看到两个新节点;若精灵资源正确且处于相机可见范围,画面上会出现两只敌人。控制台中本脚本的预期输出如下,预制体上的其他脚本可能另有日志:

text
Spawned Enemy_1: x=-150
Spawned Enemy_2: x=150

如果走动态加载却没有生成对象,先核查资源是否真的位于 assets/resources/prefabs/Enemy.prefab,并确认加载路径不带 .prefab 后缀。如果报 SpawnRoot is not assigned,则是节点引用没有在属性检查器中绑定。

敌人死亡、子弹命中或飞出边界后,应由业务逻辑调用相应节点的 destroy();销毁操作通常在当前帧结束时完成。大量高频子弹更适合复用对象,而不是不断创建后销毁。

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

目录与阅读设置

阅读设置

17

记录一个想法

运行时动态生成对象

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

登录哪都通