长江后浪推前浪，UnityWebRequest替代WWW

最新推荐文章于 2024-06-11 17:35:31 发布
最新推荐文章于 2024-06-11 17:35:31 发布
阅读量1.8w 收藏 222
点赞数 63
分类专栏： Unity3D 文章标签： unity unitywebrequest www get post
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/linxinfa/article/details/94436027
版权

文章目录

一、什么时候用UnityWebRequest

在Unity中，我们可以用系统的WWW或者HttpWebRequest来实现文件的下载。
因为WWW不存在设置timeout属性，因此当我们网络不好请求超时的时候，无法简单的做出判断。
当网络极差的时候，游戏下载将会停止（即一直在等待yield return www）当时间较长时网络恢复将无法继续下载，也没有提示，需要重启才能重新下载。
Unity早在5.4版本的时候就出了新的API UnityWebRequest用于替代WWW
有些较大的文件下载需要断点续传的功能（即下载了一部分突然中断下载后，再次下载直接从上次下载的地方继续下载，而不是重新下载），就需要使用HttpWebRequest或UnityWebRequest。

注：
WWW在UnityEngine命名空间下
HttpWebRequest在System.Net命名空间下
UnityWebRequest在UnityEngine.Networking命名空间下

二、UnityWebRequest常用方法与属性介绍

1、概述

UnityWebRequest支持与上传，下载及断点续传功能。

UnityWebRequest由三个元素组成：
1 UploadHandler处理数据将数据上传到服务器的对象；
2 DownloadHandler从服务器下载数据的对象；
3 UnityWebRequest负责与HTTP通信并管理上面两个对象。

常用方法

方法作用
SendWebRequest()开始与远程服务器通信。在调用此方法之后，有必要的话UnityWebRequest将执行DNS解析，将HTTP请求发送到目标URL的远程服务器并处理服务器的响应。
Get(url)创建一个HTTP为传入URL的UnityWebRequest对象
Post（url)向Web服务器发送表单信息
Put(url)将数据上传到 Web服务器
Abort()直接结束联网
Head()创建一个为传输HTTP头请求的 UnityWebRequest对象
GetResponseHeader()返回一个字典，内容为在最新的HTTP响应中收到的所有响应头
2、构造函数
public UnityWebRequest（）; 
public UnityWebRequest（Uri uri）;
public UnityWebRequest（Uri uri，string method）;
public UnityWebRequest（Uri uri，string method,Networking.DownloadHandler downloadHandler， 
						Networking.UploadHandler uploadHandler）;

参数:
解释一下参数的含义：

参数含义
method相当于方法名，只有GET, POST, PUT, HEAD四种，默认为GET，一旦调用SendWebRequest()，就无法更改
downloadHandler下载数据的委托方法
uploadHandler上传数据的委托方法

例

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

/// <summary>
/// 网络请求测试
/// </summary>
public class ChinarWebRequest : MonoBehaviour
{
    void Start()
    {
        StartCoroutine(SendRequest());
    }

    /// <summary>
    /// 开启一个协程，发送请求
    /// </summary>
    /// <returns></returns>
    IEnumerator SendRequest()
    {
        Uri uri = new Uri("http://www.baidu.com"); //Uri 是 System 命名空间下的一个类,注意引用该命名空间
        UnityWebRequest uwr = new UnityWebRequest(uri);        //创建UnityWebRequest对象
        uwr.timeout = 5;
        yield return uwr.SendWebRequest();                     //等待返回请求的信息
        if (uwr.isHttpError || uwr.isNetworkError)             //如果其 请求失败，或是 网络错误
        {
            Debug.LogError(uwr.error); //打印错误原因
        }
        else //请求成功
        {
            Debug.Log("请求成功");
            //如果访问的链接有返回文本结果，比如json文本，则通过text获取
            //string result = uwr.downloadHandler.text;
            //如果访问的是资源链接，比如图片，则通过data拿到图片二进制流
            //byte[] data = uwr.downloadHandler.data;
        }
    }
}
3、Get方法

