多轮审查和修复

2026-05-12 15:34:08 +08:00
parent f55d2a57c3
commit ebbbb7332e
805 changed files with 838724 additions and 1905 deletions
--- a/Assets/Scripts/UI/LoadingScreenManager.cs
+++ b/Assets/Scripts/UI/LoadingScreenManager.cs
@@ -0,0 +1,80 @@
+using System.Collections;
+using UnityEngine;
+using UnityEngine.UI;
+using TMPro;
+using BaseGames.Core.Events;
+
+namespace BaseGames.UI
+{
+    /// <summary>
+    /// 全屏加载界面：进度条 + 提示文字 + 随机背景图（架构 10_UIModule §7.7）。
+    /// 注：提示文字直接使用字符串 key（P4-5 本地化模块完成后替换为 LocalizationManager.Get）。
+    /// </summary>
+    public class LoadingScreenManager : MonoBehaviour
+    {
+        [SerializeField] private GameObject  _loadingRoot;
+        [SerializeField] private Image       _progressFill;
+        [SerializeField] private TMP_Text    _tipText;
+        [SerializeField] private Image[]     _backgroundArts;
+        [SerializeField] private string[]    _tipMessages;           // 直接文字（非本地化 key）
+        [SerializeField] private float       _minDisplayTime = 0.5f;
+
+        [Header("Event Channels")]
+        [SerializeField] private VoidEventChannelSO   _onLoadingStarted;
+        [SerializeField] private VoidEventChannelSO   _onLoadingComplete;
+        [SerializeField] private FloatEventChannelSO  _onLoadingProgressUpdated;
+
+        private float _shownAt;
+
+        private void OnEnable()
+        {
+            if (_onLoadingStarted            != null) _onLoadingStarted.OnEventRaised           += Show;
+            if (_onLoadingComplete           != null) _onLoadingComplete.OnEventRaised          += Hide;
+            if (_onLoadingProgressUpdated    != null) _onLoadingProgressUpdated.OnEventRaised   += SetProgress;
+        }
+        private void OnDisable()
+        {
+            if (_onLoadingStarted            != null) _onLoadingStarted.OnEventRaised           -= Show;
+            if (_onLoadingComplete           != null) _onLoadingComplete.OnEventRaised          -= Hide;
+            if (_onLoadingProgressUpdated    != null) _onLoadingProgressUpdated.OnEventRaised   -= SetProgress;
+        }
+
+        // ── 公开 API（SceneLoader 可直接调用）────────────────────────────────
+
+        public void Show()
+        {
+            _shownAt = Time.unscaledTime;
+            if (_loadingRoot != null) _loadingRoot.SetActive(true);
+            if (_progressFill != null) _progressFill.fillAmount = 0f;
+
+            // 随机背景
+            if (_backgroundArts != null && _backgroundArts.Length > 0)
+            {
+                foreach (var bg in _backgroundArts) if (bg != null) bg.enabled = false;
+                _backgroundArts[Random.Range(0, _backgroundArts.Length)].enabled = true;
+            }
+
+            // 随机提示
+            if (_tipText != null && _tipMessages != null && _tipMessages.Length > 0)
+                _tipText.text = _tipMessages[Random.Range(0, _tipMessages.Length)];
+        }
+
+        public void Hide() => StartCoroutine(HideAfterMinTime());
+
+        public void SetProgress(float value)
+        {
+            if (_progressFill != null)
+                _progressFill.fillAmount = Mathf.Clamp01(value);
+        }
+
+        // ── 内部 ─────────────────────────────────────────────────────────────
+
+        private IEnumerator HideAfterMinTime()
+        {
+            float elapsed = Time.unscaledTime - _shownAt;
+            if (elapsed < _minDisplayTime)
+                yield return new WaitForSecondsRealtime(_minDisplayTime - elapsed);
+            if (_loadingRoot != null) _loadingRoot.SetActive(false);
+        }
+    }
+}