ichni_Official/Assets/Scripts/Settings/SettingsManager.cs

using Ichni.Menu;
using Ichni.UI;
using System.Collections;
using System.Collections.Generic;
using Sirenix.OdinInspector;
using UnityEngine;
using UnityEngine.Localization;
using UnityEngine.Localization.Settings;
using UnityEngine.Rendering;
using UnityEngine.Rendering.Universal;
using UnityEngine.ResourceManagement.AsyncOperations;
using UnityEngine.SceneManagement;
using UnityEngine.Serialization;

namespace Ichni
{
    // MenuManager.Start 会直接读取已加载的设置，因此 SettingsManager 必须先完成 Start。
    [DefaultExecutionOrder(-10000)]
    public class SettingsManager : SerializedMonoBehaviour
    {
        private const string SettingsSaveFileName = "SettingsSave.json";
        private const string SettingsSaveKey = "SettingsSave";

        private const string PerformantQualityName = "Performant";
        private const string BalancedQualityName = "Balanced";
        private const string HighFidelityQualityName = "High Fidelity";

        /// <summary>新建存档、无效 Code 与无法迁移的旧数据统一回退到的 Locale。</summary>
        public const string DefaultLocaleCode = "zh-CN";

        /// <summary>
        /// 旧版 <see cref="SettingsSaveData.languageIndex"/> 与设置页面下拉框的固定对应关系。
        /// <para>该数组不从 Addressables Catalog 动态读取；Catalog 条目顺序不是稳定的存档契约。</para>
        /// <para>新存档不会保存数组索引，而是保存 <see cref="SettingsSaveData.languageCode"/>。保留本数组仅为迁移旧 ES3 数据与驱动当前下拉框。</para>
        /// </summary>
        private static readonly string[] LegacyLanguageIndexToCode =
        {
            "zh-CN",
            "en",
            "zh-TW",
            "ja",
            "ko",
            "vi-VN",
            "th"
        };

        public static SettingsManager instance;
        
        [FormerlySerializedAs("settingsPage")] 
        public SettingsUIPage settingsUIPage;

        [FormerlySerializedAs("gameSettings")]
        public SettingsSaveData settingsSaveData;

        // 记录相机在玩家关闭后处理前的原始状态。重新开启时必须恢复原始值，不能无条件将所有相机改为开启。
        private readonly Dictionary<int, bool> postProcessingCameraStates = new Dictionary<int, bool>();

        // 语言切换请求统一由一个协程串行处理。协程运行期间的新请求只覆盖目标 Locale Code。
        private Coroutine applyLanguageSettingsCoroutine;
        private bool isLanguageRoutineRunning;
        private string pendingLanguageCode;

        private void Awake()
        {
            if (instance == null)
            {
                instance = this;

                DontDestroyOnLoad(gameObject);
                SceneManager.sceneLoaded += OnSceneLoaded;
                RenderPipelineManager.beginCameraRendering += ApplyPostProcessingSettingBeforeCameraRender;
            }
            else
            {
                Destroy(gameObject);
            }
        }

        private void OnDestroy()
        {
            if (instance != this)
            {
                return;
            }

            SceneManager.sceneLoaded -= OnSceneLoaded;
            RenderPipelineManager.beginCameraRendering -= ApplyPostProcessingSettingBeforeCameraRender;

            if (applyLanguageSettingsCoroutine != null)
            {
                StopCoroutine(applyLanguageSettingsCoroutine);
                applyLanguageSettingsCoroutine = null;
            }

            isLanguageRoutineRunning = false;
            instance = null;
        }

        private void Start()
        {
            LoadGameSettings();
        }
        
        [Button]
        public void SaveGameSettings()
        {
            string savePath = Application.persistentDataPath + "/GameData/" + SettingsSaveFileName;
            ES3.Save(SettingsSaveKey, settingsSaveData, savePath);
        }
        