Get方法，创建一个 UnityWebReqest对象，参数传入URL。

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


/// <summary>
/// 网络请求测试
/// </summary>
public class ChinarWebRequest : MonoBehaviour
{
    void Start()
    {
        StartCoroutine(SendRequest());
    }

    /// <summary>
    /// 开启一个协程，发送请求
    /// </summary>
    /// <returns></returns>
    IEnumerator SendRequest()
    {
        UnityWebRequest uwr = UnityWebRequest.Get("http://www.baidu.com"); //创建UnityWebRequest对象
        yield return uwr.SendWebRequest();                                 //等待返回请求的信息
        if (uwr.isHttpError || uwr.isNetworkError)                         //如果其 请求失败，或是 网络错误
        {
            Debug.Log(uwr.error); //打印错误原因
        }
        else //请求成功
        {
            Debug.Log("Get:请求成功");
            //如果访问的链接有返回文本结果，比如json文本，则通过text获取
            //string result = uwr.downloadHandler.text;
            //如果访问的是资源链接，比如图片，则通过data拿到图片二进制流
            //byte[] data = uwr.downloadHandler.data;
        }
    }
}
4、Post方法

Post方法将一个表上传到远程的服务器，一般来说我们登陆某个网站的时候会用到这个方法，我们的账号密码会以一个表单的形式传过去。

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

/// <summary>
/// 网络请求测试
/// </summary>
public class ChinarWebRequest : MonoBehaviour
{
    void Start()
    {
        StartCoroutine(Post());
    }
    /// <summary>
    /// 开启一个协程，发送请求
    /// </summary>
    /// <returns></returns>
    IEnumerator Post()
    {
        WWWForm form = new WWWForm();
        //键值对
        form.AddField("key",  "value");
        form.AddField("name", "Chinar");
        //请求链接，并将form对象发送到远程服务器
        UnityWebRequest webRequest = UnityWebRequest.Post("http://www.baidu.com", form);

        yield return webRequest.SendWebRequest();
        if (webRequest.isHttpError || webRequest.isNetworkError)
        {
            Debug.Log(webRequest.error);
        }
        else
        {
            Debug.Log("发送成功"); 
        }
    }
}
5、Put方法

Put方法将数据发送到远程的服务器。

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

/// <summary>
/// 网络请求测试
/// </summary>
public class ChinarWebRequest : MonoBehaviour
{
    void Start()
    {
        StartCoroutine(Upload());
    }
    
    /// <summary>
    /// 开启协程
    /// </summary>
    /// <returns></returns>
    IEnumerator Upload()
    {
        byte[] myData = System.Text.Encoding.UTF8.GetBytes("Chinar的测试数据");
        using (UnityWebRequest uwr = UnityWebRequest.Put("http://www.baidu.com", myData))
        {
            yield return uwr.SendWebRequest();

            if (uwr.isNetworkError || uwr.isHttpError)
            {
                Debug.Log(uwr.error);
            }
            else
            {
                Debug.Log("上传成功!");
            }
        }
    }
}
6、Abort方法

Abort方法会尽快结束联网，可以随时调用此方法。
如果 UnityWebRequest尚未完成，那么 UnityWebRequest将尽快停止上传或下载数据。 中止的 UnityWebRequests被认为遇到了系统错误。
isNetworkError或isHttpError属性将返回true，error属性将为“User Aborted”。

7、Head方法

Head方法与Get方法用法一致，都是传入一个URL。

/// <summary>
/// 开启一个协程，发送请求
/// </summary>
/// <returns></returns>
IEnumerator SendRequest1()
{
	UnityWebRequest uwr = UnityWebRequest.Head("http://www.chinar.xin/chinarweb/WebRequest/Get/00-效果.mp4"); //创建UnityWebRequest对象
	yield return uwr.SendWebRequest();                                 //等待返回请求的信息
	if (uwr.isHttpError || uwr.isNetworkError)                         //如果其 请求失败，或是 网络错误
	{
		Debug.Log(uwr.error); //打印错误原因
	}
	else //请求成功
	{
		Debug.Log("Head:请求成功");
	}
}
8、GetResponseHeader方法

