游戏引擎 / 系统课时

用脚本引用其他游戏对象

用脚本引用其他游戏对象

当场景控制脚本需要读取相机、角色或其他节点上的功能时,首先要建立可靠的对象引用。本课使用 Cocos Creator 3.8 完成一次相机引用:在属性检查器中绑定节点,必要时通过路径查找,并在使用前确认目标组件存在。

学习目标

  • 区分 Node 与 Component,理解引用的两级关系。
  • 使用 @property、find 和 getComponent 获取其他游戏对象。
  • 验证引用结果,并定位名称、层级或组件缺失问题。

先分清节点与组件

场景层级中的 Node 负责父子结构、位置、旋转和激活状态;挂在节点上的 Component 提供相机、物理或自定义行为。例如,相机节点可以被找到,但它未必挂有 Camera 组件。调用 getComponent(Camera) 才能获取相机功能,获取失败时返回 null。

建立跨节点关系有两种常见入口:用 @property 把场景节点拖到脚本字段中,或调用 find 沿节点路径查询。前者适合场景中已确定的依赖;后者适合按约定路径定位的对象。取得节点后,再通过 getComponent 获取所需组件。

属性注入、路径查找和组件获取的引用关系

编写可验证的引用脚本

在 3D 场景的根层保留名为 Main Camera 的节点,并确认它有 Camera 组件。再新建空节点 SceneProbe,创建脚本 SceneReferenceDemo.ts,内容如下。保存后将脚本挂到 SceneProbe,把 Main Camera 拖入 Camera Node 字段;运行时由引擎自动调用 start()。

ts
import { _decorator, Camera, Component, Node, find } from 'cc';
const { ccclass, property } = _decorator;

@ccclass('SceneReferenceDemo')
export class SceneReferenceDemo extends Component {
    @property({ type: Node })
    cameraNode: Node | null = null;

    start(): void {
        // 优先采用编辑器注入的引用,未绑定时再查找场景根节点。
        const target = this.cameraNode ?? find('Main Camera');
        if (!target) {
            console.warn('未找到 Main Camera 节点');
            return;
        }

        // 找到节点不代表它一定包含目标组件。
        const camera = target.getComponent(Camera);
        if (!camera) {
            console.warn(`${target.name} 缺少 Camera 组件`);
            return;
        }

        console.log(`已连接节点:${target.name}`);
        console.log('已获取 Camera 组件');
    }
}

预期输出:

text
已连接节点:Main Camera
已获取 Camera 组件

检验属性注入与备用查找

清空 Camera Node 再运行时,脚本会尝试 find('Main Camera'),在该节点仍位于场景根层时,输出不变。这里的路径是相对于场景根节点的;如果把相机移入 Stage 下,备用查找路径就应改为 find('Stage/Main Camera')。

让引用失败变得可定位

将相机节点改名并清空注入属性,控制台应提示未找到节点;移除目标节点上的 Camera 组件,控制台应提示组件缺失。这两个实验说明:检查节点是否存在与检查组件是否存在是不同的验证步骤。

对于固定场景依赖,优先使用检查器绑定,避免重命名或调整层级后修改大量字符串路径。路径查找可作为明确约定下的补充手段,而非所有对象访问的默认方式。

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

目录与阅读设置

阅读设置

17

记录一个想法

用脚本引用其他游戏对象

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

登录哪都通