94 lines
3.1 KiB
C#
94 lines
3.1 KiB
C#
using System.Collections;
|
|
using UnityEngine;
|
|
using TMPro;
|
|
|
|
namespace BaseGames.Tutorial
|
|
{
|
|
/// <summary>
|
|
/// 教程提示 UI 组件（架构 21_LiquidPuzzleModule §17）。
|
|
/// 负责显示/隐藏提示面板和文字；duration ≤ 0 时不自动消隐。
|
|
/// 使用 CanvasGroup 实现淡入淡出，不依赖 Animator。
|
|
/// </summary>
|
|
[RequireComponent(typeof(CanvasGroup))]
|
|
public class TutorialHintUI : MonoBehaviour
|
|
{
|
|
[SerializeField] private TMP_Text _label;
|
|
[SerializeField] private float _fadeSpeed = 4f;
|
|
|
|
private CanvasGroup _cg;
|
|
private Coroutine _autoHideCoroutine;
|
|
private Coroutine _fadeCoroutine;
|
|
|
|
private void Awake()
|
|
{
|
|
_cg = GetComponent<CanvasGroup>();
|
|
_cg.alpha = 0f;
|
|
gameObject.SetActive(false);
|
|
}
|
|
|
|
// ── 公共 API ──────────────────────────────────────────────────────
|
|
/// <summary>淡入显示提示文字。duration ≤ 0 时不自动消隐。</summary>
|
|
public void Show(string text, float duration = 0f)
|
|
{
|
|
if (_label != null) _label.text = text;
|
|
|
|
// 停止所有进行中的动画/定时
|
|
StopAutoHide();
|
|
StopFade();
|
|
|
|
gameObject.SetActive(true);
|
|
_fadeCoroutine = StartCoroutine(FadeTo(1f));
|
|
|
|
if (duration > 0f)
|
|
_autoHideCoroutine = StartCoroutine(AutoHideRoutine(duration));
|
|
}
|
|
|
|
/// <summary>淡出并隐藏提示面板。</summary>
|
|
public void Hide()
|
|
{
|
|
StopAutoHide();
|
|
StopFade();
|
|
_fadeCoroutine = StartCoroutine(FadeOutAndDeactivate());
|
|
}
|
|
|
|
// ── 内部 ──────────────────────────────────────────────────────────
|
|
private void StopAutoHide()
|
|
{
|
|
if (_autoHideCoroutine == null) return;
|
|
StopCoroutine(_autoHideCoroutine);
|
|
_autoHideCoroutine = null;
|
|
}
|
|
|
|
private void StopFade()
|
|
{
|
|
if (_fadeCoroutine == null) return;
|
|
StopCoroutine(_fadeCoroutine);
|
|
_fadeCoroutine = null;
|
|
}
|
|
|
|
private IEnumerator AutoHideRoutine(float duration)
|
|
{
|
|
yield return new WaitForSecondsRealtime(duration);
|
|
Hide();
|
|
_autoHideCoroutine = null;
|
|
}
|
|
|
|
private IEnumerator FadeTo(float target)
|
|
{
|
|
while (!Mathf.Approximately(_cg.alpha, target))
|
|
{
|
|
_cg.alpha = Mathf.MoveTowards(_cg.alpha, target, _fadeSpeed * Time.unscaledDeltaTime);
|
|
yield return null;
|
|
}
|
|
_cg.alpha = target;
|
|
}
|
|
|
|
private IEnumerator FadeOutAndDeactivate()
|
|
{
|
|
yield return FadeTo(0f);
|
|
gameObject.SetActive(false);
|
|
_fadeCoroutine = null;
|
|
}
|
|
}
|
|
}
|