Files
plugin-library/Assets/04.AudioCore/RunTime/Use/AudioCoreManager.cs
mzh 8a5ca901ca 【m】04.AudioCore [1.1.3] - 2026-01-12
### Added
- 添加背景音乐缓出接口
### Fixed
- 修复背景音乐播放时不循环的问题
2026-01-12 12:52:24 +08:00

213 lines
6.3 KiB
C#

using UnityEngine;
using System.Collections.Generic;
using System.Security.Cryptography.X509Certificates;
using System.Threading.Tasks;
using Cysharp.Threading.Tasks;
namespace Stary.Evo.AudioCore
{
public static class AudioCoreManager
{
private static IAudio Voice;
private static IAudio SFX;
private static MusicPlayer Music;
private static IResources Resources;
public static void Initialize(IResources resources)
{
// 初始化播放器
Resources = resources;
Voice = new VoicePlayer(Resources);
SFX = new SFXPlayer(Resources);
Music = new MusicPlayer(Resources);
}
#region
/// <summary>
/// 播放语音
/// </summary>
/// <param name="audioData">{[clip:音频], [volume:音量],
/// [onComplete:回调行为], [delayOnCompleteTime:延迟回调执行的时间],
/// [is3DAudio:是否3D音频], [audio3DPosition:3D音频位置],
/// [audio3DMaxDistance:3D音频最大距离]}</param>
public static void PlayVoice(AudioData audioData)
{
if (Voice == null)
{
Debug.LogError("AudioCoreManager: Voice is null, please initialize it first.");
return;
}
Voice?.Play(audioData);
}
/// <summary>
/// 异步播放语音
/// </summary>
/// <param name="audioData">{[clip:音频], [volume:音量],
/// [onComplete:回调行为], [delayOnCompleteTime:延迟回调执行的时间],
/// [is3DAudio:是否3D音频], [audio3DPosition:3D音频位置],
/// [audio3DMaxDistance:3D音频最大距离],
/// [cancellationToken:异步取消令牌]}</param>
/// <returns></returns>
public static UniTask PlayAsyncVoice(AudioData audioData)
{
if (Voice == null)
{
Debug.LogError("AudioCoreManager: Voice is null, please initialize it first.");
return UniTask.CompletedTask;
}
return Voice.PlayAsync(audioData);
}
/// <summary>
/// 停止当前的语音
/// </summary>
public static void StopVoice()
{
if (Voice == null)
{
Debug.LogError("AudioCoreManager: Voice is null, please initialize it first.");
return;
}
Voice.Stop();
}
/// <summary>
/// 停止当前的语音
/// </summary>
public static async UniTask FadeOutVoice(float fadeDuration)
{
if (Voice == null)
{
Debug.LogError("AudioCoreManager: Voice is null, please initialize it first.");
}
await Voice.FadeOutMusic(Voice.GetAudioSource(), fadeDuration);
Voice.Stop();
}
#endregion
#region
/// <summary>
/// 播放音效
/// </summary>
/// <param name="audioData">{[clip:音频], [volume:音量],
/// [onComplete:回调行为], [delayOnCompleteTime:延迟回调执行的时间],
/// [is3DAudio:是否3D音频], [audio3DPosition:3D音频位置],
/// [audio3DMaxDistance:3D音频最大距离]}</param>
public static void PlaySFX(AudioData audioData)
{
if (SFX == null)
{
Debug.LogError("AudioCoreManager: SFX is null, please initialize it first.");
return;
}
SFX.Play(audioData);
}
/// <summary>
/// 停止所有音效
/// </summary>
public static void StopAllSFX()
{
if (SFX == null)
{
Debug.LogError("AudioCoreManager: SFX is null, please initialize it first.");
return;
}
AudioData audioData = new AudioData();
SFX.Stop();
}
#endregion
#region
/// <summary>
/// 播放背景音乐
/// </summary>
/// <param name="audioData">{[clip:音频], [volume:音量], [fadeDuration:自然过渡时间],
/// [is3DAudio:是否3D音频], [audio3DPosition:3D音频位置],
/// [audio3DMaxDistance:3D音频最大距离]}</param>
public static void PlayMusic(AudioData audioData)
{
if (Music == null)
{
Debug.LogError("AudioCoreManager: Music is null, please initialize it first.");
return;
}
Music.Play(audioData);
}
/// <summary>
/// Bgm设置自然过渡到指定音量
/// </summary>
/// <param name="fadeDuration"></param>
/// <param name="targetVolume"></param>
/// <returns></returns>
public static void SetMusicVolume(float fadeDuration, float targetVolume)
{
if (Music == null)
{
Debug.LogError("AudioCoreManager: Music is null, please initialize it first.");
return;
}
Music.SetMusicVolume(fadeDuration, targetVolume);
}
/// <summary>
/// 停止播放背景音乐
/// </summary>
public static void StopMusic()
{
if (Music == null)
{
Debug.LogError("AudioCoreManager: Music is null, please initialize it first.");
return;
}
Music.Stop();
}
/// <summary>
/// 停止播放背景音乐
/// </summary>
/// <param name="fadeDuration">自然过渡时间</param>
public static void FadeAllMusic(float fadeDuration = 1)
{
if (Music == null)
{
Debug.LogError("AudioCoreManager: Music is null, please initialize it first.");
return;
}
Music.FadeAllMusic(fadeDuration);
}
#endregion
/// <summary>
/// 重新初始化
/// </summary>
/// <returns></returns>
public static void Dispose()
{
StopVoice();
StopAllSFX();
StopMusic();
Voice = null;
SFX = null;
Music = null;
}
}
}