422 lines
16 KiB
C#
422 lines
16 KiB
C#
|
using System.Collections.Generic;
|
|||
|
|
using UnityEngine;
|
|||
|
|
using Sirenix.OdinInspector;
|
|||
|
|
|
|||
|
|
namespace Cielonos.MainGame
|
|||
|
|
{
|
|||
|
|
/// <summary>
|
|||
|
|
/// 战斗音乐控制器，负责处理功能音乐的无缝随机切换，以及并行的 BGM 音轨按小节边界起播/停止。
|
|||
|
|
/// </summary>
|
|||
|
|
[AddComponentMenu("Cielonos/Rhythm/CombatMusicController")]
|
|||
|
|
public class CombatMusicController : MonoBehaviour
|
|||
|
|
{
|
|||
|
|
[Header("System References")]
|
|||
|
|
[Tooltip("全局节拍战斗系统的引用")]
|
|||
|
|
public MusicBeatSystem beatSystem;
|
|||
|
|
|
|||
|
|
[Header("BGM Settings")]
|
|||
|
|
[Tooltip("播放背景音乐 Switch 容器的 Wwise Event")]
|
|||
|
|
public AK.Wwise.Event bgmMusicEvent;
|
|||
|
|
|
|||
|
|
[Tooltip("所有可用的背景音乐 Wwise Segment 名称 (对应 Wwise 中的 Switch 值)")]
|
|||
|
|
public List<string> bgmSegments = new List<string>
|
|||
|
|
{
|
|||
|
|
"Back_00",
|
|||
|
|
"Back_01",
|
|||
|
|
"Back_02"
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
[Header("Functional Music Settings")]
|
|||
|
|
[Tooltip("播放功能音乐 Switch 容器的 Wwise Event")]
|
|||
|
|
public AK.Wwise.Event functionalMusicEvent;
|
|||
|
|
|
|||
|
|
[Tooltip("初始播放的音乐片段 Switch 名称")]
|
|||
|
|
public string initialSegment = "Func_00";
|
|||
|
|
|
|||
|
|
[Tooltip("所有可用的功能音乐 Wwise Segment 名称 (对应 Wwise 中的 Switch 值)")]
|
|||
|
|
public List<string> functionalSegments = new List<string>
|
|||
|
|
{
|
|||
|
|
"Func_00",
|
|||
|
|
"Func_01",
|
|||
|
|
"Func_02",
|
|||
|
|
"Func_03"
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
// 运行时 BGM 状态跟踪字典
|
|||
|
|
private readonly Dictionary<string, bool> bgmTargetStates = new Dictionary<string, bool>();
|
|||
|
|
private readonly Dictionary<string, bool> bgmIsPlaying = new Dictionary<string, bool>();
|
|||
|
|
private readonly Dictionary<string, uint> bgmPlayingIDs = new Dictionary<string, uint>();
|
|||
|
|
private readonly Dictionary<string, GameObject> bgmGameObjects = new Dictionary<string, GameObject>();
|
|||
|
|
|
|||
|
|
// 等待下一个全局 PrepareNext 边界才起播的 BGM 片段队列
|
|||
|
|
private readonly HashSet<string> pendingBgmStarts = new HashSet<string>();
|
|||
|
|
|
|||
|
|
private void Awake()
|
|||
|
|
{
|
|||
|
|
// 初始化每个 BGM 段落的运行状态与子 GameObject
|
|||
|
|
foreach (var seg in bgmSegments)
|
|||
|
|
{
|
|||
|
|
bgmTargetStates[seg] = false;
|
|||
|
|
bgmIsPlaying[seg] = false;
|
|||
|
|
bgmPlayingIDs[seg] = 0;
|
|||
|
|
|
|||
|
|
// 为每个 BGM 片段创建独立的子 GameObject，以便并行播放和接收独立的节拍回调
|
|||
|
|
GameObject go = new GameObject($"BGM_Layer_{seg}");
|
|||
|
|
go.transform.SetParent(transform);
|
|||
|
|
bgmGameObjects[seg] = go;
|
|||
|
|
|
|||
|
|
// 在节拍注册表中注册此子物体
|
|||
|
|
MusicBeatSystem.RegisterRhythmGameObject(go);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
private void OnEnable()
|
|||
|
|
{
|
|||
|
|
if (beatSystem == null)
|
|||
|
|
{
|
|||
|
|
beatSystem = GetComponent<MusicBeatSystem>();
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
if (beatSystem != null)
|
|||
|
|
{
|
|||
|
|
beatSystem.OnPrepareNextSegment += DecideNextSegment;
|
|||
|
|
beatSystem.OnUserCueReceived += HandleTrackUserCue;
|
|||
|
|
beatSystem.OnGlobalPrepareNext += OnGlobalPrepareNextFired;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
private void OnDisable()
|
|||
|
|
{
|
|||
|
|
if (beatSystem != null)
|
|||
|
|
{
|
|||
|
|
beatSystem.OnPrepareNextSegment -= DecideNextSegment;
|
|||
|
|
beatSystem.OnUserCueReceived -= HandleTrackUserCue;
|
|||
|
|
beatSystem.OnGlobalPrepareNext -= OnGlobalPrepareNextFired;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
private void OnDestroy()
|
|||
|
|
{
|
|||
|
|
// 释放所有动态创建的子 GameObject
|
|||
|
|
foreach (var pair in bgmGameObjects)
|
|||
|
|
{
|
|||
|
|
if (pair.Value != null)
|
|||
|
|
{
|
|||
|
|
MusicBeatSystem.UnregisterRhythmGameObject(pair.Value);
|
|||
|
|
Destroy(pair.Value);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
#region BGM Inspector Controls
|
|||
|
|
|
|||
|
|
[Button("Play/Stop Back_00 (8 Bars)")]
|
|||
|
|
public void ToggleBack_00() => ToggleBgmTrack("Back_00");
|
|||
|
|
|
|||
|
|
[Button("Play/Stop Back_01 (8 Bars)")]
|
|||
|
|
public void ToggleBack_01() => ToggleBgmTrack("Back_01");
|
|||
|
|
|
|||
|
|
[Button("Play/Stop Back_02 (16 Bars)")]
|
|||
|
|
public void ToggleBack_02() => ToggleBgmTrack("Back_02");
|
|||
|
|
|
|||
|
|
#endregion
|
|||
|
|
|
|||
|
|
#region BGM Implementation
|
|||
|
|
|
|||
|
|
private void ToggleBgmTrack(string segmentName)
|
|||
|
|
{
|
|||
|
|
if (!bgmTargetStates.ContainsKey(segmentName)) return;
|
|||
|
|
|
|||
|
|
bgmTargetStates[segmentName] = !bgmTargetStates[segmentName];
|
|||
|
|
Debug.Log($"[CombatMusicController] Toggle BGM Segment '{segmentName}': Target state is now {bgmTargetStates[segmentName]}");
|
|||
|
|
|
|||
|
|
if (bgmTargetStates[segmentName])
|
|||
|
|
{
|
|||
|
|
// 确保 beatSystem 已激活（用于接收 PrepareNext 通知）
|
|||
|
|
if (beatSystem != null && !beatSystem.IsActive)
|
|||
|
|
{
|
|||
|
|
beatSystem.Activate(null);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
if (!bgmIsPlaying[segmentName] && !pendingBgmStarts.Contains(segmentName))
|
|||
|
|
{
|
|||
|
|
// 如果没有任何音乐在播放或排队，立即起播（第一次）
|
|||
|
|
// 否则，排入队列等待下一个全局 PrepareNext 边界对齐
|
|||
|
|
if (!AnyBgmPlaying() && !AnyBgmPending())
|
|||
|
|
{
|
|||
|
|
Debug.Log($"[CombatMusicController] No music playing, starting BGM '{segmentName}' immediately.");
|
|||
|
|
StartBgmImmediately(segmentName);
|
|||
|
|
}
|
|||
|
|
else
|
|||
|
|
{
|
|||
|
|
pendingBgmStarts.Add(segmentName);
|
|||
|
|
Debug.Log($"[CombatMusicController] BGM '{segmentName}' queued, will start at next PrepareNext boundary.");
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
else
|
|||
|
|
{
|
|||
|
|
// 取消播放：从待播队列中移除（如果还没起播）
|
|||
|
|
pendingBgmStarts.Remove(segmentName);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
private bool AnyBgmPlaying()
|
|||
|
|
{
|
|||
|
|
foreach (var pair in bgmIsPlaying)
|
|||
|
|
{
|
|||
|
|
if (pair.Value) return true;
|
|||
|
|
}
|
|||
|
|
return false;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
private bool AnyBgmPending()
|
|||
|
|
{
|
|||
|
|
return pendingBgmStarts.Count > 0;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 当全局主音乐（Func 轨）的 PrepareNext 到达时，将所有等待中的 BGM 片段一起起播。
|
|||
|
|
/// Wwise 引擎会将它们精确对齐到 Exit Cue 边界！
|
|||
|
|
/// </summary>
|
|||
|
|
private void OnGlobalPrepareNextFired()
|
|||
|
|
{
|
|||
|
|
if (pendingBgmStarts.Count == 0) return;
|
|||
|
|
|
|||
|
|
var toStart = new List<string>(pendingBgmStarts);
|
|||
|
|
pendingBgmStarts.Clear();
|
|||
|
|
|
|||
|
|
uint callbackFlags = (uint)(
|
|||
|
|
AkCallbackType.AK_MusicSyncBeat |
|
|||
|
|
AkCallbackType.AK_MusicSyncEntry |
|
|||
|
|
AkCallbackType.AK_MusicSyncUserCue |
|
|||
|
|
AkCallbackType.AK_EndOfEvent
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
foreach (var seg in toStart)
|
|||
|
|
{
|
|||
|
|
if (!bgmTargetStates.ContainsKey(seg) || !bgmTargetStates[seg]) continue;
|
|||
|
|
if (bgmIsPlaying[seg]) continue;
|
|||
|
|
|
|||
|
|
bgmIsPlaying[seg] = true;
|
|||
|
|
AkUnitySoundEngine.SetSwitch(beatSystem.musicSegmentSwitchGroup, seg, bgmGameObjects[seg]);
|
|||
|
|
|
|||
|
|
uint newID = bgmMusicEvent.Post(
|
|||
|
|
bgmGameObjects[seg],
|
|||
|
|
callbackFlags,
|
|||
|
|
beatSystem.OnWwiseMusicCallback,
|
|||
|
|
null
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
if (newID != 0)
|
|||
|
|
{
|
|||
|
|
bgmPlayingIDs[seg] = newID;
|
|||
|
|
Debug.Log($"[CombatMusicController] BGM '{seg}' started at PrepareNext boundary. ID={newID}");
|
|||
|
|
}
|
|||
|
|
else
|
|||
|
|
{
|
|||
|
|
bgmIsPlaying[seg] = false;
|
|||
|
|
Debug.LogError($"[CombatMusicController] Failed to post BGM event for '{seg}'");
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
private void StartBgmImmediately(string segmentName)
|
|||
|
|
{
|
|||
|
|
if (bgmMusicEvent == null || !bgmMusicEvent.IsValid())
|
|||
|
|
{
|
|||
|
|
Debug.LogError($"[CombatMusicController] Cannot play BGM: Event is invalid.");
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
GameObject go = bgmGameObjects[segmentName];
|
|||
|
|
uint callbackFlags = (uint)(
|
|||
|
|
AkCallbackType.AK_MusicSyncBeat |
|
|||
|
|
AkCallbackType.AK_MusicSyncEntry |
|
|||
|
|
AkCallbackType.AK_MusicSyncUserCue |
|
|||
|
|
AkCallbackType.AK_EndOfEvent
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
// 设置 Wwise Switch 以让此子物体播放当前 segment 音频
|
|||
|
|
AkUnitySoundEngine.SetSwitch(beatSystem.musicSegmentSwitchGroup, segmentName, go);
|
|||
|
|
|
|||
|
|
uint playingID = bgmMusicEvent.Post(
|
|||
|
|
go,
|
|||
|
|
callbackFlags,
|
|||
|
|
beatSystem.OnWwiseMusicCallback,
|
|||
|
|
null
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
if (playingID != 0)
|
|||
|
|
{
|
|||
|
|
bgmIsPlaying[segmentName] = true;
|
|||
|
|
bgmPlayingIDs[segmentName] = playingID;
|
|||
|
|
Debug.Log($"[CombatMusicController] Posted BGM Event for '{segmentName}' immediately on '{go.name}', playingID={playingID}");
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
private void HandleTrackUserCue(uint playingID, string cueName)
|
|||
|
|
{
|
|||
|
|
// 查找是哪个 BGM 片段触发的回调
|
|||
|
|
string triggeringSegment = null;
|
|||
|
|
foreach (var pair in bgmPlayingIDs)
|
|||
|
|
{
|
|||
|
|
if (pair.Value == playingID)
|
|||
|
|
{
|
|||
|
|
triggeringSegment = pair.Key;
|
|||
|
|
break;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
if (triggeringSegment == null) return;
|
|||
|
|
|
|||
|
|
if (cueName == "PrepareNext")
|
|||
|
|
{
|
|||
|
|
uint callbackFlags = (uint)(
|
|||
|
|
AkCallbackType.AK_MusicSyncBeat |
|
|||
|
|
AkCallbackType.AK_MusicSyncEntry |
|
|||
|
|
AkCallbackType.AK_MusicSyncUserCue |
|
|||
|
|
AkCallbackType.AK_EndOfEvent
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
// 1. 如果该 BGM 被要求继续播放，由于 Wwise 可能没有配置原生循环，
|
|||
|
|
// 我们在 PrepareNext 时刻（提前）再次 Post Event，让 Wwise 引擎将其调度到下一个 Exit 点无缝衔接起播！
|
|||
|
|
if (bgmTargetStates[triggeringSegment])
|
|||
|
|
{
|
|||
|
|
uint newID = bgmMusicEvent.Post(
|
|||
|
|
bgmGameObjects[triggeringSegment],
|
|||
|
|
callbackFlags,
|
|||
|
|
beatSystem.OnWwiseMusicCallback,
|
|||
|
|
null
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
if (newID != 0)
|
|||
|
|
{
|
|||
|
|
bgmPlayingIDs[triggeringSegment] = newID;
|
|||
|
|
Debug.Log($"[CombatMusicController] Loop transition: Re-posted Event for BGM '{triggeringSegment}'. New ID: {newID}");
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
// 如果被要求停止，我们什么都不做，让当前片段自然播放完毕并触发 EndOfEvent 即可。
|
|||
|
|
|
|||
|
|
// 2. 检查是否有排队等待播放的其他 BGM 片段。
|
|||
|
|
// 同样在此时刻 Post 它们，Wwise 引擎会自动将它们与当前音频的小节边界完美对齐！
|
|||
|
|
foreach (var seg in bgmSegments)
|
|||
|
|
{
|
|||
|
|
if (seg != triggeringSegment && bgmTargetStates[seg] && !bgmIsPlaying[seg])
|
|||
|
|
{
|
|||
|
|
bgmIsPlaying[seg] = true;
|
|||
|
|
|
|||
|
|
// 确保对应的 GameObject Switch 正确
|
|||
|
|
AkUnitySoundEngine.SetSwitch(beatSystem.musicSegmentSwitchGroup, seg, bgmGameObjects[seg]);
|
|||
|
|
|
|||
|
|
uint newSegID = bgmMusicEvent.Post(
|
|||
|
|
bgmGameObjects[seg],
|
|||
|
|
callbackFlags,
|
|||
|
|
beatSystem.OnWwiseMusicCallback,
|
|||
|
|
null
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
if (newSegID != 0)
|
|||
|
|
{
|
|||
|
|
bgmPlayingIDs[seg] = newSegID;
|
|||
|
|
Debug.Log($"[CombatMusicController] Queued start: Posted Event for BGM '{seg}' during PrepareNext. ID: {newSegID}");
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
else if (cueName == "EndOfEvent")
|
|||
|
|
{
|
|||
|
|
// 注意：由于我们在 PrepareNext 处更新了 bgmPlayingIDs，
|
|||
|
|
// 此时旧的 playingID 已经与字典中的不匹配了，所以旧事件的 EndOfEvent 会在上面的循环中返回 null 并忽略！
|
|||
|
|
// 只有真正停止播放（未更新 ID）的 EndOfEvent 才会走到这里，实现完美的状态清理！
|
|||
|
|
bgmIsPlaying[triggeringSegment] = false;
|
|||
|
|
bgmPlayingIDs[triggeringSegment] = 0;
|
|||
|
|
Debug.Log($"[CombatMusicController] BGM Segment '{triggeringSegment}' terminated naturally in Wwise (EndOfEvent).");
|
|||
|
|
|
|||
|
|
if (!AnyBgmPlaying())
|
|||
|
|
{
|
|||
|
|
bool queuedBgmStarted = false;
|
|||
|
|
foreach (var seg in bgmSegments)
|
|||
|
|
{
|
|||
|
|
if (bgmTargetStates[seg] && !bgmIsPlaying[seg])
|
|||
|
|
{
|
|||
|
|
Debug.Log($"[CombatMusicController] Starting queued BGM '{seg}' since all others stopped.");
|
|||
|
|
if (beatSystem != null && !beatSystem.IsActive)
|
|||
|
|
{
|
|||
|
|
beatSystem.Activate(null);
|
|||
|
|
}
|
|||
|
|
StartBgmImmediately(seg);
|
|||
|
|
queuedBgmStarted = true;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
if (!queuedBgmStarted && beatSystem != null && beatSystem.IsActive)
|
|||
|
|
{
|
|||
|
|
beatSystem.Deactivate();
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
else if (cueName.StartsWith("Entry_"))
|
|||
|
|
{
|
|||
|
|
bgmIsPlaying[triggeringSegment] = true;
|
|||
|
|
Debug.Log($"[CombatMusicController] BGM Segment '{triggeringSegment}' entered and is now running.");
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
#endregion
|
|||
|
|
|
|||
|
|
#region Functional Music Implementation
|
|||
|
|
|
|||
|
|
[Button("Play Functional Music")]
|
|||
|
|
public void PlayFunctionalMusic()
|
|||
|
|
{
|
|||
|
|
if (beatSystem == null)
|
|||
|
|
{
|
|||
|
|
beatSystem = GetComponent<MusicBeatSystem>();
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
if (beatSystem != null)
|
|||
|
|
{
|
|||
|
|
beatSystem.Activate(functionalMusicEvent, initialSegment);
|
|||
|
|
}
|
|||
|
|
else
|
|||
|
|
{
|
|||
|
|
Debug.LogError("[CombatMusicController] Cannot play: MusicBeatSystem reference is missing.");
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
private string DecideNextSegment(GameObject targetGO, string currentSegmentName)
|
|||
|
|
{
|
|||
|
|
if (beatSystem == null || targetGO != beatSystem.gameObject)
|
|||
|
|
{
|
|||
|
|
return "";
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
if (functionalSegments == null || functionalSegments.Count == 0)
|
|||
|
|
{
|
|||
|
|
return "";
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
List<string> candidates = new List<string>(functionalSegments);
|
|||
|
|
|
|||
|
|
if (!string.IsNullOrEmpty(currentSegmentName))
|
|||
|
|
{
|
|||
|
|
candidates.Remove(currentSegmentName);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
if (candidates.Count > 0)
|
|||
|
|
{
|
|||
|
|
int randomIndex = UnityEngine.Random.Range(0, candidates.Count);
|
|||
|
|
string selectedSegment = candidates[randomIndex];
|
|||
|
|
|
|||
|
|
Debug.Log($"[CombatMusicController] Transition Decision: GameObject '{targetGO.name}' currently playing '{currentSegmentName}', selected next: '{selectedSegment}'");
|
|||
|
|
return selectedSegment;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return functionalSegments[0];
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
#endregion
|
|||
|
|
}
|
|||
|
|
}
|