feat: SyncPoint.SameAsCurrentSegment music transition

- Add SameAsCurrentSegment mode to align new container's timeSamples with the old container's playback position, accounting for FadeInOffset
- Fix BeatClock callback burst when Restart is called with a past dspTime
- Add GetFirstLeafSource() for resolving playback position across nested containers
- Manual BeatClock.Restart replaces OnContainerEntered subscription for accurate timing with SyncPoint

Assets/Scenes/SampleScene.unity

@@ -2579,6 +2579,7 @@ GameObject:
   m_Component:
   - component: {fileID: 2093584671}
   - component: {fileID: 2093584670}
+  - component: {fileID: 2093584672}
   m_Layer: 0
   m_Name: AudioSystem
   m_TagString: Untagged
@@ -2613,6 +2614,18 @@ Transform:
   m_Children: []
   m_Father: {fileID: 0}
   m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+--- !u!114 &2093584672
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 2093584669}
+  m_Enabled: 0
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: a3d8ad76f12545caa287f26889c674e3, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
 --- !u!1660057539 &9223372036854775807
 SceneRoots:
   m_ObjectHideFlags: 0

Assets/Scripts/OCES/Audio/HandWritten/AudioSystem.cs

@@ -244,7 +244,7 @@ namespace OCES.Audio
         {
             // ── 启动默认音乐与环境音 ──
             // 触发一次初始状态，让音乐系统从默认状态开始匹配
-            //SetState(GameState.Home);
+            SetState(GameState.Home);
         }
        
         AudioObject ResolveSwitchContainer(AudioObject switchContainer)

Assets/Scripts/OCES/Audio/HandWritten/LongAudio/BeatClock.cs