        [Button]
        public void LoadGameSettings()
        {
            string savePath = Application.persistentDataPath + "/GameData/" + SettingsSaveFileName;
            bool migratedLegacyLanguageIndex = false;
            bool migratedUiEffectsSetting = false;
            if (ES3.FileExists(savePath))
            {
                // 保留原有 ES3 Key，确保本次数据模型重命名不会让已有本地设置失效。
                settingsSaveData = ES3.Load<SettingsSaveData>(SettingsSaveKey, savePath);
            }
            else
            {
                settingsSaveData = CreateDefaultSettingsSaveData();
            }

            migratedLegacyLanguageIndex = MigrateLanguageCodeIfNeeded();
            migratedUiEffectsSetting = MigrateUiEffectsSettingIfNeeded();
            ApplyAudioSettings();
            ApplyGraphicSettings();
            ApplyLanguageSettings();

            // 旧语言索引只应参与一次迁移；立刻写回稳定 Code，避免每次启动都重复依赖旧字段。
            if (migratedLegacyLanguageIndex || migratedUiEffectsSetting)
            {
                SaveGameSettings();
            }
        }

        /// <summary>
        /// 将音频分类的当前设置写入 Wwise RTPC。
        /// </summary>
        public void ApplyAudioSettings()
        {
            AkUnitySoundEngine.SetRTPCValue("MasterVolume", settingsSaveData.masterVolume);
            AkUnitySoundEngine.SetRTPCValue("MusicVolume", settingsSaveData.musicVolume);
            AkUnitySoundEngine.SetRTPCValue("SoundFXVolume", settingsSaveData.soundEffectVolume);
            AkUnitySoundEngine.SetRTPCValue("UIVolume", settingsSaveData.uiVolume);
            ApplyInGameAudioEffectsSettings();
        }

        /// <summary>
        /// 应用游戏内音乐特效开关。关闭时立即清除歌曲正在使用的高通与低通滤波，
        /// 防止设置变更后残留上一帧的 RTPC 值。
        /// </summary>
        public void ApplyInGameAudioEffectsSettings()
        {
            if (settingsSaveData.enableInGameAudioEffects)
            {
                return;
            }

            GameManager.Instance?.songPlayer?.ResetInGameAudioEffects();
        }

        /// <summary>
        /// 将现有图形设置应用到运行时。更细的 Quality、VSync 与平台策略会在 Graphics 分类重构时接入。
        /// </summary>
        public void ApplyGraphicSettings()
        {
            int qualityLevelIndex = GetQualityLevelIndex(settingsSaveData.graphicsQualityPreset);
            if (QualitySettings.GetQualityLevel() != qualityLevelIndex)
            {
                QualitySettings.SetQualityLevel(qualityLevelIndex, true);
            }

            Application.targetFrameRate = settingsSaveData.targetFrame;
            UniversalRenderPipelineAsset currentUrpAsset = GraphicsSettings.currentRenderPipeline as UniversalRenderPipelineAsset;
            currentUrpAsset.renderScale = 0.5f + 0.1f * settingsSaveData.renderScaleLevel;
            ApplyDisplaySettings();
            ApplyPostProcessingSettings();
            ApplyUiEffectsSettings();
        }

        /// <summary>
        /// 应用后处理总开关与 Bloom 档位。
        /// 关闭总开关时，已存在的 URP 相机会直接关闭 <c>renderPostProcessing</c>，并关闭 GameScene 的 Global Volume。
        /// 这样既不会执行原生后处理，也不会执行 ScriptablePostProcessor 的自定义 Render Pass。
        /// </summary>
        public void ApplyPostProcessingSettings()
        {
            bool enablePostProcessing = settingsSaveData.enablePostProcessing;
            UniversalAdditionalCameraData[] cameraDataList =
                FindObjectsByType<UniversalAdditionalCameraData>(FindObjectsInactive.Exclude, FindObjectsSortMode.None);

            foreach (UniversalAdditionalCameraData cameraData in cameraDataList)
            {
                int instanceId = cameraData.GetInstanceID();
                if (!postProcessingCameraStates.ContainsKey(instanceId))
                {
                    postProcessingCameraStates.Add(instanceId, cameraData.renderPostProcessing);
                }

                cameraData.renderPostProcessing = enablePostProcessing && postProcessingCameraStates[instanceId];
            }

            if (PostProcessingManager.Instance != null)
            {
                PostProcessingManager.Instance.ApplySettings(enablePostProcessing, settingsSaveData.bloomQuality);
            }
        }

