游戏引擎 / 系统课时
让脚本控制场景中的节点
让脚本控制场景中的节点
脚本能编译却没有画面变化,常见原因是没挂载、引用未绑定,或改错了坐标空间。本节用一个完整组件驱动指定节点左右往返,并通过缺失引用检查把配置错误提前暴露出来。
学习目标
- 在属性检查器绑定目标节点
- 使用生命周期和增量时间更新位置
- 为缺失引用与重复控制提供定位方法
给控制器明确的目标
在 Creator 3.8.8 的 2D 场景中,准备一个 Canvas 下可见的 Sprite 节点,命名为 Player。另建空节点 MotionController,挂载下方组件,将层级里的 Player 拖到它的 target 字段。拖拽的是场景实例,不是图片文件或脚本资源。
组件挂在控制器节点上,因此 this.node 指向控制器;目标角色通过显式属性引用。这个区分可以避免为了移动玩家而不小心移动整个 UI 根节点。示例让目标在自己的父节点坐标系里运动,父节点保持不旋转且缩放为 1。
完整的往返运动
保存为 NodeMotion.ts。初始化时记录起点,之后根据累计时间计算位置,不在每帧向已有位移上叠加正弦值。
import { _decorator, Component, Node, Vec3 } from 'cc';
const { ccclass, property } = _decorator;
@ccclass('NodeMotion')
export class NodeMotion extends Component {
@property(Node)
target: Node | null = null;
private origin = new Vec3();
private elapsed = 0;
start(): void {
if (!this.target) {
console.error('NodeMotion: target is missing');
this.enabled = false; // 配置错误时停止更新,不持续刷异常
return;
}
this.origin.set(this.target.position);
}
update(dt: number): void {
if (!this.target) return;
this.elapsed += dt;
const x = this.origin.x + Math.sin(this.elapsed) * 60;
// 保留原来的纵向位置和深度,只控制一个维度
this.target.setPosition(x, this.origin.y, this.origin.z);
}
}预期结果:角色以原点为中心,水平方向在正负 60 个父节点坐标单位内往返,纵向位置不变。取消 target 绑定再预览,应看到一次缺失引用错误,组件停止更新,而不是不断抛空引用异常。
从配置查到写入冲突
完全不动时,先确认目标引用、组件启用、所属节点激活,再检查 update 是否执行。移动一瞬间又跳回时,查同一节点是否还有 Widget、动画轨道、物理同步或其他脚本写入位置;最后一次写入可能覆盖前面的结果。
不要通过每帧重新搜索同名节点修复引用错误。名称可以重复,场景重组也会改变路径;编辑器绑定的明确引用更适合固定场景关系。动态对象则应在创建时把引用交给控制器。
这个组件用于纯变换演示。给动态物理刚体同时运行本脚本,可能与物理系统争夺位置所有权;物理移动应通过速度或相应物理接口完成。运行时改动只是当前预览状态,退出后应检查场景中的初始绑定仍存在。