游戏引擎 / 系统课时

把重复逻辑封装成组件

把重复逻辑封装成组件

场景里的硬币、补给品和任务标记都需要轻微上下浮动时,分别复制脚本会让修改与调参变得困难。把共同的运动规则封装成一个可配置组件,再给不同节点设置独立参数,就能复用代码而不共享运行状态。

学习目标

  • 找出重复行为中应封装的逻辑与应暴露的参数。
  • 编写带 @property 的 TypeScript 组件,让多个节点独立使用。
  • 通过不同实例的效果验证复用,并避免多个组件争写同一属性。

从重复动作找到组件边界

假设三个物品都沿本地 Y 轴往返浮动。它们的算法相同,差别只是振幅和频率:这两个量应成为 Inspector 可配置的属性,而不是分别写死在三个脚本里。节点的原始位置和已经运行的时间则属于每个组件自己的状态,不应设成全局变量。

职责边界可以写成一句话:FloatMotion 只根据时间计算自己所属节点的局部 Y 坐标,不负责寻找其他节点、播放音效或处理拾取奖励。这样组件可以直接复用于不同的场景对象或预制体。

实现可配置的浮动组件

在 Cocos Creator 3.8 的 TypeScript 工程中新建 FloatMotion.ts,写入完整脚本。@ccclass 使脚本成为可挂载组件,@property 让每个实例的数值能够在 Inspector 中单独保存。

ts
import { _decorator, Component, Vec3 } from 'cc';
const { ccclass, property } = _decorator;

@ccclass('FloatMotion')
export class FloatMotion extends Component {
    @property
    amplitude = 20;

    @property
    frequencyHz = 1;

    private basePosition = new Vec3();
    private elapsedSeconds = 0;

    onLoad() {
        // 每个实例缓存自己节点的初始局部位置
        const p = this.node.position;
        this.basePosition.set(p.x, p.y, p.z);
    }

    update(deltaTime: number) {
        this.elapsedSeconds += deltaTime;
        // 从原点计算偏移,避免逐帧累加导致位置漂移
        const a = Math.max(0, this.amplitude);
        const f = Math.max(0, this.frequencyHz);
        const offsetY = Math.sin(this.elapsedSeconds * Math.PI * 2 * f) * a;
        this.node.setPosition(
            this.basePosition.x,
            this.basePosition.y + offsetY,
            this.basePosition.z
        );
    }
}

预期结果:将脚本挂到带有可见 Sprite 的激活节点后,该节点围绕初始高度平滑上下移动。默认 amplitude = 20 表示最大偏离初始高度 20 个本地坐标单位,frequencyHz = 1 表示每秒完成一次往返;将振幅设为 0 后保持初始高度。

在多个节点上独立配置

在场景的 Canvas 下准备三个带有 SpriteFrame 的 Sprite 节点,分别挂载同一个 FloatMotion 脚本,并在各自的 Inspector 中设置:

节点 amplitude frequencyHz 预览效果
硬币 12 1.2 小幅、较快
补给品 20 0.7 大幅、较慢
任务标记 8 1.5 最小幅、最快

这些节点使用的是同一个组件类的三个实例,不是三个节点共享一个组件对象。每个实例都有独立的 basePosition、elapsedSeconds 和配置值,因此改变硬币的参数不会改动补给品的参数。

重复脚本与共享组件定义、各节点独立配置的架构对比

验证独立性并避免属性冲突

预览后应看到三个图标的高度范围和移动快慢不同。关闭其中一个节点上的 FloatMotion 组件,只有它停止浮动,其余两个保持运动;把某实例的 frequencyHz 调为 0 并重新预览,该实例停在初始高度。这样可以同时检验 Inspector 配置、实例隔离和启停行为。

可复用不等于把所有功能塞进一个巨大脚本。浮动、拾取判定和奖励发放具有不同的变化原因,适合拆成可组合的组件;这样调整视觉效果时,不会误伤游戏规则。

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

目录与阅读设置

阅读设置

17

记录一个想法

把重复逻辑封装成组件

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

登录哪都通