坠落重生

玩家掉出世界（穿地、跳崖、地形没加载出来）时的兜底救援系统。 设计核心是「持续记录一个可信的安全点，出事时传回去」。 难点全在什么算「可信」——记错了点，救援反而把玩家送进另一个坑。

1. 模块定位

1.1 两条触发路径

1.2 常量表

class FallingRebornControllerConstants {
    /** 更新坠落重生点的时间间隔 */
    public static readonly UpdateRebornTimeInterval = 30 * TimeUtil.InverseMillisecond;

    /** 坠落重生黑屏时间 */
    public static readonly BlackScreenTime = 0.5 * TimeUtil.InverseMillisecond;

    /** 坠落重生安全检查深度 */
    public static readonly SafeDepth = 2000;

    /** 玩家坠落保底Z坐标检查的CD时间(毫秒) */
    public static readonly FallingRebornZCheckIntervalMs = 500;

    /** 玩家坠落保底默认Z值 */
    public static readonly DefaultLevelPositionMinZ = -10000;
}

2. 核心机制：怎么记录一个「可信的」重生点

2.1 UpdateFallingReborn 的三道闸

private UpdateFallingReborn(): boolean {
    if (this.IsInRebornProcess) { return false; }        // 闸①：重生中不记
    const playerEntity = Global.PlayerEntity;
    if (!playerEntity) { return false; }
    const characterActorComp = playerEntity.GetComponent(EComponent.CharacterActorComponent);
    if (!characterActorComp) { return false; }
    const centerLocation = characterActorComp.ActorLocationProxy;

    // 闸②：距离变化太小，为节省性能，不更新坐标
    const distSquared = centerLocation
        .Subtraction(this.FallingRebornLocation, this.TempVector).SizeSquared();
    const minUpdateDist = 352;
    if (distSquared < minUpdateDist * minUpdateDist) { return true; }

    // 闸③：在规格为[-n, n]的方形中进行地形检查，只有可站立的静态地形，才更新坠落重生点
    const horizontalDist = 132;
    const verticalDist = 176;
    const n = 1;                                  // n=1 → i,j ∈ {-1,0,1} → 3x3 = 9 条射线
    for (let i = -n; i <= n; i++) {
        for (let j = -n; j <= n; j++) {
            offset.Set(horizontalDist * i, horizontalDist * j, 0);
            // start = center + offset ；end = start - (0,0,176)
            if (!TraceElementCommon.LineTrace(this.TraceElement, '[坠落重生]')) {
                // 没有命中物体，说明角色下方处于浮空，不更新坠落重生点
                return false;
            }
        }
    }

    // 通过所有检查，更新坠落重生点
    this.FallingRebornLocation.DeepCopy(characterActorComp.ActorLocation);
    this.FallingRebornRotation.Yaw = characterActorComp.ActorRotation.Yaw;
    this.RefreshFallingRebornLookAtLocation();
    return true;
}

2.2 双速刷新

范围盒用栈管理（PushUpdateRebornArea / PopUpdateRebornArea）， 支持嵌套。栈顶决定当前行为。

2.3 LookAtLocation：重生后看向哪

/**
 * 根据栈顶 BP_UpdateFallingRebornArea_C 的 ShouldLookAtLocation 决定是否记录 LookAtLocation 的位置。
 * 为 true 时，记录其 LookAtLocation 组件的世界坐标；否则清空记录。
 */
private RefreshFallingRebornLookAtLocation(): void {
    const top = this.UpdateRebornAreaStack[this.UpdateRebornAreaStack.length - 1];
    if (!top || !top.ShouldLookAtLocation || !top.LookAtLocation) {
        this.FallingRebornLookAtLocation = undefined;
        return;
    }
    this.FallingRebornLookAtLocationInternal
        .FromUeVector(top.LookAtLocation.K2_GetComponentLocation());
    this.FallingRebornLookAtLocation = this.FallingRebornLookAtLocationInternal;
}

用途：跳跃关卡里玩家掉下去后，重生时应该面朝前进方向， 而不是面朝掉下去时的乱七八糟朝向。策划在范围盒上摆一个 LookAtLocation 组件指方向。

3. Z 轴保底检测

