Unity 工具類 之 UnityWebRequest 常用功能封裝

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

/*  使用案例：

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.UI;

public class TestScript : MonoBehaviour
{
    public RawImage rawImage;
    public Text text;

    // Start is called before the first frame update
    void Start()
    {
        // 獲取圖片
        UnityWebRequestMgr.Instance.GetTexture(Application.dataPath + "/TestAssets/Cat.jpg", 
            SetTexttureToRawImage);

        // 獲取文本
        UnityWebRequestMgr.Instance.Get(Application.dataPath + "/TestAssets/TextFile.txt", 
            (uwr) => { text.text = uwr.downloadHandler.text;  });

        // 下載文件
        UnityWebRequestMgr.Instance.DownloadFile(Application.dataPath + "/TestAssets/TextFile.txt",
            Application.dataPath + "/TestAssets/DownloadTextFile.txt",
            (uwr) => { Debug.Log("文件下載成功：" + Application.dataPath + "/TestAssets/DownloadTextFile.txt");  });

        // 獲取音頻文件
        UnityWebRequestMgr.Instance.GetAudioClip(Application.dataPath + "/TestAssets/AttackFire.wav",
            (audioclip) => {
                this.gameObject.AddComponent<AudioSource>().clip = audioclip;
                this.gameObject.GetComponent<AudioSource>().Play();
            },
            AudioType.WAV
            );
    }
    void SetTexttureToRawImage(Texture texture) {
        rawImage.texture = texture;
    }
}


*/


/// <summary>
///UnityWebRequest下載上傳資源管理器
/// </summary>
public class UnityWebRequestMgr : MonoBehaviour
{


    #region 單例

    private static UnityWebRequestMgr instance = null;

    private static readonly object locker = new object();

    private static bool bAppQuitting;

    public static UnityWebRequestMgr Instance
    {
        get
        {
            if (bAppQuitting)
            {
                instance = null;
                return instance;
            }

            lock (locker)
            {
                if (instance == null)
                {
                    instance = FindObjectOfType<UnityWebRequestMgr>();
                    if (FindObjectsOfType<UnityWebRequestMgr>().Length > 1)
                    {
                        Debug.LogError("不應該存在多個單例！");
                        return instance;
                    }

                    if (instance == null)
                    {
                        var singleton = new GameObject();
                        instance = singleton.AddComponent<UnityWebRequestMgr>();
                        singleton.name = "(singleton)" + typeof(UnityWebRequestMgr);
                        singleton.hideFlags = HideFlags.None;
                        DontDestroyOnLoad(singleton);
                    }
                    else
                        DontDestroyOnLoad(instance.gameObject);
                }
                instance.hideFlags = HideFlags.None;
                return instance;
            }
        }
    }

    private void Awake()
    {
        bAppQuitting = false;
    }

    private void OnDestroy()
    {
        bAppQuitting = true;
    }

    #endregion


    /// <summary>
    /// GET請求
    /// </summary>
    /// <param name="url"></param>
    /// <param name="action"></param>
    public void Get(string url, Action<UnityWebRequest> actionResult)
    {
        StartCoroutine(_Get(url, actionResult));
    }

    /// <summary>
    /// 下載文件
    /// </summary>
    /// <param name="url">請求地址</param>
    /// <param name="downloadFilePathAndName">儲存文件的路徑和文件名 like 'Application.persistentDataPath+"/unity3d.html"'</param>
    /// <param name="actionResult">請求發起後處理回調結果的委託,處理請求對象</param>
    /// <returns></returns>
    public void DownloadFile(string url, string downloadFilePathAndName, Action<UnityWebRequest> actionResult)
    {
        StartCoroutine(_DownloadFile(url, downloadFilePathAndName, actionResult));
    }

    /// <summary>
    /// 請求圖片
    /// </summary>
    /// <param name="url">圖片地址,like 'http://www.shijing720.com/image.png '</param>
    /// <param name="action">請求發起後處理回調結果的委託,處理請求結果的圖片</param>
    /// <returns></returns>
    public void GetTexture(string url, Action<Texture2D> actionResult)
    {
        StartCoroutine(_GetTexture(url, actionResult));
    }

    /// <summary>
    /// 請求AssetBundle
    /// </summary>
    /// <param name="url">AssetBundle地址,like 'http://www.shijing720.com/myData.unity3d'</param>
    /// <param name="actionResult">請求發起後處理回調結果的委託,處理請求結果的AssetBundle</param>
    /// <returns></returns>
    public void GetAssetBundle(string url, Action<AssetBundle> actionResult)
    {
        StartCoroutine(_GetAssetBundle(url, actionResult));
    }

