游戏引擎 / 系统课时
把重复逻辑封装成组件
把重复逻辑封装成组件
场景里的硬币、补给品和任务标记都需要轻微上下浮动时,分别复制脚本会让修改与调参变得困难。把共同的运动规则封装成一个可配置组件,再给不同节点设置独立参数,就能复用代码而不共享运行状态。
学习目标
- 找出重复行为中应封装的逻辑与应暴露的参数。
- 编写带
@property的 TypeScript 组件,让多个节点独立使用。 - 通过不同实例的效果验证复用,并避免多个组件争写同一属性。
从重复动作找到组件边界
假设三个物品都沿本地 Y 轴往返浮动。它们的算法相同,差别只是振幅和频率:这两个量应成为 Inspector 可配置的属性,而不是分别写死在三个脚本里。节点的原始位置和已经运行的时间则属于每个组件自己的状态,不应设成全局变量。
职责边界可以写成一句话:FloatMotion 只根据时间计算自己所属节点的局部 Y 坐标,不负责寻找其他节点、播放音效或处理拾取奖励。这样组件可以直接复用于不同的场景对象或预制体。
实现可配置的浮动组件
在 Cocos Creator 3.8 的 TypeScript 工程中新建 FloatMotion.ts,写入完整脚本。@ccclass 使脚本成为可挂载组件,@property 让每个实例的数值能够在 Inspector 中单独保存。
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 配置、实例隔离和启停行为。
可复用不等于把所有功能塞进一个巨大脚本。浮动、拾取判定和奖励发放具有不同的变化原因,适合拆成可组合的组件;这样调整视觉效果时,不会误伤游戏规则。