副本集合区域

评评②做的多人协作引导模块：把散在副本里的玩家聚合到集合区，倒计时归零强制传送。 坑全在「分布式的玩家」上：广播是关卡级（非 AOI 视野）， 倒计时用服务器绝对时间戳（客户端时钟无意义）， UI 的 OpenView 是异步的——通知先到、控件后就绪，刷新会被丢。

1. 工作清单

2. 理论：三个分布式难题与对应决策

2.1 广播范围：为什么不用 AOI

2.2 倒计时：服务器绝对时间戳 + 两终态统一编码

2.3 逐秒刷新：单入口 + 不受时间膨胀影响

3. 代码片段

3.1 广播接收 + 全量初值补刷

Src\Game\Module\DungeonGather\DungeonGatherController.ts:54-75

/** 收到集合广播（14050）：关卡级全员下发，与集合区实体是否在本地视野内无关 */
private readonly OnEntityGatherUpdateSCNotify = (notify: Game.Protocol.WorldEntityGatherUpdateSCNotify): void => {
    const gatherInfo = notify.gatherInfo;
    if (!gatherInfo) { return; }
    Log.Info(ELogModule.Level, ELogAuthor.ZZB, '集合区域-收到集合广播14050',
        ['inRangeNum', gatherInfo.inRangeNum ?? 0],
        ['totalNum', gatherInfo.totalNum ?? 0],
        ['forceTeleportTimeMs', LongIdOps.GetConstrained64BitId(gatherInfo.forceTeleportTimeMs ?? 0)],
    );
    ModelManager.DungeonGatherModel?.SetInfo(gatherInfo);
    this.RefreshTips();
};

/** 进关卡/重连加载完成：用全量集合信息补一次，玩家离集合区再远也能看到提示 */
private readonly OnEndClientLoading = (): void => {
    this.RefreshTips();
};

3.2 RefreshTips：单入口 + 两终态隐藏

Src\Game\Module\DungeonGather\DungeonGatherController.ts:77-105

/** 刷新集合提示。forceTeleportTimeMs=0 时隐藏：服务器 IDLE(未开始) 与 FINISHED(已完成) 都下发 0 */
private RefreshTips(): void {
    const info = ModelManager.DungeonGatherModel?.GetInfo();
    const remainSec = this.GetRemainTeleportSec(info);
    // 无集合信息或无倒计时=未开始或已完成，隐藏 UI 并停止刷新
    if (!info || remainSec <= 0) {
        this.StopCountdownTick();
        ControllerHolder.DungeonGatherTipsController.Hide();
        return;
    }
    const inRangeNum = info.inRangeNum ?? 0;
    const totalNum = info.totalNum ?? 0;
    const dataComp = this.GetGatherDataComp(info);
    const template = this.ResolveText(dataComp?.TidTeleportText, dataComp?.EdTidTeleportText);
    const text = StringUtils.Format(template, `${inRangeNum}`, `${totalNum}`, `${remainSec}`);
    const numText = `（${inRangeNum}/${totalNum}）`;
    this.StartCountdownTick();
    ControllerHolder.DungeonGatherTipsController.Show(numText, text);
}

/** 剩余传送秒数，完全以服务器强制传送时间戳为准；0 = 无倒计时(集合未开始或已完成) */
private GetRemainTeleportSec(info: Game.Protocol.IEntityGatherInfo | undefined): number {
    const forceMs = LongIdOps.GetConstrained64BitId(info?.forceTeleportTimeMs ?? 0);
    if (forceMs > 0) {
        return Math.max(0, Math.ceil((forceMs - Date.now()) / 1000));
    }
    return 0;
}

3.3 逐秒 tick：不膨胀 + 已启动不重复

Src\Game\Module\DungeonGather\DungeonGatherController.ts:128-152

/** 启动倒计时逐秒刷新（已启动则不重复） */
private StartCountdownTick(): void {
    if (this.CountdownTimerId !== undefined) {
        return;
    }
    this.CountdownTimerId = this.OwnedTimers.Forever(
        this.OnCountdownTick,
        1000,
        'DungeonGatherController.StartCountdownTick',
        { Dilation: 1 },
    );
}

/** 倒计时逐秒回调：刷新文本；归零由 RefreshTips 内部隐藏并停止 */
private readonly OnCountdownTick = (): void => {
    this.RefreshTips();
};

3.4 View 异步窗口：PendingText 防丢刷新

Src\Game\Module\Tips\View\DungeonGatherTipsView.ts:23-47

/** 控件就绪前收到的文本，就绪后补刷，避免 OpenView 异步期间的刷新被丢掉 */
private PendingNumText = '';
private PendingText = '';

protected override OnBeforeShow(): void {
    this.TxtNum = this.GetText(EDungeonGatherTipsComponents.TxtNum);
    this.TxtCd = this.GetText(EDungeonGatherTipsComponents.TxtCd);
    const param = this.OpenParam as IDungeonGatherTipsParam | undefined;
    this.RefreshText(this.PendingNumText || (param?.NumText ?? ''), this.PendingText || (param?.Text ?? ''));
}

/** 外部刷新提示文本：numText 上行人数，text 下行配置文案 */
public RefreshText(numText: string, text: string): void {
    this.PendingNumText = numText;
    this.PendingText = text;
    this.TxtNum?.SetText(numText);
    this.TxtCd?.SetText(text);
}

3.5 进关全量初值：与其他世界模块同一入口

Src\Game\World\SceneLoading\Commands\SceneLoadingCmds\ServerLevelCmd\SceneLoadingApplyLevelInfoCmd.ts:26-34（节选）

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

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

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

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

4. 面试怎么讲