@esengine/network 2.1.0 → 2.2.0

package/dist/systems/NetworkPredictionSystem.d.ts

@@ -0,0 +1,113 @@
+/**
+ * @zh 网络预测系统
+ * @en Network Prediction System
+ *
+ * @zh 处理本地玩家的客户端预测和服务器校正
+ * @en Handles client-side prediction and server reconciliation for local player
+ */
+import { EntitySystem, type Entity } from '@esengine/ecs-framework';
+import type { SyncData, PlayerInput } from '../protocol';
+import { type ClientPredictionConfig, type ITransformState } from '../sync';
+/**
+ * @zh 移动输入
+ * @en Movement input
+ */
+export interface MovementInput {
+    x: number;
+    y: number;
+    actions?: string[];
+}
+/**
+ * @zh 预测状态（位置 + 旋转）
+ * @en Predicted state (position + rotation)
+ */
+export interface PredictedTransform extends ITransformState {
+    velocityX: number;
+    velocityY: number;
+}
+/**
+ * @zh 预测系统配置
+ * @en Prediction system configuration
+ */
+export interface NetworkPredictionConfig extends Partial<ClientPredictionConfig> {
+    /**
+     * @zh 移动速度（单位/秒）
+     * @en Movement speed (units/second)
+     */
+    moveSpeed: number;
+    /**
+     * @zh 是否启用预测
+     * @en Whether prediction is enabled
+     */
+    enabled: boolean;
+}
+/**
+ * @zh 网络预测系统
+ * @en Network prediction system
+ *
+ * @zh 处理本地玩家的输入预测和服务器状态校正
+ * @en Handles local player input prediction and server state reconciliation
+ */
+export declare class NetworkPredictionSystem extends EntitySystem {
+    private readonly _config;
+    private readonly _predictor;
+    private _prediction;
+    private _localPlayerNetId;
+    private _currentInput;
+    private _inputSequence;
+    constructor(config?: Partial<NetworkPredictionConfig>);
+    /**
+     * @zh 获取配置
+     * @en Get configuration
+     */
+    get config(): Readonly<NetworkPredictionConfig>;
+    /**
+     * @zh 获取当前输入序列号
+     * @en Get current input sequence number
+     */
+    get inputSequence(): number;
+    /**
+     * @zh 获取待确认输入数量
+     * @en Get pending input count
+     */
+    get pendingInputCount(): number;
+    /**
+     * @zh 是否启用预测
+     * @en Whether prediction is enabled
+     */
+    get enabled(): boolean;
+    set enabled(value: boolean);
+    /**
+     * @zh 设置本地玩家网络 ID
+     * @en Set local player network ID
+     */
+    setLocalPlayerNetId(netId: number): void;
+    /**
+     * @zh 设置移动输入
+     * @en Set movement input
+     */
+    setInput(x: number, y: number, actions?: string[]): void;
+    /**
+     * @zh 获取下一个要发送的输入（带序列号）
+     * @en Get next input to send (with sequence number)
+     */
+    getInputToSend(): PlayerInput | null;
+    /**
+     * @zh 处理服务器同步数据进行校正
+     * @en Process server sync data for reconciliation
+     */
+    reconcileWithServer(data: SyncData): void;
+    protected process(entities: readonly Entity[]): void;
+    /**
+     * @zh 重置预测状态
+     * @en Reset prediction state
+     */
+    reset(): void;
+    protected onDestroy(): void;
+}
+/**
+ * @zh 创建网络预测系统
+ * @en Create network prediction system
+ */
+export declare function createNetworkPredictionSystem(config?: Partial<NetworkPredictionConfig>): NetworkPredictionSystem;
+//# sourceMappingURL=NetworkPredictionSystem.d.ts.map

package/dist/systems/NetworkPredictionSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkPredictionSystem.d.ts","sourceRoot":"","sources":["../../src/systems/NetworkPredictionSystem.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAiB,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAGlF,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAIH,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACvB,MAAM,SAAS,CAAA;AAMhB;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACvD,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAwB,SAAQ,OAAO,CAAC,sBAAsB,CAAC;IAC5E;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAA;CACnB;AAuCD;;;;;;GAMG;AACH,qBAAa,uBAAwB,SAAQ,YAAY;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA+C;IAC1E,OAAO,CAAC,WAAW,CAAmE;IACtF,OAAO,CAAC,iBAAiB,CAAa;IACtC,OAAO,CAAC,aAAa,CAAgC;IACrD,OAAO,CAAC,cAAc,CAAY;gBAEtB,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC;IAMrD;;;OAGG;IACH,IAAI,MAAM,IAAI,QAAQ,CAAC,uBAAuB,CAAC,CAE9C;IAED;;;OAGG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;;OAGG;IACH,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED;;;OAGG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAEzB;IAED;;;OAGG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAYxC;;;OAGG;IACH,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAIxD;;;OAGG;IACH,cAAc,IAAI,WAAW,GAAG,IAAI;IAepC;;;OAGG;IACH,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;cA0BtB,OAAO,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAoD7D;;;OAGG;IACH,KAAK,IAAI,IAAI;cAMM,SAAS,IAAI,IAAI;CAIvC;AAMD;;;GAGG;AACH,wBAAgB,6BAA6B,CACzC,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC1C,uBAAuB,CAEzB"}

