Project_PrincipleOverview_G_YunNan_2025/ModeDisplay/Assets/Scripts/AudioHelper.cs

using System;
using System.Collections;
using System.Collections.Generic;
using System.IO;
using UnityEngine;
using UnityEngine.Networking;

/// <summary>
/// 音频帮助类
/// </summary>
public class AudioHelper
{
    #region 私有属性

    /// <summary>
    /// 音频组件名称
    /// </summary>
    private static string m_AudioComponentName = "AudioHelper";

    /// <summary>
    /// 当前音频组件
    /// </summary>
    private static AudioSource m_CurrentAudoiSource = null;

    private static float m_RecordCurrentVolume = 0;

    private const float m_VolumeOffset = 0.1f;
    #endregion

    /// <summary>
    /// 获取音频组件
    /// </summary>
    public static void GetAudioComponent()
    {
        // 根据名称全局查找音频播放组件
        GameObject tmpGame = GameObject.Find(m_AudioComponentName);

        if (tmpGame == null)
        {
            tmpGame = new GameObject(m_AudioComponentName);
        }

        if (tmpGame.GetComponent<AudioSource>() == null)
        {
            tmpGame.AddComponent<AudioSource>();
        }

        AudioSource audioSource = tmpGame.GetComponent<AudioSource>();
        // 设置最大、最小半径
        audioSource.minDistance = 50;
        audioSource.maxDistance = 500;

        m_CurrentAudoiSource = audioSource;
    }

    /// <summary>
    /// 音频暂停
    /// </summary>
    public static void AudioPause()
    {
        if (m_CurrentAudoiSource != null)
        {
            m_CurrentAudoiSource.Pause();
        }
    }

    /// <summary>
    /// 继续播放
    /// </summary>
    public static void AudioUnPause()
    {
        if (m_CurrentAudoiSource != null)
        {
            m_CurrentAudoiSource.UnPause();
        }
    }

    /// <summary>
    /// 音频播放
    /// </summary>
    public static void AudioPlay()
    {
        if (m_CurrentAudoiSource != null)
        {
            m_CurrentAudoiSource.Play();
        }
    }

    /// <summary>
    /// 设置音频音量
    /// </summary>
    /// <param name="_volume"></param>
    public static void SetAudioVolume(float _volume)
    {
        if (m_CurrentAudoiSource != null)
        {
            m_CurrentAudoiSource.volume = _volume;
        }
    }

    /// <summary>
    /// 停止播放
    /// </summary>
    public static void AudioStop()
    {
        if (m_CurrentAudoiSource != null)
        {
            m_CurrentAudoiSource.Stop();
        }
    }

    /// <summary>
    /// 播放音频
    /// </summary>
    /// <param name="audioClip"></param>
    public static IEnumerator PlayAudio(AudioClip audioClip, Action playFinishCall = null)
    {
        ClearCrrentAudioSource();

        if (m_CurrentAudoiSource != null && audioClip != null)
        {
            // 先停止
            m_CurrentAudoiSource.Stop();
            // 再清空一次
            m_CurrentAudoiSource.clip = null;
            // 然后在赋值
            m_CurrentAudoiSource.clip = audioClip;
            // 先暂停，然后播放
            m_CurrentAudoiSource.Stop();
            m_CurrentAudoiSource.Play();

            yield return new WaitForSeconds(audioClip.length);
            playFinishCall?.Invoke();
        }
        else
        {
            yield return new WaitForSeconds(9f);
            playFinishCall?.Invoke();
        }
    }

    /// <summary>
    /// 清空当前的播放
    /// </summary>
    private static void ClearCrrentAudioSource()
    {
        if (m_CurrentAudoiSource != null)
        {
            if (m_CurrentAudoiSource.isPlaying) m_CurrentAudoiSource.Stop();

            m_CurrentAudoiSource.clip = null;
        }
    }

