QTE 时间缩放

评评① 0 做的剧情演出模块：按键 QTE + 全局时间膨胀（子弹时间）。 场景进演出态时把世界时间缩到 0.5 倍、玩家正常输入，倒计时归零判失败； 成功则把玩家抛物线投掷到目标点并接技能/蒙太奇。 难点全在边界：顶号竞态、首次按键立刻恢复时间、失败事件订阅时序。

1. 工作清单

2. 理论：时间膨胀仲裁与 QTE 状态机

2.1 全局时间膨胀：多个来源谁说了算

2.2 QTE 生命周期状态机

3. 代码片段

3.1 StartQte：钳制 + 句柄注册

Src\Game\World\Entity\Character\SceneItem\EtQteTimeScaleComponent.ts:211-243（节选）

private StartQte(): void {
    if (this.CurrentState) { return; }
    if (!this.DataComp) { return; }
    this.CurrentState = true;
    this.RemainingTimeMs = this.DataComp.CountdownTime * TimerSystemConstants.SecondToMillisecond;
    this.CurInputCount = 0;
    this.IsTimeDilationRemoved = false;
    this.IsSuccessTriggered = false;

    const timeDilationScale = Math.max(0, Math.min(1, this.DataComp.TimeDilationScale ?? 0.5));
    this.TimeDilationHandle = TimeDilationController.AddGlobalTimeDilationFromValue(
        timeDilationScale,
        this.DataComp.CountdownTime,
        0,
        ETimeDilationSourceType.Default,
    );

    ControllerHolder.InputDistributeController.BindAction(this.DataComp.KeyValue, this.OnInputKeyPress);

    if (!UiInterfaceHelper.IsViewOpen(EUiViewName.QteButtonContinuousView)) {
        UiInterfaceHelper.OpenView(EUiViewName.QteButtonContinuousView, this.EntityHandle?.Id);
    }
    ...
}

3.2 OnInputKeyPress：四重防御 + 首次按键恢复时间

Src\Game\World\Entity\Character\SceneItem\EtQteTimeScaleComponent.ts:423-445（节选）

private readonly OnInputKeyPress = (actionName: string, actionType: EActionType): void => {
    if (!this.CurrentState || !this.DataComp || actionType !== EActionType.Press || this.IsSuccessTriggered) {
        return;
    }

    if (!this.IsTimeDilationRemoved) {                       // 首次有效按键：立刻移除全局膨胀
        TimeDilationController.RemoveGlobalTimeDilation(this.TimeDilationHandle);
        this.IsTimeDilationRemoved = true;
    }

    this.CurInputCount++;
    ...
    if (this.CurInputCount >= this.DataComp.InputCount) {
        this.IsSuccessTriggered = true;
        this.CurrentState = false;
        this.RemainingTimeMs = 0;
        ControllerHolder.InputDistributeController.UnBindAction(this.DataComp.KeyValue, this.OnInputKeyPress);
        ...
    }
};

3.3 OnTick：倒计时 + 抛物线位移

Src\Game\World\Entity\Character\SceneItem\EtQteTimeScaleComponent.ts:103-128（节选）

protected override OnTick(deltaMs: number): void {
    if (this.CurrentState) {
        this.RemainingTimeMs -= deltaMs;
        if (this.RemainingTimeMs <= 0) {
            this.OnQteFailed();
        }
    }

    if (this.IsMoving && this.StartLocation && this.TargetLocation) {
        const elapsedMs = Time.GetClientRealTimeMs() - this.MoveStartTime;
        const alpha = Math.min(elapsedMs / this.MoveDurationMs, 1);
        const currentLocation = Vector.Create();

        const movePathType = this.DataComp?.MovePathType ?? EQteMovePathType.Straight;
        if (movePathType === EQteMovePathType.Parabola) {
            const parabolaHeight = this.DataComp?.ParabolaHeight ?? 200.0;
            const horizontalLocation = Vector.Create();
            Vector.Lerp(this.StartLocation, this.TargetLocation, alpha, horizontalLocation);

            const heightOffset = 4 * parabolaHeight * alpha * (1 - alpha);
            currentLocation.X = horizontalLocation.X;
            currentLocation.Y = horizontalLocation.Y;
            currentLocation.Z = horizontalLocation.Z + heightOffset;
        } else {
            Vector.Lerp(this.StartLocation, this.TargetLocation, alpha, currentLocation);
        }
        ...
    }
}

3.4 RefreshLevelState：顶号竞态 + 延迟一帧 Emit

Src\Game\World\Entity\Character\SceneItem\EtQteTimeScaleComponent.ts:180-209（节选）

if (tag === GameplayTagUtils.GetGameplayTagByName(entityStateConfig.激活态.激活)) {
    if (isFirstSync) {
        // 顶号场景：B客户端登录时继承了上一个客户端留下的激活态，直接判失败，不显示界面
        // 延迟一帧Emit，等CheckQteCompleteNode等任务节点完成事件订阅，否则Failed事件会被丢失导致任务卡住
        Log.Info(ELogModule.Level, ELogAuthor.ZZB, 'QTE剧情时间缩放-继承激活态直接失败', ['Reason', '顶号/重登']);
        const entityId = this.EntityId!;
        const prefabDataId = this.EntityHandle?.PrefabDataId;
        this.OwnedTimers.Next(() => {
            EventSystem.Emit(EEventName.QteTimeScaleFailed, entityId, prefabDataId);
        }, 'EtQteTimeScaleComponent.RefreshLevelState');
    } else {
        this.StartQte();
    }
}

3.5 时间膨胀仲裁：优先级队列只认队首

Src\Game\Module\TimeDilation\TimeDilationNode.ts:58-94（节选）

public UpdateTimeDilation(): void {
    let newTimeDilation = 1;
    let isStrongTimeDilation = false;
    let affectCamera = false;
    if (this.IsPause()) {
        newTimeDilation = 0;
    } else {
        const currentTime = Time.NowSeconds();
        const model = ModelManager.TimeDilationModel!;
        while (!this.TimeDilationPriorityQueue.Empty) {
            // 获取优先级最高的且未结束的时间膨胀，仅计算它的当前值。其他优先级低的时间膨胀不予计算。
            const top = this.TimeDilationPriorityQueue.Top;
            if (!top) { break; }
            const topDilation = model.GetTimeDilation(top)!;
            if (topDilation.EndTime < 0 || topDilation.EndTime > currentTime) {
                newTimeDilation = topDilation.CurrentTimeDilation;
                isStrongTimeDilation = topDilation.IsStrongTimeDilation;
                affectCamera = topDilation.AffectCamera;
                break;
            }
            this.RemoveTimeDilation(top);                          // 队首已过期，弹出看下一个
        }
    }

    if (newTimeDilation !== this.TimeDilationInternal || affectCamera !== this.AffectCameraInternal) {
        this.TimeDilationInternal = newTimeDilation;
        this.AffectCameraInternal = affectCamera;
        if (newTimeDilation >= 0 && newTimeDilation !== Number.POSITIVE_INFINITY) {
            this.TimeDilationChangeHandler(newTimeDilation, isStrongTimeDilation, affectCamera);
        } else {
            Log.Error(ELogModule.TimeDilation, ELogAuthor.CYH, '时间膨胀数值非法！', ['Dilation', newTimeDilation]);
        }
    }
}

4. 面试怎么讲