avalon-game-battle-engine/io.github.lishangbu.avalon.game.battle.engine.core.session/BattleSessionQuery

BattleSessionQuery

data class BattleSessionQuery(val snapshot: BattleRuntimeSnapshot, val pendingActions: List<BattleSessionAction>, val choiceStatuses: List<BattleSessionChoiceStatus>, val replacementRequests: List<BattleSessionReplacementRequest>, val resourceLedger: List<BattleSessionResourceUsage>, val battleLogs: List<String>, val eventLogs: List<BattleSessionEvent>)

BattleSession 对外查询结果。

设计意图：

把 session 当前对外可见的状态收拢成稳定 DTO。
避免调用方直接分别拉取 snapshot、pending actions、replacement requests、logs。

Constructors

BattleSessionQuery

constructor(snapshot: BattleRuntimeSnapshot, pendingActions: List<BattleSessionAction>, choiceStatuses: List<BattleSessionChoiceStatus>, replacementRequests: List<BattleSessionReplacementRequest>, resourceLedger: List<BattleSessionResourceUsage>, battleLogs: List<String>, eventLogs: List<BattleSessionEvent>)

Properties

val battleLogs: List<String>

人类可读 battle log。

captureResourceLedger

val captureResourceLedger: List<BattleSessionCaptureResourceUsage>

捕捉资源账本的强类型视图。

val choiceStatuses: List<BattleSessionChoiceStatus>

当前回合各 side 的输入状态。

val eventLogs: List<BattleSessionEvent>

结构化事件日志。

val eventPayloads: List<BattleSessionEventPayload>

结构化事件的强类型 payload 视图。

executedActionEvents

val executedActionEvents: List<BattleSessionExecutedActionPayload>

已执行动作事件的强类型视图。

val pendingActions: List<BattleSessionAction>

当前待执行行动列表。

queuedActionEvents

val queuedActionEvents: List<BattleSessionQueuedActionPayload>

已入队动作事件的强类型视图。

replacementRequests

val replacementRequests: List<BattleSessionReplacementRequest>

当前待处理替补请求。

val resourceLedger: List<BattleSessionResourceUsage>

当前全部资源账本条目。

val snapshot: BattleRuntimeSnapshot

当前 battle 快照。

val turnStatus: BattleSessionTurnStatus?

当前运行中回合的派生状态。