设置扩展

Assets/Scripts/Settings/SettingsManager.cs

@@ -1,17 +1,34 @@
 using Ichni.Menu;
+using System.Collections.Generic;
 using Sirenix.OdinInspector;
 using UnityEngine;
+using UnityEngine.Localization.Settings;
+using UnityEngine.Rendering;
+using UnityEngine.Rendering.Universal;
+using UnityEngine.SceneManagement;
 using UnityEngine.Serialization;
 
 namespace Ichni
 {
     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";
+
         public static SettingsManager instance;
         
         [FormerlySerializedAs("settingsPage")] 
         public SettingsUIPage settingsUIPage;
-        public GameSettings gameSettings;
+
+        [FormerlySerializedAs("gameSettings")]
+        public SettingsSaveData settingsSaveData;
+
+        // 记录相机在玩家关闭后处理前的原始状态。重新开启时必须恢复原始值，不能无条件将所有相机改为开启。
+        private readonly Dictionary<int, bool> postProcessingCameraStates = new Dictionary<int, bool>();
 
         private void Awake()
         {
@@ -19,6 +36,8 @@ namespace Ichni
             {
                 instance = this;
                 DontDestroyOnLoad(gameObject);
+                SceneManager.sceneLoaded += OnSceneLoaded;
+                RenderPipelineManager.beginCameraRendering += ApplyPostProcessingSettingBeforeCameraRender;
             }
             else
             {
@@ -26,6 +45,18 @@ namespace Ichni
             }
         }
 
+        private void OnDestroy()
+        {
+            if (instance != this)
+            {
+                return;
+            }
+
+            SceneManager.sceneLoaded -= OnSceneLoaded;
+            RenderPipelineManager.beginCameraRendering -= ApplyPostProcessingSettingBeforeCameraRender;
+            instance = null;
+        }
+
         private void Start()
         {
             LoadGameSettings();
@@ -34,27 +65,269 @@ namespace Ichni
         [Button]
         public void SaveGameSettings()
         {
-            string savePath = Application.persistentDataPath + "/GameData/GameSettings.json";
-            ES3.Save("GameSettings", gameSettings, savePath);
+            string savePath = Application.persistentDataPath + "/GameData/" + SettingsSaveFileName;
+            ES3.Save(SettingsSaveKey, settingsSaveData, savePath);
         }
         
         [Button]
         public void LoadGameSettings()
         {
-            string savePath = Application.persistentDataPath + "/GameData/GameSettings.json";
+            string savePath = Application.persistentDataPath + "/GameData/" + SettingsSaveFileName;
             if (ES3.FileExists(savePath))
             {
-                gameSettings = ES3.Load<GameSettings>("GameSettings", savePath);
+                // 保留原有 ES3 Key，确保本次数据模型重命名不会让已有本地设置失效。
+                settingsSaveData = ES3.Load<SettingsSaveData>(SettingsSaveKey, savePath);
             }
             else
             {
-                gameSettings = new GameSettings(
-                    50, 50, 50, 50,
-                    0, 60, 3, 0, false, false, false);
+                settingsSaveData = CreateDefaultSettingsSaveData();
             }
-            
-            gameSettings.ApplyVolume();
-            gameSettings.ApplyGraphic();
+             
+            ApplyAudioSettings();
+            ApplyGraphicSettings();
+        }
+
+        /// <summary>
+        /// 将音频分类的当前设置写入 Wwise RTPC。
+        /// </summary>
+        public void ApplyAudioSettings()
+        {
+            AkSoundEngine.SetRTPCValue("MasterVolume", settingsSaveData.masterVolume);
+            AkSoundEngine.SetRTPCValue("MusicVolume", settingsSaveData.musicVolume);
+            AkSoundEngine.SetRTPCValue("SoundFXVolume", settingsSaveData.soundEffectVolume);
+            AkSoundEngine.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();
+        }
+
+        /// <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>
+        /// 处理场景切换后新加载的相机与 Global Volume。SettingsManager 会跨场景保留，
+        /// 因此不能只在首次读取存档时应用一次图形设置。
+        /// </summary>
+        private void OnSceneLoaded(Scene scene, LoadSceneMode loadSceneMode)
+        {
+            if (settingsSaveData != null)
+            {
+                ApplyPostProcessingSettings();
+            }
+        }
+
+        /// <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.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;
+        }
+
+        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>
+        /// 将当前语言索引应用到既有的 I2 与 Unity Localization 管线。
+        /// 语言将于 Localization 重构时改为稳定的 Locale ID；本阶段只迁移数据承载方式。
+        /// </summary>
+        public void ApplyLanguageSettings()
+        {
+            I2.Loc.LocalizationManager.CurrentLanguage = MenuManager.instance.languageList[settingsSaveData.languageIndex];
+            LocalizationSettings.SelectedLocale = LocalizationSettings.AvailableLocales.Locales[settingsSaveData.languageIndex];
+            I2.Loc.LocalizationManager.UpdateSources();
+        }
+
+        /// <summary>
+        /// 判断本谱面是否启用全屏判定。谱面强制要求的配置优先于玩家开关。
+        /// </summary>
+        public bool ShouldUseFullScreenJudge()
+        {
+            return settingsSaveData.judgeType || InformationTransistor.instance?.difficulty?.ForceFullScreenJudge == true;
         }
     }
-}
+}