流送与场景加载

底座页：进一个关卡时客户端到底发生了什么—— 命令链把服务器全量数据一次性灌进各玩法 Model（全量初值模式）， 运行时各系统增量协议接管； 64 位 Long ID 转 JS number 的精度边界用统一收口 + 溢出 Critical治理； 同 WP 无缝传送靠流送源跟随（两盏灯）+ 三段式预加载和传送链路衔接。

1. 工作清单

2. 理论：进关那一刻的客户端管线

2.1 全量初值 + 运行时增量：框架级同步模式

每个玩法系统都遵循同一条数据节奏：进关卡/重连时服务器一次性给全量初始态， 运行时走增量协议。落点全部集中在一条命令里：

2.2 命令链：进关流程的积木化

2.3 64 位 ID 治理：Long → number 的精度边界

2.4 无缝传送与流送：两盏灯 + 三段式预加载

普通跨关卡传送 = 卸载 → 加载两段场景；同 WP 无缝传送 = 源和目标在同一大世界流送范围内时，不整卸整载， 流送源（两盏灯：跟玩家走的加载范围灯 + 跟传送预加载走的灯）直接滑过去； 跨范围传送走三段式预加载：预加载 → 完成 → 还原 / 取消， 传送吟唱期间把目标格子先拉起来，取消则还原。 细节展开在深页：

3. 代码片段

3.1 全量初值：一条命令灌满所有玩法

Src\Game\World\SceneLoading\Commands\SceneLoadingCmds\ServerLevelCmd\SceneLoadingApplyLevelInfoCmd.ts:9-55

export class SceneLoadingApplyLevelInfoCmd extends SceneLoadingCommandBase<SceneLoadingCmdContext> {
    protected override OnExecute(context: SceneLoadingCmdContext | undefined): void {
        const levelInfo = context!.ServerSceneData;
        if (!levelInfo) {
            this.FailCritical('未提供关卡信息');
            return;
        }

        ModelManager.DungeonModel!.SetCurrentDungeonInfo(levelInfo.dungeonInfo);
        if (levelInfo.dungeonInfo?.settleInfo) {
            ModelManager.DungeonModel!.SetSettleInfo(levelInfo.dungeonInfo.settleInfo);
        }
        const isInMatch = levelInfo.dungeonInfo?.matchInfo?.isInMatch;
        if (isInMatch !== undefined && !isInMatch) {
            ControllerHolder.MatchingController.TryCloseMatchingView();
        }

        // 燃值信息
        ModelManager.FirePointModel!.SetInfo(levelInfo.firePointInfo);

        ModelManager.CombatMessageModel!.SynchronizeSequenceInfo(levelInfo.battleSeqInfo);

        ModelManager.PoisonZoneModel!.SetInfo(levelInfo.poisonZoneInfo);

        // 副本集合区域全量初值（进关卡时生效的集合区，运行时增量走 14050）
        ModelManager.DungeonGatherModel!.SetInfo(levelInfo.gatherInfo);

        ModelManager.MapModel!.SyncTreasureChestMarksFull(
            levelInfo.levelConfigId,
            levelInfo.markTreasureChestConfigIdList,
        );

        if (levelInfo.levelBt?.timerList) {
            // 计时器全量带上归属行为树，行为树移除时才能精确清掉它名下的计时器
            const treeIncId = ControllerHolder.GeneralLogicTreeController.GetTreeIncId(
                levelInfo.levelBt.type,
                levelInfo.levelBt.btTypeId,
            );
            ModelManager.BombTimerModel!.SetList(levelInfo.levelBt.timerList, treeIncId, levelInfo.levelBt.type);
        }

        // 行为树音频状态：进关卡/重连时按服务器全量数据恢复，空串表示无行为树音乐
        AudioMusicBehaviorManager.ApplyAkState(levelInfo.akStateInfo?.akState ?? '', 'EnterLevel');

        EventSystem.Emit(EEventName.OnLevelInfoUpdated);
        this.Succeed();
    }
}

3.2 溢出即 Critical：精度边界的显性化

Src\Core\Utils\LongIdOps.ts:26-38（文件头注释节选）

// 注意：
// 1. bigint 永远是带符号的
// 2. MathUtils.LongToNumber() 的高位是按原样转换的（即，如果 high=-1 low=999 则会转为 ((-1n << 32) | 999n)，是个负数）
// 所以判断位有效范围时需要指定带符号的上下限。

public static GetConstrained64BitId(id: Long | number, context?: string): number {
    const bigIntId = MathUtils.LongToBigInt(id);

    if (bigIntId < LongIdOpsConstants.MinSafe64BitId || bigIntId > LongIdOpsConstants.MaxSafe64BitId) {
        const logPairs: [string, ILogValue][] = [['Id', id]];
        if (context) {
            logPairs.push(['Context', context]);
        }
        Log.Critical(ELogModule.Entity, ELogAuthor.HCS, 'Id位溢出', ...logPairs);
    }

    return Number(bigIntId);
}

3.3 业务层统一收口：GameIdConversions

Src\Game\Utils\GameIdConversions.ts:3-33（节选）

/**
 * {@link LongIdOps} 在业务层的具体使用。
 */
export class GameIdConversions {
    public static ToProtocolId(id: Long | bigint | number): Long | number {
        return LongIdOps.ToProtocolId(id);
    }

    public static GetCreatureDataId(creatureDataId: Long | number): number {
        return LongIdOps.GetConstrained64BitId(creatureDataId, 'CreatureDataId');
    }

    public static GetPlayerId(playerId: Long | number): number {
        return LongIdOps.GetConstrained64BitId(playerId, 'PlayerId');
    }

    public static GetBuffApplicantId(netBuffApplicantId: Long | number): number {
        return LongIdOps.GetConstrained64BitId(netBuffApplicantId, 'BuffId');
    }

    public static GetPrefabDataId(netPrefabDataId: Long | number): number {
        return LongIdOps.GetConstrained64BitId(netPrefabDataId, 'PrefabDataId');
    }

4. 面试怎么讲