游戏引擎 / 系统课时

让脚本控制场景中的节点

让脚本控制场景中的节点

脚本能编译却没有画面变化,常见原因是没挂载、引用未绑定,或改错了坐标空间。本节用一个完整组件驱动指定节点左右往返,并通过缺失引用检查把配置错误提前暴露出来。

学习目标

  • 在属性检查器绑定目标节点
  • 使用生命周期和增量时间更新位置
  • 为缺失引用与重复控制提供定位方法

给控制器明确的目标

在 Creator 3.8.8 的 2D 场景中,准备一个 Canvas 下可见的 Sprite 节点,命名为 Player。另建空节点 MotionController,挂载下方组件,将层级里的 Player 拖到它的 target 字段。拖拽的是场景实例,不是图片文件或脚本资源。

组件挂在控制器节点上,因此 this.node 指向控制器;目标角色通过显式属性引用。这个区分可以避免为了移动玩家而不小心移动整个 UI 根节点。示例让目标在自己的父节点坐标系里运动,父节点保持不旋转且缩放为 1。

完整的往返运动

保存为 NodeMotion.ts。初始化时记录起点,之后根据累计时间计算位置,不在每帧向已有位移上叠加正弦值。

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、动画轨道、物理同步或其他脚本写入位置;最后一次写入可能覆盖前面的结果。

不要通过每帧重新搜索同名节点修复引用错误。名称可以重复,场景重组也会改变路径;编辑器绑定的明确引用更适合固定场景关系。动态对象则应在创建时把引用交给控制器。

这个组件用于纯变换演示。给动态物理刚体同时运行本脚本,可能与物理系统争夺位置所有权;物理移动应通过速度或相应物理接口完成。运行时改动只是当前预览状态,退出后应检查场景中的初始绑定仍存在。

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

目录与阅读设置

阅读设置

17

记录一个想法

让脚本控制场景中的节点

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

登录哪都通