94 lines
2.3 KiB
TypeScript
94 lines
2.3 KiB
TypeScript
import { Component } from '@esengine/ecs-framework';
|
||
import { Vec3 } from 'cc';
|
||
|
||
/**
|
||
* 速度组件 - 存储实体的运动速度信息
|
||
*
|
||
* 设计原则展示：
|
||
* 1. 与PositionComponent分离：遵循单一职责原则
|
||
* 2. 包含速度限制：避免无限加速
|
||
* 3. 提供常用的速度操作方法
|
||
*/
|
||
export class VelocityComponent extends Component {
|
||
/** 当前速度向量 */
|
||
public velocity: Vec3 = new Vec3();
|
||
/** 最大速度限制 */
|
||
public maxSpeed: number = 100;
|
||
/** 阻尼系数（0-1，1为无阻尼） */
|
||
public damping: number = 1.0;
|
||
|
||
constructor(x: number = 0, y: number = 0, z: number = 0, maxSpeed: number = 100) {
|
||
super();
|
||
this.velocity.set(x, y, z);
|
||
this.maxSpeed = maxSpeed;
|
||
}
|
||
|
||
/**
|
||
* 设置速度
|
||
*/
|
||
setVelocity(x: number, y: number, z: number = 0) {
|
||
this.velocity.set(x, y, z);
|
||
this.clampToMaxSpeed();
|
||
}
|
||
|
||
/**
|
||
* 添加速度（加速度效果）
|
||
*/
|
||
addVelocity(x: number, y: number, z: number = 0) {
|
||
this.velocity.x += x;
|
||
this.velocity.y += y;
|
||
this.velocity.z += z;
|
||
this.clampToMaxSpeed();
|
||
}
|
||
|
||
/**
|
||
* 应用阻尼
|
||
*/
|
||
applyDamping(deltaTime: number) {
|
||
if (this.damping < 1.0) {
|
||
const dampingFactor = Math.pow(this.damping, deltaTime);
|
||
this.velocity.multiplyScalar(dampingFactor);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 限制速度不超过最大值
|
||
*/
|
||
private clampToMaxSpeed() {
|
||
const speed = this.velocity.length();
|
||
if (speed > this.maxSpeed) {
|
||
this.velocity.normalize();
|
||
this.velocity.multiplyScalar(this.maxSpeed);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 获取当前速度大小
|
||
*/
|
||
getSpeed(): number {
|
||
return this.velocity.length();
|
||
}
|
||
|
||
/**
|
||
* 获取速度方向（单位向量）
|
||
*/
|
||
getDirection(): Vec3 {
|
||
const result = new Vec3();
|
||
Vec3.normalize(result, this.velocity);
|
||
return result;
|
||
}
|
||
|
||
/**
|
||
* 停止移动
|
||
*/
|
||
stop() {
|
||
this.velocity.set(0, 0, 0);
|
||
}
|
||
|
||
/**
|
||
* 检查是否在移动
|
||
*/
|
||
isMoving(): boolean {
|
||
return this.velocity.lengthSqr() > 0.01; // 避免浮点数精度问题
|
||
}
|
||
}
|