本文档描述 Runtime/Moba/Server/StartGame 中的开局编排逻辑。
核心目标:
- 开局条件以
IMobaRoomOrchestrator.State为准 - 开局 spec 以
MobaGameStartSpec表达 - 开局落地通过运行时的
MobaEnterGameFlowService.ApplyGameStartSpec执行
-
IMobaGameStartOrchestrator- 定义对外能力:
TryStartGame(ActorContext)
- 定义对外能力:
-
MobaGameStartOrchestrator- 依赖:
IMobaRoomOrchestrator:权威房间状态MobaEnterGameFlowService:运行时 enter-game 执行器
- 内部状态:
_started用于幂等(防止重复开局)
- 依赖:
-
MobaWorldAutoStartHandler- 依赖:
IMobaRoomOrchestrator - 用于“世界自动开局”策略判断(通常由上层 tick 驱动)
- 依赖:
当前判断逻辑位于 Room:
room.State.CanStart()- 人数满足
- 全员 ready
- 全员已选 hero
StartGame 层只负责调用与记录幂等。
room.TryBuildGameStartSpec(localPlayerId, out MobaGameStartSpec)localPlayerId在当前实现中会从room.State.Players中任选一个(用于构建EnterMobaGameReq.playerId)EnterMobaGameReq.players为 loadout 列表
约束:spec 构建必须是纯函数式/可重放的(同一 room state -> 同一 spec)。
sequenceDiagram
autonumber
participant Tick as StartGame tick/trigger
participant Or as MobaGameStartOrchestrator
participant Room as IMobaRoomOrchestrator
participant Flow as MobaEnterGameFlowService
participant World as World (ActorContext)
Tick->>Or: TryStartGame(actorContext)
Or->>Or: if _started return false
Or->>Room: CanStart? (room.State.CanStart)
alt cannot start
Or-->>Tick: false
else can start
Or->>Room: TryBuildGameStartSpec
Or->>Flow: ApplyGameStartSpec(actorContext, spec)
Flow->>World: build actors + publish enter-game snapshots
Or->>Or: if ok => _started=true
Or-->>Tick: ok
end
_started仅在ApplyGameStartSpec返回 true 时置为 true- 如果
CanStart=true但 flow 执行失败,允许后续再次尝试(由上层决定是否重试)
- StartGame 不关心 RoomSync 的网络细节
- StartGame 不关心 UI
- StartGame 不维护 lobby 状态,只读取 Room 的权威状态