    /// <summary>
    /// 請求服務器地址上的音效
    /// </summary>
    /// <param name="url">沒有音效地址,like 'http://www.shijing720.com/mysound.wav'</param>
    /// <param name="actionResult">請求發起後處理回調結果的委託,處理請求結果的AudioClip</param>
    /// <param name="audioType">音效類型</param>
    /// <returns></returns>
    public void GetAudioClip(string url, Action<AudioClip> actionResult, AudioType audioType = AudioType.WAV)
    {
        StartCoroutine(_GetAudioClip(url, actionResult, audioType));
    }

    /// <summary>
    /// 向服務器提交post請求
    /// </summary>
    /// <param name="serverURL">服務器請求目標地址,like "http://www.shijing720.com/myform"</param>
    /// <param name="lstformData">form表單參數</param>
    /// <param name="lstformData">處理返回結果的委託,處理請求對象</param>
    /// <returns></returns>
    public void Post(string serverURL, List<IMultipartFormSection> lstformData, Action<UnityWebRequest> actionResult)
    {
        //List<IMultipartFormSection> formData = new List<IMultipartFormSection>();
        //formData.Add(new MultipartFormDataSection("field1=foo&field2=bar"));
        //formData.Add(new MultipartFormFileSection("my file data", "myfile.txt"));

        StartCoroutine(_Post(serverURL, lstformData, actionResult));
    }

    /// <summary>
    /// 通過PUT方式將字節流傳到服務器
    /// </summary>
    /// <param name="url">服務器目標地址 like 'http://www.shijing720.com/upload' </param>
    /// <param name="contentBytes">需要上傳的字節流</param>
    /// <param name="resultAction">處理返回結果的委託</param>
    /// <returns></returns>
    public void UploadByPut(string url, byte[] contentBytes, Action<bool> actionResult)
    {
        StartCoroutine(_UploadByPut(url, contentBytes, actionResult, ""));
    }

    /// <summary>
    /// GET請求
    /// </summary>
    /// <param name="url">請求地址,like 'http://www.shijing720.com/ '</param>
    /// <param name="action">請求發起後處理回調結果的委託</param>
    /// <returns></returns>
    IEnumerator _Get(string url, Action<UnityWebRequest> actionResult)
    {
        using (UnityWebRequest uwr = UnityWebRequest.Get(url))
        {
            yield return uwr.SendWebRequest();
            if (!(uwr.isNetworkError || uwr.isHttpError))
            {
                if (actionResult != null)
                {
                    actionResult(uwr);
                }
            }
            else
            {
                Debug.Log("下載失敗，請檢查網絡，或者下載地址是否正確: " + url);
            }
        }
    }

    /// <summary>
    /// 下載文件
    /// </summary>
    /// <param name="url">請求地址</param>
    /// <param name="downloadFilePathAndName">儲存文件的路徑和文件名 like 'Application.persistentDataPath+"/unity3d.html"'</param>
    /// <param name="actionResult">請求發起後處理回調結果的委託,處理請求對象</param>
    /// <returns></returns>
    IEnumerator _DownloadFile(string url, string downloadFilePathAndName, Action<UnityWebRequest> actionResult)
    {
        var uwr = new UnityWebRequest(url, UnityWebRequest.kHttpVerbGET);
        uwr.downloadHandler = new DownloadHandlerFile(downloadFilePathAndName);
        yield return uwr.SendWebRequest();

        if (!(uwr.isNetworkError || uwr.isHttpError))
        {
            if (actionResult != null)
            {
                actionResult(uwr);
            }
        }      
        else
        {
            Debug.Log("下載失敗，請檢查網絡，或者下載地址是否正確: " + url);
        }
    }

    /// <summary>
    /// 請求圖片
    /// </summary>
    /// <param name="url">圖片地址,like 'http://www.shijing720.com/image.png '</param>
    /// <param name="action">請求發起後處理回調結果的委託,處理請求結果的圖片</param>
    /// <returns></returns>
    IEnumerator _GetTexture(string url, Action<Texture2D> actionResult)
    {
        UnityWebRequest uwr = new UnityWebRequest(url);
        DownloadHandlerTexture downloadTexture = new DownloadHandlerTexture(true);
        uwr.downloadHandler = downloadTexture;
        yield return uwr.SendWebRequest();
        Texture2D t = null;
        if (!(uwr.isNetworkError || uwr.isHttpError))
        {
            t = downloadTexture.texture;
        }
        else
        {
            Debug.Log("下載失敗，請檢查網絡，或者下載地址是否正確: " + url);
        }

        if (actionResult != null)
        {
            actionResult(t);
        }
    }

