103 lines
3.4 KiB
C#
103 lines
3.4 KiB
C#
|
using System;
|
|||
|
|
using DG.Tweening; // 引入 DOTween
|
|||
|
|
using UnityEngine;
|
|||
|
|
using SLSUtilities.UI;
|
|||
|
|
|
|||
|
|
namespace Cielonos.Core.UI
|
|||
|
|
{
|
|||
|
|
// 继承 UIElementBase，同时实现简单的单例逻辑
|
|||
|
|
public class ScreenFader : UIElementBase
|
|||
|
|
{
|
|||
|
|
public static ScreenFader Instance { get; private set; }
|
|||
|
|
|
|||
|
|
[Header("Settings")]
|
|||
|
|
[SerializeField] private float defaultDuration = 0.5f;
|
|||
|
|
[SerializeField] private bool startBlack = true;
|
|||
|
|
[SerializeField] private Ease fadeEase = Ease.InOutQuad; // 暴露曲线设置，比 SmoothStep 更灵活
|
|||
|
|
|
|||
|
|
private Tween currentTween; // 记录当前动画，防止冲突
|
|||
|
|
|
|||
|
|
private void Awake()
|
|||
|
|
{
|
|||
|
|
// --- 单例逻辑 ---
|
|||
|
|
if (Instance != null && Instance != this)
|
|||
|
|
{
|
|||
|
|
Destroy(gameObject);
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
Instance = this;
|
|||
|
|
// ----------------
|
|||
|
|
|
|||
|
|
// 初始化状态
|
|||
|
|
if (canvasGroup == null) canvasGroup = GetComponent<CanvasGroup>();
|
|||
|
|
|
|||
|
|
if (startBlack)
|
|||
|
|
{
|
|||
|
|
canvasGroup.alpha = 1f;
|
|||
|
|
canvasGroup.blocksRaycasts = true;
|
|||
|
|
}
|
|||
|
|
else
|
|||
|
|
{
|
|||
|
|
canvasGroup.alpha = 0f;
|
|||
|
|
canvasGroup.blocksRaycasts = false;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
private void OnDestroy()
|
|||
|
|
{
|
|||
|
|
// 这是一个好习惯：销毁时杀掉所有未完成的动画，防止报错
|
|||
|
|
currentTween?.Kill();
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 变黑 (Fade Out / 遮挡屏幕)
|
|||
|
|
/// </summary>
|
|||
|
|
public Tween FadeToBlack(float duration = -1, Action onComplete = null)
|
|||
|
|
{
|
|||
|
|
return FadeTo(1f, duration, onComplete);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 变亮 (Fade In / 显示屏幕)
|
|||
|
|
/// </summary>
|
|||
|
|
public Tween FadeToClear(float duration = -1, float delay = 1, Action onComplete = null)
|
|||
|
|
{
|
|||
|
|
return FadeTo(0f, duration, onComplete).SetDelay(delay);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 通用淡入淡出逻辑
|
|||
|
|
/// 返回 Tween 对象，允许外部使用 yield return tween.WaitForCompletion();
|
|||
|
|
/// </summary>
|
|||
|
|
private Tween FadeTo(float targetAlpha, float duration, Action onComplete)
|
|||
|
|
{
|
|||
|
|
// 1. 如果有正在运行的动画，立刻杀掉，确保从当前 alpha 开始新的变化
|
|||
|
|
currentTween?.Kill();
|
|||
|
|
|
|||
|
|
float d = duration < 0 ? defaultDuration : duration;
|
|||
|
|
|
|||
|
|
// 2. 只有在变黑（alpha -> 1）开始时，才阻挡射线
|
|||
|
|
// 这样防止玩家在变黑过程中还能点击后面的按钮
|
|||
|
|
if (targetAlpha > 0.5f)
|
|||
|
|
{
|
|||
|
|
canvasGroup.blocksRaycasts = true;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 3. 使用 DOTween
|
|||
|
|
currentTween = canvasGroup.DOFade(targetAlpha, d)
|
|||
|
|
.SetEase(fadeEase)
|
|||
|
|
.SetUpdate(true) // 【关键】忽略 TimeScale，游戏暂停时依然可以淡入淡出
|
|||
|
|
.OnComplete(() =>
|
|||
|
|
{
|
|||
|
|
// 只有在完全变亮（alpha -> 0）结束后，才取消阻挡
|
|||
|
|
if (targetAlpha < 0.01f)
|
|||
|
|
{
|
|||
|
|
canvasGroup.blocksRaycasts = false;
|
|||
|
|
}
|
|||
|
|
onComplete?.Invoke();
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
return currentTween;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|