62 lines
1.7 KiB
TypeScript
62 lines
1.7 KiB
TypeScript
import { Component } from '@esengine/ecs-framework';
|
||
import { Vec3 } from 'cc';
|
||
|
||
/**
|
||
* 位置组件 - 存储实体的空间位置信息
|
||
*
|
||
* 这是最基础的组件示例，展示了ECS组件的设计原则：
|
||
* 1. 主要存储数据，少量辅助方法
|
||
* 2. 单一职责：只负责位置相关的数据
|
||
* 3. 可复用：任何需要位置信息的实体都可以使用
|
||
*/
|
||
export class PositionComponent extends Component {
|
||
/** 3D位置坐标 */
|
||
public position: Vec3 = new Vec3();
|
||
/** 上一帧的位置（用于计算移动距离） */
|
||
public lastPosition: Vec3 = new Vec3();
|
||
|
||
constructor(x: number = 0, y: number = 0, z: number = 0) {
|
||
super();
|
||
this.position.set(x, y, z);
|
||
this.lastPosition.set(x, y, z);
|
||
}
|
||
|
||
/**
|
||
* 设置位置
|
||
*/
|
||
setPosition(x: number, y: number, z: number = 0) {
|
||
this.lastPosition.set(this.position);
|
||
this.position.set(x, y, z);
|
||
}
|
||
|
||
/**
|
||
* 移动位置
|
||
*/
|
||
move(deltaX: number, deltaY: number, deltaZ: number = 0) {
|
||
this.lastPosition.set(this.position);
|
||
this.position.x += deltaX;
|
||
this.position.y += deltaY;
|
||
this.position.z += deltaZ;
|
||
}
|
||
|
||
/**
|
||
* 计算到另一个位置的距离
|
||
*/
|
||
distanceTo(other: PositionComponent): number {
|
||
return Vec3.distance(this.position, other.position);
|
||
}
|
||
|
||
/**
|
||
* 获取本帧移动的距离
|
||
*/
|
||
getMovementDistance(): number {
|
||
return Vec3.distance(this.position, this.lastPosition);
|
||
}
|
||
|
||
/**
|
||
* 检查是否在指定范围内
|
||
*/
|
||
isWithinRange(target: PositionComponent, range: number): boolean {
|
||
return this.distanceTo(target) <= range;
|
||
}
|
||
}
|