副本结算

0 到 1：通关后黑屏 → 流送结算点位 → MVP 特写 → 全家福合影 → 结算 UI。 后续迭代成三阶段相机流程 + 按队伍站位动态计算相机距离（1 人到 4 人自动构图）。 这是「表现层做到极致」的模块——没有网络同步难题，难的是时序与穿帮。

1. 工作清单

2. 理论：三阶段相机编排

3. 理论：相机距离的 FOV 数学

全家福要「恰好装下所有人」。固定距离在 1 人时太空、4 人时贴脸，所以按站位实时算：

4. 代码片段

4.1 相机调参常量组：每个数字都有注释和来历

Src\Game\Module\Dungeon\LevelSettlement\DungeonSettlementController.ts:49-83

class DungeonSettlementControllerConstants {
    /** 角色体型半径兜底值（CharacterBodyRadius 配置缺省时使用） */
    public static readonly DefaultBodyRadius = 50;
    /** 站位点 Z 轴抬高偏移，避免角色入地 */
    public static readonly SettlementZOffset = 10;
    /** 相机距离计算失败时的兜底值 */
    public static readonly CameraFallbackDistance = 900;
    /** 相机视野角度（FOV，度） */
    public static readonly CameraFov = 60;
    /** 相机距离最小值（防止贴脸） */
    public static readonly CameraMinDistance = 120;
    /** 相机距离最大值（防止过远） */
    public static readonly CameraMaxDistance = 2500
    /** 全家福相机注视点高度（角色身体中部，cm），相机同高实现平视正面合照 */
    public static readonly Seq3LookAtHeight = 100;
    /** 全家福角色正脸朝向修正 Yaw：由实测反推——偏移0时角色偏出相机+90°，故-90可正对相机 */
    public static readonly Seq3FaceYawOffset = -90;
}

4.2 相机距离动态计算（核心算法）

Src\Game\Module\Dungeon\LevelSettlement\DungeonSettlementController.ts:685-724

const originRef = $ref<UE.Vector>(new UE.Vector(0, 0, 0));
const extentRef = $ref<UE.Vector>(new UE.Vector(0, 0, 0));
UE.GameplayStatics.GetActorArrayBounds(actorArray, false, originRef, extentRef);
const origin = $unref(originRef);
const extent = $unref(extentRef);

// 包围盒在水平轴(rightDir)上的投影半宽；左右各留一个身位的余量——
// 余量是固定值，不会随人数增多、总宽度变大而被同步放大
const halfWidth = Math.abs(extent.X * rightDir.X) + Math.abs(extent.Y * rightDir.Y) + horizontalMargin;
const halfHeight = extent.Z;

const halfHorizontalFovRad = MathUtils.DegToRad * (Constants.CameraFov * 0.5);
const halfVerticalFovRad = Math.atan(
    Math.tan(halfHorizontalFovRad) / Constants.CameraAspectRatio,
);
const distanceByWidth = halfWidth / Math.tan(halfHorizontalFovRad);
const distanceByHeight = halfHeight / Math.tan(halfVerticalFovRad);
const distance = MathUtils.Clamp(
    Math.max(distanceByWidth, distanceByHeight),
    Constants.CameraMinDistance,
    Constants.CameraMaxDistance,
);

4.3 Play+Pause 定格首帧 + 换装后才关黑屏

Src\Game\Module\Dungeon\LevelSettlement\DungeonSettlementController.ts:386-428（节选）

if (player) {
    if (!this.Gm) {
        // PlaybackSettings 是结构体，必须读-改-写回，直接改字段不会生效
        const playbackSettings = player.PlaybackSettings;
        playbackSettings.bPauseAtEnd = true;
        player.PlaybackSettings = playbackSettings;
    }
    player.OnFinished.Add(() => {
        // Seq2 结束 = 阶段2 结束，进入阶段3；销毁 3D proxy 避免 UI 阶段穿帮
        this.ClearProxyActors();
    });
}

// 换装完成（或超时/GM 跳过）后才算准备好，避免关黑屏后出现"先默认皮、后换装"的穿帮帧
this.ApplyMvpAvatarToSeq2(this.LevelSequenceActor2, () => {
    if (!this.LevelSequenceActor2 || !ObjectUtils.IsValid(this.LevelSequenceActor2)) {
        finishOnce();   // 换装/超时兜底可能在结算已结束后才触发，此时 Seq2 已销毁
        return;
    }
    // Play+Pause 让序列绑定生效并定格首帧，相机同步就位，画面在黑屏下备好
    this.LevelSequencePlayer2?.Play();
    this.LevelSequencePlayer2?.Pause();
    const cameraActor = this.GetBindingPositionByTag('DungeonSettlementCamera2');
    if (cameraActor) {
        CameraManager.SwitchCamera(cameraActor, ECameraMode.Level, '副本结算-切换相机2');
    }
    this.Seq2Ready = true;
});

5. 面试怎么讲