死亡与重生家族

一条线管四件事：死亡复活（濒死/救援/复活全流程）、 坠落重生、边界重生。 共同骨架：死亡/出界判定全在服务端，客户端跑一个四态表现状态机， 复活位置与朝向由服务端下发。本页重点讲死亡复活（模块 8 文件 + 实体组件 2700+ 行）， 坠落/边界链接到站点深页。

1. 工作清单

2. 理论：四态表现状态机 + 双通道协议

服务端维护死亡状态真源，客户端状态机是它的镜像：

协议分双通道：「WorldRole*」管自己，「WorldTeamMember*」管队友—— 自己死了要锁输入开死亡 UI，队友死了只更新救援列表，两条通道的处理重量完全不同。

2.1 复活位置：服务端权威

复活点位置 position 和相机朝向 dirPosition 都是 WorldReviveRoleSCNotify 下发的字段， 客户端只负责应用与旧朝向清理。复活分原地复活与远距离复活传送（带流送+黑屏）两种， 后者由服务端选择安全点。

3. 代码片段

3.1 协议注册全景：23 条通知一次看全

Src\Game\Module\PlayerDeath\PlayerDeathController.ts:94-119（节选）

protected override OnRegisterNetEvent(): void {
    Net.Register(ENotifyMessageId.WorldTeamMemberRescueWaitSCNotify, this.OnTeamMemberPreNearDeathNotify);
    Net.Register(ENotifyMessageId.WorldTeamMemberNearDeathSCNotify, this.OnTeamMemberNearDeathNotify);
    Net.Register(ENotifyMessageId.WorldTeamMemberDeathSCNotify, this.OnTeamMemberDeathNotify);
    Net.Register(ENotifyMessageId.WorldTeamMemberReviveSCNotify, this.OnTeamMemberReviveNotify);
    Net.Register(ENotifyMessageId.WorldTeamMemberRescueSCNotify, this.OnTeamMemberRescueNotify);
    Net.Register(ENotifyMessageId.WorldTeamMemberRescueProgressSCNotify, this.OnMemberRescueProgressNotify);
    // ……本实体通道：WorldRoleNearDeath / WorldRoleDeath / WorldRescueRole
    // WorldReviveRole / WorldCancelRescueRole / WorldRoleEnterReviveWait ……
    Net.Register(ENotifyMessageId.WorldRoleDeathSCNotify, this.OnRoleDeathNotify);
    Net.Register(ENotifyMessageId.WorldReviveRoleSCNotify, this.OnReviveRoleNotify);
    // ……新版救援：WorldRoleEnterBeRescuedState / WorldRescueProgressUpdate /
    // WorldExitNewRescue / WorldNewRescueTimeOut / WorldResumeNewRescueCountDown ……
    Net.Register(ENotifyMessageId.WorldTeamDeadCntSCNotify, this.OnTeamDeadCntNotify);
}

3.2 看门狗：黑屏必须能自己死掉

Src\Game\Module\PlayerDeath\PlayerDeathController.ts:1565-1586

private AddReviveBlackScreen(): void {
    if (this.IsReviveBlackScreenActive) { return; }
    this.IsReviveBlackScreenActive = true;
    // 瞬时黑屏（无渐入动画），立刻遮住画面
    void ControllerHolder.BlackScreenController.AddBlackScreenAsync(
        EBlackScreenAnimType.None, 'PlayerDeathController_ReviveBlackScreen',
    );
    // 保底超时：防止流程中断导致黑屏永远不消失
    this.ReviveBlackScreenTimeoutTimer = this.OwnedTimers.Delay(
        () => {
            Log.Warn(ELogModule.PlayerDeath, ELogAuthor.ZMK, '[PlayerDeathController] 复活黑屏保底超时，强制移除');
            this.ForceRemoveReviveBlackScreen();
        },
        PlayerDeathControllerConstants.ReviveBlackScreenTimeout,   // 60000ms
        'PlayerDeathController.AddReviveBlackScreen',
    );
}

3.3 断线重连补跑复活：本模块最硬的设计

Src\Game\Module\PlayerDeath\PlayerDeathController.ts:1457-1485（节选）

/**
 * 断线重连/无缝传送期间服务端已复活本地玩家，但 WorldReviveRoleSCNotify 在断链窗口丢失
 * 补跑本地复活：同关卡重连保留实体、组件不重置，若不补收尾，
 * 死亡表现（变火/倒地/输入锁）会残留导致角色无法复活。
 */
private ReviveSelfOnMissedNotify(handle: EntityHandle): void {
    // 自己复活，团灭次数清空（与 OnReviveRoleNotify 一致）
    ModelManager.DungeonModel!.ResetLastDungeonDefeatCount();
    // 强制收尾死亡组件：无条件退出濒死 Loco / 清死亡上下文 / 切回 NotStart
    handle.GetComponent(EComponent.RoleDeathComponent)?.ForceReviveReset();
    // 复活收尾：解锁输入 / 恢复特效 / 广播 CharOnRevive（notify 传 undefined，不播被救演出）
    handle.GetComponent(EComponent.RoleReviveComponent)?.HandleRevive(undefined);
    // 结束死亡追踪 + 退出被救援态 + 取消救援他人 + UI 收尾
    this.ExitDeathTrackAndRescue(handle);
    handle.GetComponent(EComponent.RoleRescueComponent)?.TryCancelRescue(ERescueInterruptReason.PlayerDead);
    if (this.IsPlayerDeathViewOpen()) {
        UiInterfaceHelper.CloseView(EUiViewName.PlayerDeathView);
    }
    this.UpdateSelfDeathState(ECharacterDeathState.NotStart, undefined, true);
    this.ShowMainUiChildPanels();
}

3.4 复活通知缓存：流送未完先别播表现

Src\Game\World\Entity\Character\Role\RoleReviveComponent.ts:50-88（节选）

public HandleRevive(notify: Game.Protocol.WorldReviveRoleSCNotify | undefined): void {
    // 本地玩家走"带流送等待的远距离复活传送"时，整个流送结束后再复活
    // 此处先缓存本次复活通知，待 EndReviveTeleport 调 FlushPendingRevive 时再执行。
    const isLocalPlayer = ownerPlayerId === localPlayerId;
    if (isLocalPlayer && ControllerHolder.PlayerDeathController?.IsReviveTeleportInProgress()) {
        this.PendingReviveNotify = notify;
        this.HasPendingRevive = true;
        return;
    }
    this.DoHandleRevive(notify);
}

3.5 死亡蒙太奇三重兜底

Src\Game\World\Entity\Character\Role\RoleDeathComponent.ts:820-857（节选）

// 起播失败时 uid 为 0n，订阅收不到任何东西 —— 直接兜底收尾，避免卡在不能移动的窗口。
// 原判据是 Montage_IsPlaying：那时起播失败会在 EndCallback 挂上之前就同步广播，事后订阅收不到。
if (this.DeathMontageUid === 0n) {
    this.ClearDeathMontageTimer();
    this.HandleDeathFinish();
    return;
}
// 保底：Stop 之后结束事件不一定立即到（引擎入队统一回调），用 Delay(时长) 兜底
const totalLength = montage.GetPlayLength();
this.DeathMontageTimer = this.OwnedTimers.Delay(
    () => { this.OnDeathMontageCompleted(); },
    totalLength * TimerSystemConstants.SecondToMillisecond,
    'RoleDeathComponent.PlayDeathMontage',
);

4. 面试怎么讲