@@ -65,7 +65,8 @@ namespace OCES.Audio
 
         IEnumerator BeatCoroutine()
         {
-            long index = 0; // 从第 1 拍开始，第 0 拍是起始点本身
+            double elapsed = AudioSettings.dspTime - this.m_startDspTime;
+            long index = elapsed > 0.05 ? (long)(elapsed / this.m_secondsPerBeat) : 0;
             while (true)
             {
                 double nextTime = this.m_startDspTime + index * this.m_secondsPerBeat;
@@ -84,10 +85,12 @@ namespace OCES.Audio
 
         IEnumerator BarCoroutine()
         {
-            long index = 0;
+            double elapsed = AudioSettings.dspTime - this.m_startDspTime;
+            double secondsPerBar = this.m_secondsPerBeat * this.m_beatsPerBar;
+            long index = elapsed > 0.05 ? (long)(elapsed / secondsPerBar) : 0;
             while (true)
             {
-                double nextTime = this.m_startDspTime + index * this.m_secondsPerBeat * this.m_beatsPerBar;
+                double nextTime = this.m_startDspTime + index * secondsPerBar;
                 yield return new WaitUntil(() => AudioSettings.dspTime >= nextTime - 0.02);
 
                 while (AudioSettings.dspTime < nextTime)
@@ -102,10 +105,12 @@ namespace OCES.Audio
 
         IEnumerator GridCoroutine()
         {
-            long index = 0;
+            double elapsed = AudioSettings.dspTime - this.m_startDspTime;
+            double secondsPerGrid = this.m_secondsPerBeat * this.m_beatsPerBar * this.m_barsPerGrid;
+            long index = elapsed > 0.05 ? (long)(elapsed / secondsPerGrid) : 0;
             while (true)
             {
-                double nextTime = this.m_startDspTime + index * this.m_secondsPerBeat * this.m_beatsPerBar * this.m_barsPerGrid;
+                double nextTime = this.m_startDspTime + index * secondsPerGrid;
                 yield return new WaitUntil(() => AudioSettings.dspTime >= nextTime - 0.02);
 
                 while (AudioSettings.dspTime < nextTime)

Assets/Scripts/OCES/Audio/HandWritten/LongAudio/ChannelFader.cs

@@ -6,6 +6,18 @@ using DG.Tweening;
 
 namespace OCES.Audio
 {
+    /// <summary>
+    /// SyncPoint 协调状态，在 FadeOutBranch 和 FadeInBranch 之间共享。
+    /// </summary>
+    internal class SyncPointState
+    {
+        public SyncPoint Mode;
+        public int BaseTimeSamples;        // 读取旧 Source 时的 timeSamples
+        public double BaseDspTime;         // 读取旧 Source 时的 dspTime
+        public int SampleRate;             // 旧 Source 的采样率
+        public bool Ready;
+    }
+
     /// <summary>
     /// 与Transition无关的音量/生命周期管理逻辑
     /// </summary>
@@ -47,7 +59,11 @@ namespace OCES.Audio
         /// <summary>
         /// 淡出分支：fire-and-forget，由调用方 StartCoroutine
         /// </summary>
-        internal IEnumerator FadeOutBranch(ContainerPlayHandle outgoingHandle, float outgoingVolume, ITransitionConfig transition)
+        internal IEnumerator FadeOutBranch(
+            ContainerPlayHandle outgoingHandle,
+            float outgoingVolume,
+            ITransitionConfig transition,
+            SyncPointState syncState = null)
         {
             if (outgoingHandle == null) yield break;
 
@@ -68,7 +84,7 @@ namespace OCES.Audio
         /// 淡入分支：等待 FadeInOffset 后启动新音乐并淡入。
         /// 主协程 yield return 此分支，以便 DoTransition 在新音乐就绪后才结束。
         /// </summary>
-        internal IEnumerator FadeInBranch(uint newContainerId, ITransitionConfig transition, Action onContainerStarted = null)
+        internal IEnumerator FadeInBranch(uint newContainerId, ITransitionConfig transition, SyncPointState syncState = null, Action onContainerStarted = null)
         {
             if (transition?.FadeInOffset > 0f)
             {
@@ -80,11 +96,40 @@ namespace OCES.Audio
             {
                 CurrentHandle      = null;
                 CurrentContainerId = 0;
+                if (syncState != null) syncState.Ready = true;
                 yield break;
             }
 
             float startVolume = transition?.FadeInTime > 0f ? 0f : 1f;
             StartNew(newContainerId, startVolume);
+
+            // SyncPoint: 获取新 Segment 的 AudioSource 并设置 timeSamples
+            if (syncState is { Mode: SyncPoint.SameAsCurrentSegment })
+            {
+                AudioSource newSource = CurrentHandle?.GetFirstLeafSource();
+                if (newSource != null && newSource.clip != null)
+                {
+                    // 计算从读取旧 Source 到现在经过的 samples
+                    double elapsedSeconds = AudioSettings.dspTime - syncState.BaseDspTime;
+                    int elapsedSamples = (int)(elapsedSeconds * syncState.SampleRate);
+                    int targetTimeSamples = syncState.BaseTimeSamples + elapsedSamples;
+
+                    if (targetTimeSamples < newSource.clip.samples)
+                    {
+                        newSource.timeSamples = targetTimeSamples;
+                    }
+                    else
+                    {
+                        Debug.LogError($"[ChannelFader] SyncPoint.SameAsCurrentSegment: 新音频 samples({newSource.clip.samples}) <= 目标 samples({targetTimeSamples})，降级为 Start");
+                    }
+                }
+                else
+                {
+                    Debug.LogError($"[ChannelFader] SyncPoint.SameAsCurrentSegment: 未能获取新 Segment 的 AudioSource，降级为 Start");
+                }
+                syncState.Ready = true;
+            }
+
             onContainerStarted?.Invoke();
 
             if (transition?.FadeInTime > 0f)

Assets/Scripts/OCES/Audio/HandWritten/LongAudio/MusicChannelPlayer.cs

@@ -47,7 +47,6 @@ namespace OCES.Audio
             this.m_fader               = new ChannelFader(player, coroutineHost);
             this.m_beatClock           = new BeatClock(coroutineHost, onBeat, onBar, onGrid);
             
-            player.OnContainerEntered += this.m_beatClock.Restart;
             player.OnBlendError += this.m_beatClock.OnBlendError;
         }
 
@@ -104,6 +103,45 @@ namespace OCES.Audio
                 this.m_currentFadeOutCoroutine = null;
             }
 
+            // ── 构建 SyncPoint 状态 ──
+            SyncPointState syncState = new()
+            {
+                Mode = transition?.SyncPoint ?? SyncPoint.Start,
+                Ready = false,
+            };
+
+            //Debug.Log($"[MusicChannelPlayer] DoTransition: transition?.SyncPoint={transition?.SyncPoint}, Mode={syncState.Mode}");
+
+            if (syncState.Mode == SyncPoint.SameAsCurrentSegment)
+            {
+                // 旧 Container 不存在（如游戏首次启动），静默降级为 Start
+                if (this.m_fader.CurrentHandle == null)
+                {
+                    syncState.Mode = SyncPoint.Start;
+                }
+                // Blend 类型不支持 SameAsCurrentSegment，降级为 Start
+                else if (this.m_currentContainer is { ContainerType: ContainerType.Blend })
+                {
+                    Debug.LogWarning($"[MusicChannelPlayer] SyncPoint.SameAsCurrentSegment 不支持 Blend 类型 Container({this.m_currentContainer.Id})，降级为 Start");
+                    syncState.Mode = SyncPoint.Start;
+                }
+                else
+                {
+                    AudioSource oldSource = this.m_fader.CurrentHandle.GetFirstLeafSource();
+                    if (oldSource && oldSource.clip)
+                    {
+                        syncState.BaseTimeSamples = oldSource.timeSamples;
+                        syncState.BaseDspTime = AudioSettings.dspTime;
+                        syncState.SampleRate = oldSource.clip.frequency;
+                    }
+                    else
+                    {
+                        Debug.LogWarning("[MusicChannelPlayer] SameAsCurrentSegment: 旧 Source 不存在，降级为 Start");
+                        syncState.Mode = SyncPoint.Start;
+                    }
+                }
+            }
+
             // ── 1. 等待节拍对齐（由 Transition 的 AlignMode 决定）──
             if (transition != null && this.m_currentContainer != null)
             {
@@ -119,15 +157,32 @@ namespace OCES.Audio
             float outVol = this.m_fader.CurrentVolume;
 
             this.m_currentFadeOutCoroutine = this.m_coroutineHost.StartCoroutine(
-                this.m_fader.FadeOutBranch(outgoing, outVol, transition));
+                this.m_fader.FadeOutBranch(outgoing, outVol, transition, syncState));
 
             this.m_currentFadeInCoroutine = this.m_coroutineHost.StartCoroutine(
-                this.m_fader.FadeInBranch(newContainerId, transition,
+                this.m_fader.FadeInBranch(newContainerId, transition, syncState,
                     onContainerStarted: () =>
                     {
-                        // Music 独有：记录新 container 和播放起始时间
+                        MusicContainer container = this.m_containerConfig.QueryById(newContainerId);
-                        this.m_currentContainer = this.m_containerConfig.QueryById(newContainerId);
+                        float bpm = container.Bpm > 0f ? container.Bpm : 120f;
-                        this.m_playStartTime    = AudioSettings.dspTime;
+
+                        // SyncPoint: BeatClock 用调整后的 dspTime，对齐到音频实际播放位置
+                        double dspTime;
+                        if (syncState is { Mode: SyncPoint.SameAsCurrentSegment })
+                        {
+                            double elapsedSeconds = AudioSettings.dspTime - syncState.BaseDspTime;
+                            int elapsedSamples = (int)(elapsedSeconds * syncState.SampleRate);
+                            double audioTime = (double)(syncState.BaseTimeSamples + elapsedSamples) / syncState.SampleRate;
+                            dspTime = AudioSettings.dspTime - audioTime;
+                        }
+                        else
+                        {
+                            dspTime = AudioSettings.dspTime;
+                        }
+
+                        this.m_currentContainer = container;
+                        this.m_playStartTime    = dspTime;
+                        this.m_beatClock.Restart(container, bpm, dspTime);
                     }));
             yield return this.m_currentFadeInCoroutine;
             this.m_currentFadeInCoroutine = null;
@@ -147,23 +202,28 @@ namespace OCES.Audio
 
             double secondsPerBeat = 60.0 / container.Bpm;
 
-            if (mode == AlignMode.Beat)
+            switch (mode)
+            {
+                case AlignMode.Beat:
                 {
                     double beatsElapsed  = elapsed / secondsPerBeat;
-                double nextBeat      = System.Math.Ceiling(beatsElapsed);
+                    double nextBeat      = Math.Ceiling(beatsElapsed);
                     double waitSeconds   = (nextBeat - beatsElapsed) * secondsPerBeat;
                     if (waitSeconds > 0.001)
                         yield return new WaitForSeconds((float)waitSeconds);
+                    break;
                 }
-            else if (mode == AlignMode.Bar)
+                case AlignMode.Bar:
                 {
                     int beatsPerBar = MusicContainerConfig.GetBeatsPerBar(container.TimeSig);
                     double secondsPerBar   = secondsPerBeat * beatsPerBar;
                     double barsElapsed     = elapsed / secondsPerBar;
-                double nextBar         = System.Math.Ceiling(barsElapsed);
+                    double nextBar         = Math.Ceiling(barsElapsed);
                     double waitSeconds     = (nextBar - barsElapsed) * secondsPerBar;
                     if (waitSeconds > 0.001)
                         yield return new WaitForSeconds((float)waitSeconds);
+                    break;
+                }
             }
         }
         

Assets/Scripts/OCES/Audio/HandWritten/LongAudio/MusicContainerPlayer.cs

@@ -411,5 +411,20 @@ namespace OCES.Audio
             foreach (ContainerPlayHandle child in this.ChildHandles)
                 child.CollectActiveSources(result);
         }
+
+        /// <summary>
+        /// 获取第一个正在播放的 Leaf Segment 的 AudioSource。
+        /// 递归遍历子句柄，优先取当前层级的 ActiveSources，找不到再深入子层级。
+        /// </summary>
+        internal AudioSource GetFirstLeafSource()
+        {
+            if (this.ActiveSources.Count > 0) return this.ActiveSources[0];
+            foreach (ContainerPlayHandle child in this.ChildHandles)
+            {
+                AudioSource src = child.GetFirstLeafSource();
+                if (src) return src;
+            }
+            return null;
+        }
     }
 }

Assets/Scripts/OCES/Audio/HandWritten/SfxSystem.cs

@@ -55,7 +55,7 @@ namespace OCES.Audio
         {
             this.m_clipConcurrentCount[id] = GetClipCount(id) + 1;
 #if UNITY_EDITOR
-            Debug.Log($"{id} count added to {GetClipCount(id)}");
+            //Debug.Log($"{id} count added to {GetClipCount(id)}");
 #endif
         }
 

Assets/Scripts/OCES/SetStateBind.cs

@@ -7,7 +7,7 @@ namespace OCES
 {
     public class SetStateBind : MonoBehaviour
     {
-        public TileMaterial targetGameState;
+        public GameState targetGameState;
         public bool enableLowpass;
         public Text buttonText;