GetResponseHeader方法可以用来获取请求文件的长度 传入参数 "Content-Length"字符串，表示获取文件内容长度。

/// <summary>
/// 开启一个协程，发送请求
/// </summary>
/// <returns></returns>
IEnumerator SendRequest1()
{
    UnityWebRequest uwr = UnityWebRequest.Head("http://www.chinar.xin/chinarweb/WebRequest/Get/00-效果.mp4"); //创建UnityWebRequest对象
    yield return uwr.SendWebRequest();                                 //等待返回请求的信息
    if (uwr.isHttpError || uwr.isNetworkError)                         //如果其 请求失败，或是 网络错误
    {
        Debug.Log(uwr.error); //打印错误原因
    }
    else //请求成功
    {
    	long totalLength = long.Parse(huwr.GetResponseHeader("Content-Length")); //首先拿到文件的全部长度
        Debug.Log("totalLength");//打印文件长度
    }
}
9、常用属性
属性类型含义
timeoutint等待时间(秒)超过此数值是 UnityWebReqest的尝试连接将终止
isHttpErrorboolHTTP响应出现出现错误
isNetworkErrorbool系统出现错误
errorstring描述 UnityWebRequest对象在处理HTTP请求或响应时遇到的任何系统错误
downloadProgressfloat表示从服务器下载数据的进度
uploadProgressfloat表示从服务器上传数据的进度
isDonebool是否完成与远程服务器的通信

三、案例

1、下载文件
using System;
using System.Collections;
using System.IO;
using UnityEditor;
using UnityEngine;
using UnityEngine.Networking;
using UnityEngine.UI;

public class ChinarDownLoadFile : MonoBehaviour
{
    public Slider ProgressBar; //进度条
    public Text SliderValue; //滑动条值
    
    private Button startBtn;    //开始按钮

    void Start()
    {
        //初始化进度条和文本框
        ProgressBar.value = 0;
        SliderValue.text = "0.0%";
        startBtn = GameObject.Find("Start Button").GetComponent<Button>();
        startBtn.onClick.AddListener(OnClickStartDownload);
    }


    /// <summary>
    /// 回调函数：开始下载
    /// </summary>
    public void OnClickStartDownload()
    {
        StartCoroutine(DownloadFile());
    }


    /// <summary>
    /// 协程：下载文件
    /// </summary>
    IEnumerator DownloadFile()
    {
        UnityWebRequest uwr = UnityWebRequest.Get("http://www.linxinfa.test.mp4.mp4"); //创建UnityWebRequest对象，将Url传入
        uwr.SendWebRequest();                                                                                  //开始请求
        if (uwr.isNetworkError || uwr.isHttpError)                                                             //如果出错
        {
            Debug.Log(uwr.error); //输出 错误信息
        }
        else
        {
            while (!uwr.isDone) //只要下载没有完成，一直执行此循环
            {
                ProgressBar.value = uwr.downloadProgress; //展示下载进度
                SliderValue.text  = Math.Floor(uwr.downloadProgress * 100) + "%";
                yield return 0;
            }

            if (uwr.isDone) //如果下载完成了
            {
                print("完成");
                ProgressBar.value = 1; //改变Slider的值
                SliderValue.text  = 100 + "%";
            }

            byte[] results = uwr.downloadHandler.data;
            // 注意真机上要用Application.persistentDataPath
            CreateFile(Application.streamingAssetsPath + "/MP4/test.mp4", results, uwr.downloadHandler.data.Length);
            AssetDatabase.Refresh(); //刷新一下
        }
    }


