103 lines
4.3 KiB
C#
103 lines
4.3 KiB
C#
using System.Collections;
|
||
using UnityEngine;
|
||
using BaseGames.Core;
|
||
|
||
namespace BaseGames.Combat
|
||
{
|
||
/// <summary>
|
||
/// 命中冻帧服务接口。
|
||
/// </summary>
|
||
public interface IHitStopService
|
||
{
|
||
/// <summary>冻帧 <paramref name="frames"/> 帧（以 fixedDeltaTime 换算为实际时长）。</summary>
|
||
void FreezeFrames(int frames);
|
||
/// <summary>冻帧指定时长（Unscaled 秒）。</summary>
|
||
void FreezeDuration(float unscaledSeconds);
|
||
/// <summary>游戏正常时间缩放（默认 1）；子弹时间等功能修改此属性。</summary>
|
||
float BaseTimeScale { get; set; }
|
||
}
|
||
|
||
/// <summary>
|
||
/// 命中冻帧服务（HitStop）（架构 06_CombatModule §16）。
|
||
/// 通过短暂将 Time.timeScale 设为 0 实现"冻帧"效果，强化打击感。
|
||
/// 常驻 Persistent 场景，由 GameManager 持有；通过 ServiceLocator 注册访问。
|
||
///
|
||
/// 设计说明：
|
||
/// - 多次并发请求取最长持续时间（StopCoroutine + 重启）
|
||
/// - 使用 WaitForSecondsRealtime 确保 timeScale=0 时协程仍能恢复
|
||
/// - OnDestroy 强制还原 timeScale，防止异常退出导致游戏卡死
|
||
/// </summary>
|
||
[DefaultExecutionOrder(-400)]
|
||
public class HitStopManager : MonoBehaviour, IHitStopService
|
||
{
|
||
/// <summary>游戏正常时间缩放（默认 1）；通过属性读取以便外部修改子弹时间时保留基准值。</summary>
|
||
public float BaseTimeScale
|
||
{
|
||
get => _baseTimeScale;
|
||
set => _baseTimeScale = Mathf.Clamp(value, 0.01f, 10f);
|
||
}
|
||
private float _baseTimeScale = 1f;
|
||
|
||
private Coroutine _activeRoutine;
|
||
private float _freezeEndTime;
|
||
|
||
// ── 生命周期 ──────────────────────────────────────────────────────
|
||
|
||
private void Awake()
|
||
{
|
||
if (ServiceLocator.GetOrDefault<IHitStopService>() != null) { Destroy(gameObject); return; }
|
||
ServiceLocator.Register<IHitStopService>(this);
|
||
}
|
||
|
||
private void OnDestroy()
|
||
{
|
||
// 安全恢复：防止场景卸载/异常退出时 timeScale 永久为 0
|
||
Time.timeScale = _baseTimeScale;
|
||
ServiceLocator.Unregister<IHitStopService>(this);
|
||
}
|
||
|
||
// ── 公共 API ──────────────────────────────────────────────────────
|
||
|
||
/// <summary>
|
||
/// 冻帧 <paramref name="frames"/> 帧（以 fixedDeltaTime 换算为实际时长）。
|
||
/// 若已有冻帧进行中，取两者中持续时间较长的（避免短请求截断较长的冻帧）。
|
||
/// </summary>
|
||
/// <param name="frames">冻帧帧数（fixedDeltaTime 单位）。0 或负数无效。</param>
|
||
public void FreezeFrames(int frames)
|
||
{
|
||
if (frames <= 0) return;
|
||
FreezeDuration(frames * Time.fixedDeltaTime);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 冻帧指定时长（Unscaled 实际秒数）。
|
||
/// 若已有冻帧进行中，取两者中较长的。
|
||
/// </summary>
|
||
/// <param name="unscaledSeconds">实际时长（秒），不受 timeScale 影响。</param>
|
||
public void FreezeDuration(float unscaledSeconds)
|
||
{
|
||
if (unscaledSeconds <= 0f) return;
|
||
|
||
float newEndTime = Time.unscaledTime + unscaledSeconds;
|
||
// 已有更长的冻帧进行中，放弃短请求，避免截断
|
||
if (_activeRoutine != null && newEndTime <= _freezeEndTime) return;
|
||
|
||
_freezeEndTime = newEndTime;
|
||
if (_activeRoutine != null)
|
||
StopCoroutine(_activeRoutine);
|
||
|
||
_activeRoutine = StartCoroutine(FreezeRoutine(unscaledSeconds));
|
||
}
|
||
|
||
// ── 内部实现 ──────────────────────────────────────────────────────
|
||
|
||
private IEnumerator FreezeRoutine(float unscaledSeconds)
|
||
{
|
||
Time.timeScale = 0f;
|
||
yield return new WaitForSecondsRealtime(unscaledSeconds);
|
||
Time.timeScale = _baseTimeScale;
|
||
_activeRoutine = null;
|
||
}
|
||
}
|
||
}
|