游戏引擎 / 系统课时
运行时动态生成对象
运行时动态生成对象
敌人波次、发射的子弹和掉落物无法全部预先摆进场景。本课使用 Cocos Creator 3.8 的 Prefab 与 instantiate,让脚本在运行时生成两只敌人,同时掌握编辑器引用和 resources.load 两种资源取得方式。
学习目标
- 使用预制体资源创建彼此独立的运行时节点。
- 正确设置新节点的父节点与局部坐标。
- 区分编辑器直接引用与异步加载,并处理失败和清理问题。
准备生成容器和预制体
先准备一份包含可见 Sprite 的 Enemy.prefab,并在 Canvas 下创建空节点 SpawnRoot,用它集中管理本次生成的敌人。新建 GameSpawner.ts,将组件挂到场景中的一个常驻节点,例如 Canvas。
- 在
GameSpawner的属性检查器中,把SpawnRoot节点拖入spawnRoot字段。 - 直接引用方案:把
Enemy.prefab拖入enemyPrefab字段;该资源可放在普通assets/prefabs目录中。 - 动态加载方案:把资源放到
assets/resources/prefabs/Enemy.prefab,并让enemyPrefab保持为空,脚本会通过相对路径prefabs/Enemy加载它。
两种方案只需要选择一种。直接引用最适合关卡里已知且经常使用的资源;路径加载适合需要按条件取得的资源,回调完成前不能使用尚未加载到的 Prefab。
创建流程与坐标归属
关键顺序是得到资源 → instantiate 创建节点 → addChild 挂入场景 → 设置位置。instantiate 产生的新节点彼此独立,修改其中一只敌人的位置或生命值不会直接改动另一只。

这里的 setPosition 使用父节点 SpawnRoot 的局部坐标。它应位于显示敌人的 Canvas 节点层级下;如果改用世界坐标或挂到不同父节点,生成位置可能与预期不同。
编写完整生成脚本
下面是 GameSpawner.ts 的完整示例:优先使用属性面板已绑定的 Prefab,否则异步加载 resources 目录中的资源。脚本只在 start 中生成一次,避免每帧重复创建。
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 下看到两个新节点;若精灵资源正确且处于相机可见范围,画面上会出现两只敌人。控制台中本脚本的预期输出如下,预制体上的其他脚本可能另有日志:
Spawned Enemy_1: x=-150
Spawned Enemy_2: x=150如果走动态加载却没有生成对象,先核查资源是否真的位于 assets/resources/prefabs/Enemy.prefab,并确认加载路径不带 .prefab 后缀。如果报 SpawnRoot is not assigned,则是节点引用没有在属性检查器中绑定。
敌人死亡、子弹命中或飞出边界后,应由业务逻辑调用相应节点的 destroy();销毁操作通常在当前帧结束时完成。大量高频子弹更适合复用对象,而不是不断创建后销毁。