    /// <summary>
    /// 这是一个创建文件的方法
    /// </summary>
    /// <param name="path">保存文件的路径</param>
    /// <param name="bytes">文件的字节数组</param>
    /// <param name="length">数据长度</param>
    void CreateFile(string path, byte[] bytes, int length)
    {
        Stream   sw;
        FileInfo file = new FileInfo(path);
        if (!file.Exists)
        {
            sw = file.Create();
        }
        else
        {
            return;
        }

        sw.Write(bytes, 0, length);
        sw.Close();
        sw.Dispose();
    }
}
2、断点续传
using System;
using System.Collections;
using System.IO;
using UnityEngine;
using UnityEngine.Networking;
using UnityEngine.UI;

public class ChinarBreakpointRenewal : MonoBehaviour
{
    private bool _isStop;       //是否暂停

    public Slider ProgressBar; //进度条
    public Text SliderValue; //滑动条值
    private Button startBtn;    //开始按钮
    private Button pauseBtn;    //暂停按钮
    public string Url = "http://www.linxinfa.test.mp4";

    /// <summary>
    /// 初始化UI界面及给按钮绑定方法
    /// </summary>
    void Start()
    {
        //初始化进度条和文本框
        ProgressBar.value = 0;
        SliderValue.text = "0.0%";
        startBtn = GameObject.Find("Start Button").GetComponent<Button>();
        startBtn.onClick.AddListener(OnClickStartDownload);
        pauseBtn = GameObject.Find("Pause Button").GetComponent<Button>();
        pauseBtn.onClick.AddListener(OnClickStop);
    }


    /// <summary>
    /// 回调函数：开始下载
    /// </summary>
    public void OnClickStartDownload()
    {
    	// 注意真机上要用Application.persistentDataPath
        StartCoroutine(DownloadFile(Url, Application.streamingAssetsPath + "/MP4/test.mp4", CallBack));
    }


    /// <summary>
    /// 协程：下载文件
    /// </summary>
    /// <param name="url">请求的Web地址</param>
    /// <param name="filePath">文件保存路径</param>
    /// <param name="callBack">下载完成的回调函数</param>
    /// <returns></returns>
    IEnumerator DownloadFile(string url, string filePath, Action callBack)
    {
        UnityWebRequest huwr = UnityWebRequest.Head(url); //Head方法可以获取到文件的全部长度
        yield return huwr.SendWebRequest();
        if (huwr.isNetworkError || huwr.isHttpError) //如果出错
        {
            Debug.Log(huwr.error); //输出 错误信息
        }
        else
        {
            long   totalLength = long.Parse(huwr.GetResponseHeader("Content-Length")); //首先拿到文件的全部长度
            string dirPath     = Path.GetDirectoryName(filePath);
            if (!Directory.Exists(dirPath)) //判断路径是否存在
            {
                Directory.CreateDirectory(dirPath);
            }

            //创建一个文件流，指定路径为filePath,模式为打开或创建，访问为写入
            using (FileStream fs = new FileStream(filePath, FileMode.OpenOrCreate, FileAccess.Write))
            {
                long nowFileLength = fs.Length; //当前文件长度
                Debug.Log(fs.Length);
                if (nowFileLength < totalLength)
                {
                    Debug.Log("还没下载完成");
                    fs.Seek(nowFileLength, SeekOrigin.Begin);       //从头开始索引，长度为当前文件长度
                    UnityWebRequest uwr = UnityWebRequest.Get(url); //创建UnityWebRequest对象，将Url传入
                    uwr.SetRequestHeader("Range", "bytes=" + nowFileLength + "-" + totalLength);
                    uwr.SendWebRequest();                      //开始请求
                    if (uwr.isNetworkError || uwr.isHttpError) //如果出错
                    {
                        Debug.Log(uwr.error); //输出 错误信息
                    }
                    else
                    {
                        long index = 0;     //从该索引处继续下载
                        while (nowFileLength < totalLength) //只要下载没有完成，一直执行此循环
                        {
                            if (_isStop) break;
                            yield return null;
                            byte[] data = uwr.downloadHandler.data;
                            if (data != null)
                            {
                                long length = data.Length - index;
                                fs.Write(data, (int) index, (int) length); //写入文件
                                index += length;
                                nowFileLength += length;
                                ProgressBar.value = (float) nowFileLength / totalLength;
                                SliderValue.text = Math.Floor((float) nowFileLength / totalLength * 100) + "%";
                                if (nowFileLength >= totalLength) //如果下载完成了
                                {
                                    ProgressBar.value = 1; //改变Slider的值
                                    SliderValue.text = 100 + "%";
                                    callBack?.Invoke();
                                    break;
                                }
                            }
                        }
                    }
                }
            }
        }
    }

