90 lines
2.2 KiB
Markdown
90 lines
2.2 KiB
Markdown
|
---
|
|||
|
|
"@esengine/ecs-framework": minor
|
|||
|
|
"@esengine/network": minor
|
|||
|
|
"@esengine/server": minor
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
feat: ECS 网络状态同步系统
|
|||
|
|
|
|||
|
|
## @esengine/ecs-framework
|
|||
|
|
|
|||
|
|
新增 `@sync` 装饰器和二进制编解码器，支持基于 Component 的网络状态同步：
|
|||
|
|
|
|||
|
|
```typescript
|
|||
|
|
import { Component, ECSComponent, sync } from '@esengine/ecs-framework';
|
|||
|
|
|
|||
|
|
@ECSComponent('Player')
|
|||
|
|
class PlayerComponent extends Component {
|
|||
|
|
@sync("string") name: string = "";
|
|||
|
|
@sync("uint16") score: number = 0;
|
|||
|
|
@sync("float32") x: number = 0;
|
|||
|
|
@sync("float32") y: number = 0;
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 新增导出
|
|||
|
|
|
|||
|
|
- `sync` - 标记需要同步的字段装饰器
|
|||
|
|
- `SyncType` - 支持的同步类型
|
|||
|
|
- `SyncOperation` - 同步操作类型（FULL/DELTA/SPAWN/DESPAWN）
|
|||
|
|
- `encodeSnapshot` / `decodeSnapshot` - 批量编解码
|
|||
|
|
- `encodeSpawn` / `decodeSpawn` - 实体生成编解码
|
|||
|
|
- `encodeDespawn` / `processDespawn` - 实体销毁编解码
|
|||
|
|
- `ChangeTracker` - 字段级变更追踪
|
|||
|
|
- `initChangeTracker` / `clearChanges` / `hasChanges` - 变更追踪工具函数
|
|||
|
|
|
|||
|
|
### 内部方法标记
|
|||
|
|
|
|||
|
|
将以下方法标记为 `@internal`，用户应通过 `Core.update()` 驱动更新：
|
|||
|
|
- `Scene.update()`
|
|||
|
|
- `SceneManager.update()`
|
|||
|
|
- `WorldManager.updateAll()`
|
|||
|
|
|
|||
|
|
## @esengine/network
|
|||
|
|
|
|||
|
|
新增 `ComponentSyncSystem`，基于 `@sync` 装饰器自动同步组件状态：
|
|||
|
|
|
|||
|
|
```typescript
|
|||
|
|
import { ComponentSyncSystem } from '@esengine/network';
|
|||
|
|
|
|||
|
|
// 服务端：编码状态
|
|||
|
|
const data = syncSystem.encodeAllEntities(false);
|
|||
|
|
|
|||
|
|
// 客户端：解码状态
|
|||
|
|
syncSystem.applySnapshot(data);
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 修复
|
|||
|
|
|
|||
|
|
- 将 `@esengine/ecs-framework` 从 devDependencies 移到 peerDependencies
|
|||
|
|
|
|||
|
|
## @esengine/server
|
|||
|
|
|
|||
|
|
新增 `ECSRoom`，带有 ECS World 支持的房间基类：
|
|||
|
|
|
|||
|
|
```typescript
|
|||
|
|
import { ECSRoom } from '@esengine/server/ecs';
|
|||
|
|
|
|||
|
|
// 服务端启动
|
|||
|
|
Core.create();
|
|||
|
|
setInterval(() => Core.update(1/60), 16);
|
|||
|
|
|
|||
|
|
// 定义房间
|
|||
|
|
class GameRoom extends ECSRoom {
|
|||
|
|
onCreate() {
|
|||
|
|
this.addSystem(new PhysicsSystem());
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
onJoin(player: Player) {
|
|||
|
|
const entity = this.createPlayerEntity(player.id);
|
|||
|
|
entity.addComponent(new PlayerComponent());
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 设计
|
|||
|
|
|
|||
|
|
- 每个 `ECSRoom` 在 `Core.worldManager` 中创建独立的 World
|
|||
|
|
- `Core.update()` 统一更新 Time 和所有 World
|
|||
|
|
- `onTick()` 只处理状态同步逻辑
|