first commit

2026-03-20 17:55:53 +08:00
commit 41e38311f0
327 changed files with 11557 additions and 0 deletions
@@ -0,0 +1,58 @@
+using System;
+using UnityEngine;
+
+namespace OCES.Audio
+{
+    /// <summary>
+    /// 音乐与环境音系统。由 AudioSystem 持有并初始化。
+    /// 对外只暴露 OnStateChanged，由 AudioSystem.SetState 转发调用。
+    /// </summary>
+    public class MusicSystem : MonoBehaviour
+    {
+        MusicStateRouter m_stateRouter;
+        MusicChannelPlayer m_musicChannel;
+        AmbienceChannelPlayer m_ambienceChannel;
+
+        // 记录上一次两个通道各自匹配到的 PathId，用于查 Transition 表
+        uint m_lastMusicPathId;
+        uint m_lastAmbiencePathId;
+
+        public void Initialize(
+            MusicSegmentConfig segments,
+            MusicContainerConfig containers,
+            MusicPathConfig musicPaths,
+            AmbiencePathConfig ambiencePaths,
+            MusicTransitionConfig musicTransitions,
+            AmbienceTransitionConfig ambienceTransitions,
+            AudioSourcePool musicPool,
+            AudioSourcePool ambiencePool)
+        {
+            MusicContainerPlayer musicContainerPlayer = new(containers, segments, musicPool, this);
+            MusicContainerPlayer ambientContainerPlayer = new(containers, segments, ambiencePool, this);
+
+            this.m_stateRouter      = new MusicStateRouter(musicPaths, ambiencePaths);
+            this.m_musicChannel     = new MusicChannelPlayer(containers, musicTransitions, musicContainerPlayer, this);
+            this.m_ambienceChannel  = new AmbienceChannelPlayer(ambienceTransitions, ambientContainerPlayer, this);
+        }
+
+        /// <summary>
+        /// 由 AudioSystem.SetState 调用，更新状态并驱动两个通道切换。
+        /// </summary>
+        public void OnStateChanged<TEnum>(TEnum state) where TEnum : Enum
+        {
+            this.m_stateRouter.SetState(
+                state,
+                out uint musicContainerId,
+                out uint ambienceContainerId);
+
+            uint newMusicPathId    = this.m_stateRouter.LastMusicPathId;
+            uint newAmbiencePathId = this.m_stateRouter.LastAmbiencePathId;
+
+            this.m_musicChannel.SwitchTo(musicContainerId, this.m_lastMusicPathId, newMusicPathId);
+            this.m_ambienceChannel.SwitchTo(ambienceContainerId, this.m_lastAmbiencePathId, newAmbiencePathId);
+
+            this.m_lastMusicPathId    = newMusicPathId;
+            this.m_lastAmbiencePathId = newAmbiencePathId;
+        }
+    }
+}