        /// <summary>
        /// 应用 UI 特效总开关。
        /// <para>
        /// 仅处理显式挂载 <see cref="UiExpandingContoursEffect"/> 的装饰性 UI Image，而不修改共享材质本身。
        /// 这样关闭特效时会移除对应 Shader 的绘制开销，同时保留页面布局和其它 UI 元素。
        /// </para>
        /// <para>
        /// 使用 Include 是为了让当前处于隐藏状态的 SongSelectionPage、SettingsPage 也同步保存目标状态；
        /// 它们下次显示时无需再经过一帧特效可见的过渡。
        /// </para>
        /// </summary>
        public void ApplyUiEffectsSettings()
        {
            if (settingsSaveData == null)
            {
                return;
            }

            UiExpandingContoursEffect[] effectTargets =
                FindObjectsByType<UiExpandingContoursEffect>(FindObjectsInactive.Include, FindObjectsSortMode.None);

            foreach (UiExpandingContoursEffect effectTarget in effectTargets)
            {
                effectTarget.ApplyEnabledState(settingsSaveData.enableUiEffects);
            }
        }

        /// <summary>
        /// 处理场景切换后新加载的相机与 Global Volume。SettingsManager 会跨场景保留，
        /// 因此不能只在首次读取存档时应用一次图形设置。
        /// </summary>
        private void OnSceneLoaded(Scene scene, LoadSceneMode loadSceneMode)
        {
            if (settingsSaveData != null)
            {
                ApplyPostProcessingSettings();
                ApplyUiEffectsSettings();
            }
        }

        /// <summary>
        /// 兜底处理运行时晚于场景加载创建的相机（例如 Theme 或演出对象中的相机）。
        /// 仅在玩家关闭后处理时执行，保证该相机在首次渲染前也不会运行后处理。
        /// </summary>
        private void ApplyPostProcessingSettingBeforeCameraRender(ScriptableRenderContext context, Camera camera)
        {
            if (settingsSaveData == null || settingsSaveData.enablePostProcessing ||
                !camera.TryGetComponent(out UniversalAdditionalCameraData cameraData))
            {
                return;
            }

            int instanceId = cameraData.GetInstanceID();
            if (!postProcessingCameraStates.ContainsKey(instanceId))
            {
                postProcessingCameraStates.Add(instanceId, cameraData.renderPostProcessing);
            }

            cameraData.renderPostProcessing = false;
        }

        /// <summary>
        /// 将 VSync、窗口模式和分辨率立即应用到 Standalone / Unity Editor。
        /// 移动端由系统管理显示模式与分辨率，因此不执行这些设置。
        /// </summary>
        public void ApplyDisplaySettings()
        {
#if UNITY_STANDALONE || UNITY_EDITOR
            QualitySettings.vSyncCount = settingsSaveData.vSyncEnabled ? 1 : 0;

            if (settingsSaveData.displayResolutionWidth <= 0 || settingsSaveData.displayResolutionHeight <= 0)
            {
                settingsSaveData.displayResolutionWidth = Screen.width;
                settingsSaveData.displayResolutionHeight = Screen.height;
            }

            Screen.SetResolution(settingsSaveData.displayResolutionWidth, settingsSaveData.displayResolutionHeight,
                GetFullScreenMode(settingsSaveData.displayMode));
#endif
        }