    /// <summary>
    /// 請求AssetBundle
    /// </summary>
    /// <param name="url">AssetBundle地址,like 'http://www.shijing720.com/myData.unity3d'</param>
    /// <param name="actionResult">請求發起後處理回調結果的委託,處理請求結果的AssetBundle</param>
    /// <returns></returns>
    IEnumerator _GetAssetBundle(string url, Action<AssetBundle> actionResult)
    {
        UnityWebRequest www = new UnityWebRequest(url);
        DownloadHandlerAssetBundle handler = new DownloadHandlerAssetBundle(www.url, uint.MaxValue);
        www.downloadHandler = handler;
        yield return www.SendWebRequest();
        AssetBundle bundle = null;
        if (!(www.isNetworkError || www.isHttpError))
        {
            bundle = handler.assetBundle;

            if (actionResult != null)
            {
                actionResult(bundle);
            }

        }
        else
        {
            Debug.Log("下載失敗，請檢查網絡，或者下載地址是否正確: " + url);

        }

    }

    /// <summary>
    /// 請求服務器地址上的音效
    /// </summary>
    /// <param name="url">沒有音效地址,like 'http://www.shijing720.com/mysound.wav'</param>
    /// <param name="actionResult">請求發起後處理回調結果的委託,處理請求結果的AudioClip</param>
    /// <param name="audioType">音效類型</param>
    /// <returns></returns>
    IEnumerator _GetAudioClip(string url, Action<AudioClip> actionResult, AudioType audioType = AudioType.WAV)
    {
        using (var uwr = UnityWebRequestMultimedia.GetAudioClip(url, audioType))
        {
            yield return uwr.SendWebRequest();
            if (!(uwr.isNetworkError || uwr.isHttpError))
            {
                if (actionResult != null)
                {
                    actionResult(DownloadHandlerAudioClip.GetContent(uwr));
                }
            }
            else {
                Debug.Log("下載失敗，請檢查網絡，或者下載地址是否正確: " + url);
            }
        }
    }

    /// <summary>
    /// 向服務器提交post請求
    /// </summary>
    /// <param name="serverURL">服務器請求目標地址,like "http://www.shijing720.com/myform"</param>
    /// <param name="lstformData">form表單參數</param>
    /// <param name="lstformData">處理返回結果的委託</param>
    /// <returns></returns>
    IEnumerator _Post(string serverURL, List<IMultipartFormSection> lstformData, Action<UnityWebRequest> actionResult)
    {
        //List<IMultipartFormSection> formData = new List<IMultipartFormSection>();
        //formData.Add(new MultipartFormDataSection("field1=foo&field2=bar"));
        //formData.Add(new MultipartFormFileSection("my file data", "myfile.txt"));
        UnityWebRequest uwr = UnityWebRequest.Post(serverURL, lstformData);
        yield return uwr.SendWebRequest();
        if (actionResult != null)
        {
            actionResult(uwr);
        }
    }

    /// <summary>
    /// 通過PUT方式將字節流傳到服務器
    /// </summary>
    /// <param name="url">服務器目標地址 like 'http://www.shijing720.com/upload' </param>
    /// <param name="contentBytes">需要上傳的字節流</param>
    /// <param name="resultAction">處理返回結果的委託</param>
    /// <param name="resultAction">設置header文件中的Content-Type屬性</param>
    /// <returns></returns>
    IEnumerator _UploadByPut(string url, byte[] contentBytes, Action<bool> actionResult, string contentType = "application/octet-stream")
    {
        UnityWebRequest uwr = new UnityWebRequest();
        UploadHandler uploader = new UploadHandlerRaw(contentBytes);

        // Sends header: "Content-Type: custom/content-type";
        uploader.contentType = contentType;

        uwr.uploadHandler = uploader;

        yield return uwr.SendWebRequest();

        bool res = true;
        if (uwr.isNetworkError || uwr.isHttpError)
        {
            res = false;
        }
        if (actionResult != null)
        {
            actionResult(res);
        }
    }
}