using System; using System.Collections; using System.Collections.Generic; using Godot; /// <summary> /// 音频总线 区分不同的声音 添加声音效果 目前只有背景音乐 和音效 两个bus /// </summary> public enum BUS { BGM = 0, SFX = 1 } /// <summary> /// 声音管理 背景音乐管理 音效 /// </summary> public partial class SoundManager { /// <summary> /// 全局音效音量, 范围 0 - 1 /// </summary> public static float SoundVolume { get; set; } = 0.4f; private static Stack<GameAudioPlayer2D> _streamPlayer2DStack = new Stack<GameAudioPlayer2D>(); private static Stack<GameAudioPlayer> _streamPlayerStack = new Stack<GameAudioPlayer>(); private static HashSet<string> _playingSoundResourceList = new HashSet<string>(); /// <summary> /// 2D音频播放节点 /// </summary> public partial class GameAudioPlayer2D : AudioStreamPlayer2D { public override void _Ready() { Finished += OnPlayFinish; } public void PlaySoundByResource(string path, float delayTime) { if (delayTime <= 0) { PlaySoundByResource(path); } else { GameApplication.Instance.StartCoroutine(DelayPlay(path, delayTime)); } } public void PlaySoundByResource(string path) { if (_playingSoundResourceList.Contains(path)) { GD.Print("重复播放: " + path); } else { _playingSoundResourceList.Add(path); var sound = ResourceManager.Load<AudioStream>(path); Stream = sound; Bus = Enum.GetName(typeof(BUS), 1); Play(); } } /// <summary> /// 停止播放, 并回收节点 /// </summary> public void StopPlay() { Stop(); OnPlayFinish(); } private void OnPlayFinish() { RecycleAudioPlayer2D(this); } private IEnumerator DelayPlay(string path, float delayTime) { yield return new WaitForSeconds(delayTime); PlaySoundByResource(path); } } /// <summary> /// 音频播放节点 /// </summary> public partial class GameAudioPlayer : AudioStreamPlayer { public string SoundResourceName { get; set; } public override void _Ready() { Finished += OnPlayFinish; } /// <summary> /// 停止播放, 并回收节点 /// </summary> public void StopPlay() { Stop(); OnPlayFinish(); } private void OnPlayFinish() { GetParent().RemoveChild(this); Stream = null; Playing = false; RecycleAudioPlayer(this); } } public static void Update(float delta) { _playingSoundResourceList.Clear(); } /// <summary> /// 播放声音 用于bgm /// </summary> /// <param name="soundName">bgm路径</param> /// <param name="volume">音量</param> public static GameAudioPlayer PlayMusic(string soundName, float volume = 0.5f) { var sound = ResourceManager.Load<AudioStream>(soundName); var soundNode = GetAudioPlayerInstance(); GameApplication.Instance.GlobalNodeRoot.AddChild(soundNode); soundNode.Stream = sound; soundNode.Bus = Enum.GetName(typeof(BUS), 0); soundNode.VolumeDb = volume; soundNode.Play(); return soundNode; } /// <summary> /// 添加并播放音效 用于音效 /// </summary> /// <param name="soundName">音效文件路径</param> /// <param name="volume">音量 (0 - 1)</param> public static GameAudioPlayer PlaySoundEffect(string soundName, float volume = 1f) { var sound = ResourceManager.Load<AudioStream>(soundName); var soundNode = GetAudioPlayerInstance(); GameApplication.Instance.GlobalNodeRoot.AddChild(soundNode); soundNode.Stream = sound; soundNode.Bus = Enum.GetName(typeof(BUS), 1); soundNode.VolumeDb = Mathf.LinearToDb(Mathf.Clamp(volume, 0, 1)); soundNode.Play(); return soundNode; } /// <summary> /// 在指定的节点下播放音效 用于音效 /// </summary> /// <param name="soundName">音效文件路径</param> /// <param name="pos">发声节点所在全局坐标</param> /// <param name="volume">音量 (0 - 1)</param> /// <param name="target">挂载节点, 为null则挂载到房间根节点下</param> public static GameAudioPlayer2D PlaySoundEffectPosition(string soundName, Vector2 pos, float volume = 1f, Node2D target = null) { return PlaySoundEffectPositionDelay(soundName, pos, 0, volume, target); } /// <summary> /// 在指定的节点下延时播放音效 用于音效 /// </summary> /// <param name="soundName">音效文件路径</param> /// <param name="pos">发声节点所在全局坐标</param> /// <param name="delayTime">延时时间</param> /// <param name="volume">音量 (0 - 1)</param> /// <param name="target">挂载节点, 为null则挂载到房间根节点下</param> public static GameAudioPlayer2D PlaySoundEffectPositionDelay(string soundName, Vector2 pos, float delayTime, float volume = 1f, Node2D target = null) { var soundNode = GetAudioPlayer2DInstance(); if (target != null) { target.AddChild(soundNode); } else { GameApplication.Instance.GlobalNodeRoot.AddChild(soundNode); } soundNode.GlobalPosition = pos; soundNode.VolumeDb = Mathf.LinearToDb(Mathf.Clamp(volume * SoundVolume, 0, 1)); soundNode.PlaySoundByResource(soundName, delayTime); return soundNode; } /// <summary> /// 获取2D音频播放节点 /// </summary> private static GameAudioPlayer2D GetAudioPlayer2DInstance() { if (_streamPlayer2DStack.Count > 0) { return _streamPlayer2DStack.Pop(); } var inst = new GameAudioPlayer2D(); inst.AreaMask = 0; return inst; } /// <summary> /// 获取音频播放节点 /// </summary> private static GameAudioPlayer GetAudioPlayerInstance() { if (_streamPlayerStack.Count > 0) { return _streamPlayerStack.Pop(); } return new GameAudioPlayer(); } /// <summary> /// 回收2D音频播放节点 /// </summary> private static void RecycleAudioPlayer2D(GameAudioPlayer2D inst) { var parent = inst.GetParent(); if (parent != null) { parent.RemoveChild(inst); } inst.Stream = null; _streamPlayer2DStack.Push(inst); } /// <summary> /// 回收音频播放节点 /// </summary> private static void RecycleAudioPlayer(GameAudioPlayer inst) { _streamPlayerStack.Push(inst); } /// <summary> /// 计算指定角色播放音效使用的音量 /// </summary> public static float CalcRoleVolume(float volume, Role role) { if (role is not Player) { return volume * 0.4f; } return volume; } }