        /// <summary>
        /// 首次创建设置存档时，继承 Project Settings 为当前平台指定的默认 Quality Level。
        /// 之后玩家的选择由 SettingsSaveData 持久化，不会在下次启动时被平台默认值覆盖。
        /// </summary>
        private SettingsSaveData CreateDefaultSettingsSaveData()
        {
            SettingsSaveData defaultSettings = new SettingsSaveData();
            defaultSettings.uiEffectsSettingInitialized = true;
            defaultSettings.languageCode = DefaultLocaleCode;
            defaultSettings.languageIndex = GetLanguageDropdownIndex(DefaultLocaleCode);
            defaultSettings.graphicsQualityPreset = GetGraphicsQualityPreset(QualitySettings.GetQualityLevel());
#if UNITY_STANDALONE || UNITY_EDITOR
            defaultSettings.displayMode = GetGraphicsDisplayMode(Screen.fullScreenMode);
            defaultSettings.displayResolutionWidth = Screen.width;
            defaultSettings.displayResolutionHeight = Screen.height;
#endif
            return defaultSettings;
        }

        /// <summary>
        /// 将旧版 SettingsSave 中不存在的 UI 特效开关迁移为默认开启。
        /// <para>
        /// 不提升 Schema Version：项目尚未发布，且本字段只补齐一个布尔默认值。迁移标记会随即写回 ES3，
        /// 之后玩家主动关闭 UI 效果时不会被再次覆盖。
        /// </para>
        /// </summary>
        private bool MigrateUiEffectsSettingIfNeeded()
        {
            if (settingsSaveData.uiEffectsSettingInitialized)
            {
                return false;
            }

            settingsSaveData.enableUiEffects = true;
            settingsSaveData.uiEffectsSettingInitialized = true;
            return true;
        }

        private FullScreenMode GetFullScreenMode(GraphicsDisplayMode displayMode)
        {
            return displayMode switch
            {
                GraphicsDisplayMode.Fullscreen => FullScreenMode.ExclusiveFullScreen,
                GraphicsDisplayMode.Windowed => FullScreenMode.Windowed,
                _ => FullScreenMode.FullScreenWindow
            };
        }

        private GraphicsDisplayMode GetGraphicsDisplayMode(FullScreenMode fullScreenMode)
        {
            return fullScreenMode switch
            {
                FullScreenMode.ExclusiveFullScreen => GraphicsDisplayMode.Fullscreen,
                FullScreenMode.Windowed => GraphicsDisplayMode.Windowed,
                _ => GraphicsDisplayMode.BorderlessFullscreen
            };
        }

        /// <summary>
        /// 将存档枚举映射到 Project Settings 中同名的 Quality Level。
        /// 若配置缺失，回退到 Balanced；这是移动端的首发默认档位。
        /// </summary>
        private int GetQualityLevelIndex(GraphicsQualityPreset qualityPreset)
        {
            string qualityName = GetQualityName(qualityPreset);
            string[] qualityNames = QualitySettings.names;
            for (int index = 0; index < qualityNames.Length; index++)
            {
                if (qualityNames[index] == qualityName)
                {
                    return index;
                }
            }

            Debug.LogWarning($"[SettingsManager] 未找到 Quality Level '{qualityName}'，回退至 Balanced。");
            return FindQualityLevelOrFallback(BalancedQualityName);
        }

        /// <summary>
        /// 将当前 Quality Level 索引转换为可保存的枚举。未知的自定义档位统一按 Balanced 保存。
        /// </summary>
        private GraphicsQualityPreset GetGraphicsQualityPreset(int qualityLevelIndex)
        {
            string[] qualityNames = QualitySettings.names;
            if (qualityLevelIndex < 0 || qualityLevelIndex >= qualityNames.Length)
            {
                return GraphicsQualityPreset.Balanced;
            }

            return qualityNames[qualityLevelIndex] switch
            {
                PerformantQualityName => GraphicsQualityPreset.Performant,
                HighFidelityQualityName => GraphicsQualityPreset.HighFidelity,
                _ => GraphicsQualityPreset.Balanced
            };
        }

