游戏引擎 / 系统课时
用脚本引用其他游戏对象
用脚本引用其他游戏对象
当场景控制脚本需要读取相机、角色或其他节点上的功能时,首先要建立可靠的对象引用。本课使用 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()。
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 组件');
}
}预期输出:
已连接节点:Main Camera
已获取 Camera 组件检验属性注入与备用查找
清空 Camera Node 再运行时,脚本会尝试 find('Main Camera'),在该节点仍位于场景根层时,输出不变。这里的路径是相对于场景根节点的;如果把相机移入 Stage 下,备用查找路径就应改为 find('Stage/Main Camera')。
让引用失败变得可定位
将相机节点改名并清空注入属性,控制台应提示未找到节点;移除目标节点上的 Camera 组件,控制台应提示组件缺失。这两个实验说明:检查节点是否存在与检查组件是否存在是不同的验证步骤。
对于固定场景依赖,优先使用检查器绑定,避免重命名或调整层级后修改大量字符串路径。路径查找可作为明确约定下的补充手段,而非所有对象访问的默认方式。