package/dist/systems/NetworkSyncSystem.d.ts

@@ -1,7 +1,16 @@
+/**
+ * @zh 网络同步系统
+ * @en Network Sync System
+ *
+ * @zh 处理网络实体的状态同步、快照缓冲和插值
+ * @en Handles state synchronization, snapshot buffering, and interpolation for networked entities
+ */
 import { EntitySystem, type Entity } from '@esengine/ecs-framework';
+import type { SyncData } from '../protocol';
+import { SnapshotBuffer, type ITransformStateWithVelocity } from '../sync';
 /**
- * @zh 同步消息接口
- * @en Sync message interface
+ * @zh 同步消息接口（兼容旧版）
+ * @en Sync message interface (for backwards compatibility)
  */
 export interface SyncMessage {
     entities: Array<{
@@ -13,22 +22,83 @@ export interface SyncMessage {
         rot?: number;
     }>;
 }
+/**
+ * @zh 同步系统配置
+ * @en Sync system configuration
+ */
+export interface NetworkSyncConfig {
+    /**
+     * @zh 快照缓冲区大小
+     * @en Snapshot buffer size
+     */
+    bufferSize: number;
+    /**
+     * @zh 插值延迟（毫秒）
+     * @en Interpolation delay in milliseconds
+     */
+    interpolationDelay: number;
+    /**
+     * @zh 是否启用外推
+     * @en Whether to enable extrapolation
+     */
+    enableExtrapolation: boolean;
+    /**
+     * @zh 最大外推时间（毫秒）
+     * @en Maximum extrapolation time in milliseconds
+     */
+    maxExtrapolationTime: number;
+    /**
+     * @zh 使用赫尔米特插值（更平滑）
+     * @en Use Hermite interpolation (smoother)
+     */
+    useHermiteInterpolation: boolean;
+}
 /**
  * @zh 网络同步系统
  * @en Network sync system
  *
- * @zh 处理网络实体的状态同步和插值
- * @en Handles state synchronization and interpolation for networked entities
+ * @zh 处理网络实体的状态同步和插值，支持快照缓冲、平滑插值和外推
+ * @en Handles state synchronization and interpolation for networked entities,
+ *     supports snapshot buffering, smooth interpolation, and extrapolation
  */
 export declare class NetworkSyncSystem extends EntitySystem {
-    private _netIdToEntity;
-    constructor();
+    private readonly _netIdToEntity;
+    private readonly _entitySnapshots;
+    private readonly _interpolator;
+    private readonly _config;
+    private _serverTimeOffset;
+    private _lastSyncTime;
+    private _renderTime;
+    constructor(config?: Partial<NetworkSyncConfig>);
+    /**
+     * @zh 获取配置
+     * @en Get configuration
+     */
+    get config(): Readonly<NetworkSyncConfig>;
+    /**
+     * @zh 获取服务器时间偏移
+     * @en Get server time offset
+     */
+    get serverTimeOffset(): number;
+    /**
+     * @zh 获取当前渲染时间
+     * @en Get current render time
+     */
+    get renderTime(): number;
+    /**
+     * @zh 处理同步消息（新版，带时间戳）
+     * @en Handle sync message (new version with timestamp)
+     */
+    handleSyncData(data: SyncData): void;
     /**
-     * @zh 处理同步消息
-     * @en Handle sync message
+     * @zh 处理同步消息（兼容旧版）
+     * @en Handle sync message (backwards compatible)
      */
     handleSync(msg: SyncMessage): void;
+    private _processEntityState;
     protected process(entities: readonly Entity[]): void;
+    private _interpolateEntity;
+    private _simpleLerp;
     /**
      * @zh 注册网络实体
      * @en Register network entity
@@ -44,7 +114,16 @@ export declare class NetworkSyncSystem extends EntitySystem {
      * @en Get entity ID by network ID
      */
     getEntityId(netId: number): number | undefined;
-    private _interpolate;
+    /**
+     * @zh 获取实体的快照缓冲区
+     * @en Get entity's snapshot buffer
+     */
+    getSnapshotBuffer(netId: number): SnapshotBuffer<ITransformStateWithVelocity> | undefined;
+    /**
+     * @zh 清空所有快照缓冲
+     * @en Clear all snapshot buffers
+     */
+    clearSnapshots(): void;
     protected onDestroy(): void;
 }
 //# sourceMappingURL=NetworkSyncSystem.d.ts.map

package/dist/systems/NetworkSyncSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NetworkSyncSystem.d.ts","sourceRoot":"","sources":["../../src/systems/NetworkSyncSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAiB,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAIlF;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,QAAQ,EAAE,KAAK,CAAC;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,GAAG,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QAC9B,GAAG,CAAC,EAAE,MAAM,CAAA;KACf,CAAC,CAAA;CACL;AAED;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IAC/C,OAAO,CAAC,cAAc,CAAiC;;IAMvD;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;cAef,OAAO,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAa7D;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIrD;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIrC;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI9C,OAAO,CAAC,YAAY;cAYD,SAAS,IAAI,IAAI;CAGvC"}
+{"version":3,"file":"NetworkSyncSystem.d.ts","sourceRoot":"","sources":["../../src/systems/NetworkSyncSystem.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAiB,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAGlF,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,aAAa,CAAA;AAC5D,OAAO,EACH,cAAc,EAKd,KAAK,2BAA2B,EAEnC,MAAM,SAAS,CAAA;AAMhB;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,QAAQ,EAAE,KAAK,CAAC;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,GAAG,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QAC9B,GAAG,CAAC,EAAE,MAAM,CAAA;KACf,CAAC,CAAA;CACL;AAWD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,kBAAkB,EAAE,MAAM,CAAA;IAE1B;;;OAGG;IACH,mBAAmB,EAAE,OAAO,CAAA;IAE5B;;;OAGG;IACH,oBAAoB,EAAE,MAAM,CAAA;IAE5B;;;OAGG;IACH,uBAAuB,EAAE,OAAO,CAAA;CACnC;AAcD;;;;;;;GAOG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiC;IAChE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6C;IAC9E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuB;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAE3C,OAAO,CAAC,iBAAiB,CAAY;IACrC,OAAO,CAAC,aAAa,CAAY;IACjC,OAAO,CAAC,WAAW,CAAY;gBAEnB,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAM/C;;;OAGG;IACH,IAAI,MAAM,IAAI,QAAQ,CAAC,iBAAiB,CAAC,CAExC;IAED;;;OAGG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED;;;OAGG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAapC;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAuBlC,OAAO,CAAC,mBAAmB;cAoCR,OAAO,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAoB7D,OAAO,CAAC,kBAAkB;IAiD1B,OAAO,CAAC,WAAW;IAYnB;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIrD;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKrC;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI9C;;;OAGG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,2BAA2B,CAAC,GAAG,SAAS;IAIzF;;;OAGG;IACH,cAAc,IAAI,IAAI;cAMH,SAAS,IAAI,IAAI;CAIvC"}

package/dist/tokens.d.ts

@@ -6,6 +6,8 @@ import type { NetworkService } from './services/NetworkService';
 import type { NetworkSyncSystem } from './systems/NetworkSyncSystem';
 import type { NetworkSpawnSystem } from './systems/NetworkSpawnSystem';
 import type { NetworkInputSystem } from './systems/NetworkInputSystem';
+import type { NetworkPredictionSystem } from './systems/NetworkPredictionSystem';
+import type { NetworkAOISystem } from './systems/NetworkAOISystem';
 /**
  * 网络服务令牌
  * Network service token
@@ -26,4 +28,14 @@ export declare const NetworkSpawnSystemToken: import("@esengine/ecs-framework").
  * Network input system token
  */
 export declare const NetworkInputSystemToken: import("@esengine/ecs-framework").ServiceToken<NetworkInputSystem>;
+/**
+ * 网络预测系统令牌
+ * Network prediction system token
+ */
+export declare const NetworkPredictionSystemToken: import("@esengine/ecs-framework").ServiceToken<NetworkPredictionSystem>;
+/**
+ * 网络 AOI 系统令牌
+ * Network AOI system token
+ */
+export declare const NetworkAOISystemToken: import("@esengine/ecs-framework").ServiceToken<NetworkAOISystem>;
 //# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAMvE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,gEAAuD,CAAC;AAExF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,mEAA6D,CAAC;AAEjG;;;GAGG;AACH,eAAO,MAAM,uBAAuB,oEAA+D,CAAC;AAEpG;;;GAGG;AACH,eAAO,MAAM,uBAAuB,oEAA+D,CAAC"}
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAMnE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,gEAAuD,CAAC;AAExF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,mEAA6D,CAAC;AAEjG;;;GAGG;AACH,eAAO,MAAM,uBAAuB,oEAA+D,CAAC;AAEpG;;;GAGG;AACH,eAAO,MAAM,uBAAuB,oEAA+D,CAAC;AAEpG;;;GAGG;AACH,eAAO,MAAM,4BAA4B,yEAAyE,CAAC;AAEnH;;;GAGG;AACH,eAAO,MAAM,qBAAqB,kEAA2D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esengine/network",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Network synchronization for multiplayer games",
   "esengine": {
     "plugin": true,
@@ -22,7 +22,7 @@
     "dist"
   ],
   "dependencies": {
-    "@esengine/rpc": "1.1.0"
+    "@esengine/rpc": "1.1.1"
   },
   "devDependencies": {
     "rimraf": "^5.0.5",