        private int FindQualityLevelOrFallback(string qualityName)
        {
            string[] qualityNames = QualitySettings.names;
            for (int index = 0; index < qualityNames.Length; index++)
            {
                if (qualityNames[index] == qualityName)
                {
                    return index;
                }
            }

            return Mathf.Clamp(QualitySettings.GetQualityLevel(), 0, qualityNames.Length - 1);
        }

        private string GetQualityName(GraphicsQualityPreset qualityPreset)
        {
            return qualityPreset switch
            {
                GraphicsQualityPreset.Performant => PerformantQualityName,
                GraphicsQualityPreset.HighFidelity => HighFidelityQualityName,
                _ => BalancedQualityName
            };
        }

        /// <summary>
        /// 返回当前存档语言在设置下拉框中的显示索引。
        /// <para>该索引只服务 UI；持久化始终使用 <see cref="SettingsSaveData.languageCode"/>。</para>
        /// </summary>
        public int GetLanguageDropdownIndex()
        {
            return GetLanguageDropdownIndex(GetSavedLanguageCode());
        }

        /// <summary>
        /// 由设置下拉框提交玩家的新语言选择。
        /// <para>所有 UI 必须经由此方法写入语言，避免重新将易变的下拉索引保存为存档契约。</para>
        /// </summary>
        public void SetLanguageByDropdownIndex(int languageIndex)
        {
            string localeCode = GetLocaleCodeFromDropdownIndex(languageIndex);
            settingsSaveData.languageCode = localeCode;

            // 继续维护旧字段，便于仍在本地的旧存档、开发调试和降级检查；运行时不再读取它。
            settingsSaveData.languageIndex = GetLanguageDropdownIndex(localeCode);
            ApplyLanguageSettings();
        }

        /// <summary>
        /// 将当前语言 Code 应用到 Unity Localization 管线。
        /// 本方法只等待 Unity 官方 InitializationOperation，并在其完成后应用玩家最新一次语言选择。
        /// </summary>
        public void ApplyLanguageSettings()
        {
            if (settingsSaveData == null)
            {
                return;
            }

            pendingLanguageCode = GetSavedLanguageCode();

            if (isLanguageRoutineRunning)
            {
                return;
            }

            isLanguageRoutineRunning = true;
            applyLanguageSettingsCoroutine = StartCoroutine(ApplyLanguageSettingsRoutine());
        }

        private IEnumerator ApplyLanguageSettingsRoutine()
        {
            // try/finally 确保协程正常结束、被 StopCoroutine 或发生异常时，运行状态都会被清除。
            try
            {
                // 避开 Dropdown.onValueChanged 当前同步调用栈。
                yield return null;

                // 直接等待 Unity Localization 官方初始化句柄。无需再维护一套平行的
                // Bootstrap 状态机；当 Addressables/场景异步队列可正常推进时，该句柄会自行完成。
                AsyncOperationHandle<LocalizationSettings> initializationOperation =
                    LocalizationSettings.InitializationOperation;
                yield return initializationOperation;
                if (initializationOperation.Status != AsyncOperationStatus.Succeeded)
                {
                    if (initializationOperation.OperationException != null)
                    {
                        Debug.LogException(initializationOperation.OperationException, this);
                    }

                    Debug.LogError("[SettingsManager] Unity Localization 初始化失败，取消语言切换。", this);
                    pendingLanguageCode = null;
                    yield break;
                }

                // 处理流程运行期间收到的最新请求。
                while (!string.IsNullOrEmpty(pendingLanguageCode))
                {
                    string targetLocaleCode = pendingLanguageCode;
                    pendingLanguageCode = null;
                    Locale targetLocale = LocalizationSettings.AvailableLocales.GetLocale(targetLocaleCode);
                    Locale currentLocale = LocalizationSettings.SelectedLocale;

                    if (targetLocale == null)
                    {
                        Debug.LogWarning(
                            $"[SettingsManager] Localization Settings 中不存在 Locale '{targetLocaleCode}'。");
                        continue;
                    }

                    if (currentLocale == targetLocale)
                    {
                        continue;
                    }

                    LocalizationSettings.SelectedLocale = targetLocale;

                    // setter 会同步更新 SelectedLocale，并通知 LocalizedString / LocalizedAsset 按需刷新。
                    // 初始化已在本协程开头完成，因此此处不会触发同步 Locale 加载。
                    yield return null;
                }
            }
            finally
            {
                applyLanguageSettingsCoroutine = null;
                isLanguageRoutineRunning = false;
            }
        }

