游戏引擎 / 系统课时
拆掉场景脚本里的硬编码
拆掉场景脚本里的硬编码
当场景脚本写死角色名称、相机路径和出生坐标时,只要关卡层级变化或复制场景,就可能需要修改代码。本课把角色、相机、出生点以及镜头偏移改成检查器可配置的依赖,让同一段 Cocos Creator 3.8 脚本可以服务不同 3D 场景。
学习目标
- 识别节点名称、路径和坐标常量造成的场景耦合。
- 将角色、相机、出生点与镜头偏移声明为可配置属性。
- 通过更换场景绑定验证脚本无需修改即可复用。
找出与场景结构绑定的代码
find('Player') 和 find('Main Camera') 把业务逻辑绑定到节点名称;把出生位置写为固定的 new Vec3(0, 0, 0),则将关卡布局写进了脚本。场景复制、节点改名或出生点移动后,即使角色初始化逻辑没有变化,代码也可能需要跟着改。
应把对象身份与可调参数分开处理:角色和出生点使用 Node 引用;相机直接使用 Camera 组件引用;镜头相对出生点的偏移使用 Vec3 属性。这样脚本只负责装配和初始化,具体对象由每个场景指定。

用可配置属性完成场景初始化
创建 3D 场景,在根层准备角色节点 Player、带 Camera 组件的 Main Camera、空节点 SpawnPoint 和管理节点 SceneRoot。把 SpawnPoint 的位置设为 (5, 0, -2),用于测试非原点出生。创建 SceneWiring.ts 并挂载到 SceneRoot。保存后在组件属性里分别绑定角色、相机组件和出生点,保留镜头偏移默认值,运行场景。
import { _decorator, Camera, Component, Node, Vec3 } from 'cc';
const { ccclass, property } = _decorator;
@ccclass('SceneWiring')
export class SceneWiring extends Component {
@property({ type: Node })
player: Node | null = null;
@property({ type: Camera })
mainCamera: Camera | null = null;
@property({ type: Node })
spawnPoint: Node | null = null;
@property({ type: Vec3 })
cameraOffset: Vec3 = new Vec3(0, 3, 6);
start(): void {
const { player, mainCamera, spawnPoint } = this;
if (!player || !mainCamera || !spawnPoint) {
console.error('SceneWiring:请绑定角色、相机和出生点');
return;
}
// 读取世界坐标,避免不同父节点的局部坐标不一致。
const origin = spawnPoint.getWorldPosition(new Vec3());
player.setWorldPosition(origin);
// 偏移可由每个场景配置,此处只初始化机位,不实现持续跟随。
const eye = Vec3.add(new Vec3(), origin, this.cameraOffset);
mainCamera.node.setWorldPosition(eye);
mainCamera.node.lookAt(origin);
console.log('场景依赖已连接,角色与相机已就位');
}
}预期输出:
场景依赖已连接,角色与相机已就位这段脚本没有写死 Player、Main Camera 或 SpawnPoint 的查找路径。@property 负责把依赖暴露给属性检查器;getWorldPosition 和 setWorldPosition 则保证即使角色、出生点属于不同父节点,也能按同一个世界坐标定位。
核对绑定和世界坐标
在属性检查器中检查四个字段:Player 应指向角色节点,Main Camera 应指向相机的 Camera 组件,Spawn Point 应指向出生点节点,Camera Offset 保持 (0, 3, 6)。运行场景后,应能看到角色出现在出生点,镜头位于其后上方并朝向角色。
在这些节点均位于场景根层、没有额外父节点变换的前提下,角色的世界位置应为 (5, 0, -2),镜头的世界位置应为 (5, 3, 4)。这个空间结果比只看日志更重要:日志证明依赖已绑定,位置和朝向证明初始化逻辑确实执行。
用更换绑定检验解耦效果
复制一个测试场景,将角色改名为 Hero,把出生点移到新的位置,再在新场景的属性检查器中重新指定三个引用。运行后若角色仍在新出生点出现,就说明脚本不依赖原有节点名称和固定坐标。
故意清空任意必需字段,应只看到缺少绑定的错误日志,不会执行后续位置修改。若角色具有物理控制器,正式项目还应使用与该控制器兼容的重定位方式;这里演示的是普通节点在进入场景时的一次性摆放,不是逐帧移动或相机跟随。
检查器绑定能减少场景结构耦合,但不能自动跨场景保留对象。切换场景时应让新场景重新提供这些依赖;运行时实例化的对象则应在创建后显式绑定。