    /// <summary>
    /// 加载指定音频文件
    /// </summary>
    /// <param name="_folderName"></param>
    /// <param name="_audioName"></param>
    /// <returns></returns>
    public static IEnumerator LoadSpecifiedAudioFile(string _folderName, string _audioName,Action<float> audioClipLengthCall = null,Action audioPlayFinishCall = null)
    {
        // 合并完整路径信息
        string audioPath = PathHelper.CombineFilePath(PathHelper.m_ReadOnlyPath, _folderName, _audioName + ".mp3");
        // 判断文件是否存在
        if (File.Exists(audioPath))
        {
            using (UnityWebRequest webRequest = UnityWebRequestMultimedia.GetAudioClip(audioPath, AudioType.MPEG))
            {
                yield return webRequest.SendWebRequest();

                if (webRequest.isHttpError || webRequest.isNetworkError)
                {
                    Debug.LogError("音频文件加载出错！");
                }
                else
                {
                    // 获取到 AudioClip
                    AudioClip audioClip = DownloadHandlerAudioClip.GetContent(webRequest);

                    if (audioClip != null)
                    {
                        audioClipLengthCall?.Invoke(audioClip.length);
                    }else
                    {
                        audioClipLengthCall?.Invoke(0);
                    }

                    if (m_CurrentAudoiSource == null)
                    {
                        GetAudioComponent();
                    }

                    if (m_CurrentAudoiSource != null)
                    {
                        // 先停止
                        m_CurrentAudoiSource.Stop();
                        // 再清空一次
                        m_CurrentAudoiSource.clip = null;
                        // 然后在赋值
                        m_CurrentAudoiSource.clip = audioClip;
                        // 先暂停，然后播放
                        m_CurrentAudoiSource.Stop();
                        m_CurrentAudoiSource.Play();

                        yield return new WaitForSeconds(audioClip.length);
                        audioPlayFinishCall?.Invoke();
                    }
                }
            }
        }
        else
        {
            Debug.LogError("缺少音频文件：" + audioPath);
        }
    }

    /// <summary>
    /// 加载单个音频文件
    /// </summary>
    /// <param name="clipName">音频文件名字</param>
    public static IEnumerator LoadAudioClip(string deviceName, string clipName, AudioType type, Action<AudioClip> callBack)
    {
        string extension = string.Empty;
        switch (type)
        {
            case AudioType.MPEG:
                extension = ".mp3";
                break;
            case AudioType.WAV:
                extension = ".wav";
                break;
            case AudioType.VAG:
                extension = ".vag";
                break;
        }

        var path = PathHelper.CombineFilePath(PathHelper.m_ReadOnlyPath, "Config","Audios", deviceName, clipName + extension);

        if (File.Exists(path))
        {
            UnityWebRequest request = UnityWebRequestMultimedia.GetAudioClip(path, type);

            yield return request.SendWebRequest();

            if (request.isHttpError || request.isNetworkError)
            {
                Debug.LogError("加载出错!" + request.error);
                callBack?.Invoke(null);
            }
            else
            {
                callBack?.Invoke(DownloadHandlerAudioClip.GetContent(request));
            }
        }
        else
        {
            callBack?.Invoke(null);
            Debug.LogError("缺少音频文件:" + clipName + extension);
        }
    }

    /// <summary>
    /// 加载音频文件
    /// </summary>
    /// <param name="_folderName"></param>
    /// <param name="_audioName"></param>
    /// <param name="loadCallBack"></param>
    /// <returns></returns>
    public static IEnumerator LoadSpecifiedAudioFile(string _folderName, string _audioName, Action<AudioClip> loadCallBack)
    {
        AudioClip tmpAudioClip = null;

        // 合并完整路径信息
        string audioPath = PathHelper.CombineFilePath(PathHelper.m_ReadOnlyPath, _folderName, _audioName);

        // 判断文件是否存在
        if (File.Exists(audioPath))
        {
            using (UnityWebRequest webRequest = UnityWebRequestMultimedia.GetAudioClip(audioPath, AudioType.MPEG))
            {
                yield return webRequest.SendWebRequest();

                if (webRequest.isHttpError || webRequest.isNetworkError)
                {
                    Debug.LogError("音频文件加载出错！");
                    loadCallBack.Invoke(tmpAudioClip);
                }
                else
                {
                    // 获取到 AudioClip
                    tmpAudioClip = DownloadHandlerAudioClip.GetContent(webRequest);

                    loadCallBack.Invoke(tmpAudioClip);
                }
            }
        }
        else
        {
            Debug.LogError("缺少音频文件：" + _audioName);
            loadCallBack.Invoke(tmpAudioClip);
        }
    }

    /// <summary>
    /// 获取当前音频播放器
    /// </summary>
    /// <returns></returns>
    public static AudioSource GetCurrentAudioSource()
    {
        return m_CurrentAudoiSource;
    }
}