private readonly CheckPlayerUnderZMin = (): void => {
    // 重生过程中无需检测
    if (this.IsInRebornProcess) { return; }

    // 加载过程中，由于地形未生成，角色会无限坠落，此时不要触发坠落重生
    if (ModelManager.GameModeModel?.IsLoadingAnyScene) { return; }

    const playerEntity = Global.PlayerEntity;
    if (!playerEntity) { return; }
    const characterActorComp = playerEntity.GetComponent(EComponent.CharacterActorComponent);
    if (!characterActorComp) { return; }

    if (characterActorComp.ActorLocationProxy.Z >= this.FallingRebornZMin) { return; }

    Log.Info(ELogModule.Level, ELogAuthor.TJH,
        '[坠落重生] 玩家Z坐标低于关卡允许的最小Z值，触发坠落重生',
        ['当前Z', characterActorComp.ActorLocationProxy.Z],
        ['最小Z', this.FallingRebornZMin]);

    this.FallingRebornAction(playerEntity, 0);
};

4. 三步执行流程

Step 1 · FallingRebornAction — 加锁 + 请求服务器

public FallingRebornAction(entityHandle: EntityHandle, fallingRebornConfigId: number): void {
    // 重生过程中不能再次重生
    if (this.IsInRebornProcess) { return; }

    this.IsInRebornProcess = true;                    // 重入锁
    this.CurrentRebornEntityHandle = entityHandle;

    const message = new Nami.Protocol.WorldFallingRebornCSReq();
    message.ruleId = fallingRebornConfigId;
    Net.Call(ERequestMessageId.WorldFallingRebornCSReq, message, (response) => {
        void this.FallingRebornAction_Step2(response);
    });
}

IsInRebornProcess 是全模块最重要的一个标志位， 被 4 处前置判断（函数开头「条件不满足就直接 return」的挡门语句）引用。

Step 2 · 确定重生点（最复杂的一步）

全零坐标防护（真实 bug 的修复）

if (fallingRebornConfig?.RebornLocationRule === 1 && response.position !== undefined) {
    const position = response.position;
    // 服务器没有记录个人复活点时会下发全零坐标，此时不能采用，否则会把玩家传到世界原点
    if (position.x !== 0 || position.y !== 0 || position.z !== 0) {
        this.TempOverrideRebornLocation.Set(position.x, position.y, position.z);
        rebornLocation = this.TempOverrideRebornLocation;
        this.TempOverrideRebornRotation.Set(0, response.yaw ?? 0, 0);
        rebornRotation = this.TempOverrideRebornRotation;
    } else {
        Log.Warn(ELogModule.Level, ELogAuthor.ZZB,
            '[坠落重生] 服务器个人复活点为全零坐标，回退使用客户端记录的坠落重生点');
    }
}

二次安全校验 CalculateSafeRebornLocation

public CalculateSafeRebornLocation(
    originLocation: Readonly<Vector>, zOffsetStart: number, zOffsetEnd: number,
): [Readonly<Vector>, boolean] {
    // 从重生点向下发打射线，如果下方悬空，把重生点更新到安全位置
    if (Global.BaseCharacter && this.TraceElement) {
        // start = origin + zOffsetStart ；end = origin + zOffsetEnd（-2000）
        if (!TraceElementCommon.LineTrace(this.TraceElement, '[坠落重生]')) {
            // 没有命中物体，下方悬空，把重生点更新到安全位置（g.关卡.xlsx LevelBronPosition）
            const levelConfig = configLevelConfigById.GetConfig(ModelManager.GameModeModel!.LevelId);
            if (levelConfig) {
                const safeLocation = Vector.Create(
                    levelConfig.LevelBornPosition.X,
                    levelConfig.LevelBornPosition.Y,
                    levelConfig.LevelBornPosition.Z
                        + Global.BaseCharacter.CapsuleComponent!.GetScaledCapsuleHalfHeight(),
                );
                return [safeLocation, false];   // false = 原点不安全
            }
        }
    }
    return [originLocation, true];             // true = 原点安全
}

Step 3 · 执行位移 + 收尾

private FallingRebornAction_Step3(location: Readonly<Vector>, rotation: Readonly<Rotator>): void {
    const moveSyncComp = this.CurrentRebornEntityHandle?.GetComponent(EComponent.BaseMoveSyncComponent);
    moveSyncComp?.SafeMoveTeleport(location, rotation, '[坠落重生]');

    // 重置相机
    ControllerHolder.CameraController.FightCamera?.LogicComponent?.ResetInitialCameraRotation();

    this.BlackScreenTimerId = TimerSystem.Delay(() => {
        this.BlackScreenTimerId = undefined;
        void this.EndFallingReborn();
    }, FallingRebornControllerConstants.BlackScreenTime);   // 0.5s

    this.IsInRebornProcess = false;                        // 解锁
}

5. 边界情况处理

6. 性能优化点

7. 面试怎么讲