    /// <summary>
    /// 下载完成后的回调函数
    /// </summary>
    void CallBack()
    {
        Debug.Log("下载完成");
    }

    /// <summary>
    /// 暂停下载
    /// </summary>
    public void OnClickStop()
    {
        if (_isStop)
        {
            pauseBtn.GetComponentInChildren<Text>().text = "暂停下载";
            Debug.Log("继续下载");
            _isStop = !_isStop;
            OnClickStartDownload();
        }
        else
        {
            pauseBtn.GetComponentInChildren<Text>().text = "继续下载";
            Debug.Log("暂停下载");
            _isStop = !_isStop;
        }
    }
}
3、文件上传

参见我另外这篇文章的案例：《Unity使用UnityWebRequest实现本地日志上传到web服务器》

林新发
关注
专栏目录
游戏引擎中UnityWebRequest类
听老罗娓娓道来
09-19 545
类是基于 .NET 的类构建的，但它提供了更高级别的抽象和 Unity 特定的功能。以下是请求构建器：用于设置请求的 URL、方法、头部、正文等。请求执行器：负责实际发送请求并接收响应。响应处理器：处理服务器返回的数据，可以是文本、二进制数据或其他格式。错误处理器：处理网络错误和 HTTP 错误。异步操作支持：通过协程和回调机制支持异步操作。
长江后浪推前浪、一浪更比一浪强！想专一就选C++！！！噩梦缠身便是学习C++的感觉~~~痛并快乐着~~~
cfl997
12-12 2万+
想专一就选C++！！！ 不知道什么时候发生的一个现象，大多数人刚开始学语言，听到C和C++给人的感觉就不好！ 这东西，一听好像就不是Java、Python时尚、潮流的主。狂拽炫酷┗( ▔, ▔ )┛ 我们看看新一代选手的实力： 仅Java和Python用途包括方面好像就已经胜利了/(ㄒoㄒ)/~~ Android & IOS 应用开发，视频游戏开发，桌面GUIs（即图形用户页面...
unity 用UnityWebRequest实现文件分段下载，可扩展断点续传
08-12
使用unity自带的UnityWebRequest实现文件分段下载，可扩展断点续传，功能已经写好，只需自己控制断点续传本地缓存文件长度读取并传入函数参数即可
Unity之UnityWebRequest和使用
热门推荐
qq_42345116的博客
03-10 4万+
官方描述：UnityWebRequest 提供了一个模块化系统，用于构成 HTTP 请求和处理 HTTP 响应。UnityWebRequest 系统的主要目标是让 Unity 游戏与 Web 浏览器后端进行交互。该系统还支持高需求功能，例如分块 HTTP 请求、流式 POST/PUT 操作以及对 HTTP 标头和动词的完全控制。
Unity网络请求方式UnityWebRequest
梦想是世界和平
05-17 1万+
在unity2019中，“WWW"的资源加载方式过时了，新的方法为"UnityWebRequest” 使用方法如下： 1.加载图片资源 using UnityEngine; using UnityEngine.Networking; using System.Collections; public class MyBehaviour : MonoBehaviour { void Start() { StartCoroutine(GetText()); } IEnumerator GetText() {
Unity中的UnityWebRequest
个人学习笔记
01-29 1001
【代码】Unity中的UnityWebRequest。
Unity中UnityWebRequest的使用
Dragon Peng 的博客
01-29 2184
UnityWebRequest的使用仅下载文件存至本地读取图片读取文件 仅下载文件存至本地 仅下载文件存至本地推荐使用DownloadHandlerFile public IEnumerator DownFile() { //下载路径 string url = ""; //存储的本地路径 string localurl = ""; UnityWebRequest WebRequest = new UnityWebRequest(url); DownloadHandlerFile Downlo
远区台风“三巴”对长江口波浪动力场的作用机制.docx
02-23
【标题】:远区台风“三巴”对长江口波浪动力场的作用机制 【摘要】:远区台风虽然距离长江口较远，但其引发的波浪动力效应不容忽视。以2012年的16号台风“三巴”为例，尽管台风中心距长江口超过七级风圈半径，但仍然...
长江支流——长江流域范围——矢量边界支流名称
05-07
长江支流——长江流域范围——矢量边界支流名称长江支流——长江流域范围——矢量边界支流名称长江支流——长江流域范围——矢量边界支流名称长江支流——长江流域范围——矢量边界支流名称长江支流——长江流域范围...
长江口综合整治工程前后潮汐特征分析 (2009年)
04-28
### 长江口综合整治工程前后潮汐特征分析 #### 概述 本文旨在通过分析长江口综合整治工程实施前后的潮汐变化，探究该工程对长江口潮汐特征的具体影响。通过对位于长江口北槽附近的横沙站和北槽中站进行调和分析，...
unity-HttpWebRequest
01-11
unity-HttpWebRequest下载,支持断点续传，支持后台下载。亲测可用，如有问题可联系我，不喜忽喷。
Unity UnityWebRequest文件下载
07-09
UnityWebRequest 简单资源下载 支持断点续传,下载进度,下载速度(每秒) 使用方法:开启一个协程,调用DownLoadFile即可, 需要传入3个Action,分别时下载进度,下载文件与当前文件总大小进度,和下载速度
Unity 中通过UnityWebRequest 以GET形式传authorization 的参数请求数据。
06-20
Unity 中通过UnityWebRequest 以GET形式传authorization 的参数请求数据。 注意： 以Header头文件的形式发送请求，authorization要放入请求头部。 以头文件形式发起请求进行Token验证，token为Authorization中的授权验证码。
用Matlab实现模拟长江水质变化情况
04-17
在本文中，我们将深入探讨如何使用强大的数学计算软件MATLAB来模拟长江水质的变化情况。MATLAB，全称为“矩阵实验室”，是一种广泛应用于数值分析、算法开发、数据可视化、建模和仿真等多种领域的高级编程环境。在...
【Unity】UnityWebRequest学习——Unity中的HTTP网络通信
Sig的博客
12-07 1万+
Unity中的HTTP网络通信
Unity使用UnityWebRequest请求服务器json数据，webgl端服务器请求
github_38633141的博客
03-15 1万+
根据unity官方说的， WebGL网络无法直接访问套接字 由于存在安全隐患，JavaScript 代码无法直接访问 IP 套接字来实现网络连接。因此，.NET 网络类（即System.Net命名空间中的所有内容，具体而言就是System.Net.Sockets）在 WebGL 中不起作用。Unity 旧有的UnityEngine.Network*类也是如此，以 WebGL 为构建目标时无法使用这些类。 如果需要在 WebGL 中使用网络，当前可选择的做法是使用 Unity 中的WWW...
UnityWebRequest 详解
最新发布
明明明的博客
06-11 845
UnityWebRequest 详解
Unity 使用UnityWebRequest进行Get/Post请求
w091253的博客
05-23 1876
Unity 使用UnityWebRequest进行Get/Post请求
评论 13
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

林新发

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值