121 lines
3.6 KiB
TypeScript
121 lines
3.6 KiB
TypeScript
|
/**
|
|||
|
|
* 简化后的Matcher使用示例
|
|||
|
|
* 展示框架自动处理QuerySystem的优雅设计
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
import { Scene } from '../src/ECS/Scene';
|
|||
|
|
import { Component } from '../src/ECS/Component';
|
|||
|
|
import { Matcher } from '../src/ECS/Utils/Matcher';
|
|||
|
|
|
|||
|
|
// 示例组件
|
|||
|
|
class Position extends Component {
|
|||
|
|
constructor(public x: number = 0, public y: number = 0) {
|
|||
|
|
super();
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
class Velocity extends Component {
|
|||
|
|
constructor(public vx: number = 0, public vy: number = 0) {
|
|||
|
|
super();
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
class Health extends Component {
|
|||
|
|
constructor(public hp: number = 100) {
|
|||
|
|
super();
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
class Dead extends Component {}
|
|||
|
|
|
|||
|
|
function demonstrateSimplifiedMatcher() {
|
|||
|
|
console.log('=== 简化的Matcher API示例 ===\n');
|
|||
|
|
|
|||
|
|
// 创建场景 - QuerySystem自动创建
|
|||
|
|
const scene = new Scene();
|
|||
|
|
scene.begin();
|
|||
|
|
|
|||
|
|
// 创建测试实体
|
|||
|
|
const player = scene.createEntity('Player');
|
|||
|
|
player.addComponent(new Position(100, 200));
|
|||
|
|
player.addComponent(new Velocity(5, 0));
|
|||
|
|
player.addComponent(new Health(100));
|
|||
|
|
|
|||
|
|
const enemy = scene.createEntity('Enemy');
|
|||
|
|
enemy.addComponent(new Position(300, 200));
|
|||
|
|
enemy.addComponent(new Health(50));
|
|||
|
|
|
|||
|
|
const corpse = scene.createEntity('Corpse');
|
|||
|
|
corpse.addComponent(new Position(150, 150));
|
|||
|
|
corpse.addComponent(new Dead());
|
|||
|
|
|
|||
|
|
// ===== 推荐的新API =====
|
|||
|
|
|
|||
|
|
// 1. 直接使用scene.querySystem创建Matcher
|
|||
|
|
const movingEntities = Matcher.create(scene.querySystem)
|
|||
|
|
.all(Position, Velocity)
|
|||
|
|
.query();
|
|||
|
|
|
|||
|
|
console.log('移动实体:', movingEntities.map(e => e.name));
|
|||
|
|
|
|||
|
|
// 2. 复合查询 - 活着的实体
|
|||
|
|
const aliveEntities = Matcher.create(scene.querySystem)
|
|||
|
|
.all(Health)
|
|||
|
|
.none(Dead)
|
|||
|
|
.query();
|
|||
|
|
|
|||
|
|
console.log('活着的实体:', aliveEntities.map(e => e.name));
|
|||
|
|
|
|||
|
|
// 3. 实用方法
|
|||
|
|
const healthMatcher = Matcher.create(scene.querySystem).all(Health);
|
|||
|
|
console.log(`有血量的实体数量: ${healthMatcher.count()}`);
|
|||
|
|
console.log(`玩家是否有血量: ${healthMatcher.matches(player)}`);
|
|||
|
|
|
|||
|
|
// 4. 系统中使用Matcher的典型模式
|
|||
|
|
class MovementSystem {
|
|||
|
|
private movementMatcher: Matcher;
|
|||
|
|
|
|||
|
|
constructor(scene: Scene) {
|
|||
|
|
// 在系统初始化时创建Matcher
|
|||
|
|
this.movementMatcher = Matcher.create(scene.querySystem)
|
|||
|
|
.all(Position, Velocity);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
update() {
|
|||
|
|
// 高效的批量查询
|
|||
|
|
const movableEntities = this.movementMatcher.query();
|
|||
|
|
|
|||
|
|
for (const entity of movableEntities) {
|
|||
|
|
const pos = entity.getComponent(Position)!;
|
|||
|
|
const vel = entity.getComponent(Velocity)!;
|
|||
|
|
|
|||
|
|
pos.x += vel.vx;
|
|||
|
|
pos.y += vel.vy;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 5. 创建并使用系统
|
|||
|
|
const movementSystem = new MovementSystem(scene);
|
|||
|
|
movementSystem.update();
|
|||
|
|
|
|||
|
|
console.log('玩家更新后位置:', player.getComponent(Position));
|
|||
|
|
|
|||
|
|
scene.end();
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ===== 展示设计哲学 =====
|
|||
|
|
function designPhilosophy() {
|
|||
|
|
console.log('\n=== 设计哲学 ===');
|
|||
|
|
console.log('✅ QuerySystem是框架核心，总是存在');
|
|||
|
|
console.log('✅ Matcher强制要求QuerySystem，避免回退复杂性');
|
|||
|
|
console.log('✅ 清晰的错误提示，引导正确使用');
|
|||
|
|
console.log('✅ 旧API保持兼容，但明确标记deprecated');
|
|||
|
|
console.log('✅ 新API简洁明了，符合现代设计原则');
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 运行示例
|
|||
|
|
if (require.main === module) {
|
|||
|
|
demonstrateSimplifiedMatcher();
|
|||
|
|
designPhilosophy();
|
|||
|
|
}
|