        /// <summary>
        /// 将未保存过 Locale Code 的旧 ES3 数据迁移为稳定 Code。
        /// <para>迁移使用旧版本的固定下拉排序，而不是当前 Addressables 的 Locale 列表顺序；因此旧玩家的语言不会被错误映射。</para>
        /// </summary>
        /// <returns>本次是否写入了新的 <see cref="SettingsSaveData.languageCode"/>。</returns>
        private bool MigrateLanguageCodeIfNeeded()
        {
            if (!string.IsNullOrWhiteSpace(settingsSaveData.languageCode))
            {
                string normalizedCode = NormalizeLocaleCode(settingsSaveData.languageCode);
                bool wasNormalized = normalizedCode != settingsSaveData.languageCode;
                settingsSaveData.languageCode = normalizedCode;
                settingsSaveData.languageIndex = GetLanguageDropdownIndex(normalizedCode);
                return wasNormalized;
            }

            string migratedCode = GetLocaleCodeFromDropdownIndex(settingsSaveData.languageIndex);
            Debug.Log($"[SettingsManager] 已将旧语言索引 {settingsSaveData.languageIndex} 迁移为 Locale Code '{migratedCode}'。", this);
            settingsSaveData.languageCode = migratedCode;
            settingsSaveData.languageIndex = GetLanguageDropdownIndex(migratedCode);
            return true;
        }

        /// <summary>读取并规范化当前存档的 Locale Code。空值或未知 Code 始终回退到 <see cref="DefaultLocaleCode"/>。</summary>
        private string GetSavedLanguageCode()
        {
            string normalizedCode = NormalizeLocaleCode(settingsSaveData.languageCode);
            settingsSaveData.languageCode = normalizedCode;
            settingsSaveData.languageIndex = GetLanguageDropdownIndex(normalizedCode);
            return normalizedCode;
        }

        private static string GetLocaleCodeFromDropdownIndex(int languageIndex)
        {
            if (languageIndex < 0 || languageIndex >= LegacyLanguageIndexToCode.Length)
            {
                Debug.LogWarning($"[SettingsManager] 语言下拉索引 {languageIndex} 超出范围，回退到 {DefaultLocaleCode}。");
                return DefaultLocaleCode;
            }

            return LegacyLanguageIndexToCode[languageIndex];
        }

        private static int GetLanguageDropdownIndex(string localeCode)
        {
            for (int index = 0; index < LegacyLanguageIndexToCode.Length; index++)
            {
                if (LegacyLanguageIndexToCode[index] == localeCode)
                {
                    return index;
                }
            }

            return 0;
        }

        private static string NormalizeLocaleCode(string localeCode)
        {
            if (string.IsNullOrWhiteSpace(localeCode))
            {
                return DefaultLocaleCode;
            }

            foreach (string supportedCode in LegacyLanguageIndexToCode)
            {
                if (string.Equals(supportedCode, localeCode, System.StringComparison.OrdinalIgnoreCase))
                {
                    return supportedCode;
                }
            }

            Debug.LogWarning($"[SettingsManager] Locale Code '{localeCode}' 不在首发语言列表中，回退到 {DefaultLocaleCode}。");
            return DefaultLocaleCode;
        }

        /// <summary>
        /// 判断本谱面是否启用全屏判定。谱面强制要求的配置优先于玩家开关。
        /// </summary>
        public bool ShouldUseFullScreenJudge()
        {
            return settingsSaveData.judgeType || InformationTransistor.instance?.difficulty?.ForceFullScreenJudge == true;
        }
    }
}