————————————————
版权声明:本文为CSDN博主「mafanwei」的原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接及本声明。
原文链接:https://blog.csdn.net/qwe25878/article/details/85051911
今天,来学习一下Unity新的网络请求方式UnityWebRequest
还是老规矩,先看描述。
目录
描述
开始使用
构造方法
其他实例化方法
简单例子
脚本解析
其他常用方法
其他常用属性
描述
UnityWebRequest对象用于与Web服务器通信。
UnityWebRequests处理与Web服务器的HTTP通信流。 其他对象 - 特别是DownloadHandler和UploadHandler - 分别管理下载和上传数据。
注意:一旦UnityWebRequest开始通过调用Send方法与远程服务器通信,UnityWebRequest对象上的大多数属性都无法更改。(Send方法已经过时,用本文下面的例子的方法)
开始使用
通过阅读UnityWebRequest的官方API发现,功能还是挺多的,我们就挑一些常用的说吧。
构造方法
public UnityWebRequest();
public UnityWebRequest(string url);
public UnityWebRequest(Uri uri);
public UnityWebRequest(string url, string method);
public UnityWebRequest(Uri uri, string method);
public UnityWebRequest(string url, string method, Networking.DownloadHandler downloadHandler, Networking.UploadHandler uploadHandler);
public UnityWebRequest(Uri uri, string method, Networking.DownloadHandler downloadHandler, Networking.UploadHandler uploadHandler);
这些构造方法都很普通很常见,这里就不过多说了,其实如果不是有特殊需求,我个人不怎么建议使用这些方法来构造UnityWebRequest对象。
其他实例化方法
其实UnityWebRequest为我们封装了一些常用的公用静态方法,我们完全可以通过这些公用的静态方法来构建一个UnityWebRequest。
常用的有:
Delete
Get
Head
Post
Put
阅读文档可发现,这些封装的方法都会返回一个Networking.UnityWebRequest对象。
这样,我们就可以通过这些方法来构造我们的UnityWebRequest对象了。
简单例子
我写了一个脚本,其中包含了简单的get和post请求,可能会更直观。
using System.Collections;
using UnityEngine;
using UnityEngine.Networking;
public class Network : MonoBehaviour {
void Start ()
{
StartCoroutine(Get());
StartCoroutine(Post());
}
IEnumerator Get()
{
UnityWebRequest webRequest = UnityWebRequest.Get("http://www.baidu.com");
yield return webRequest.SendWebRequest();
//异常处理,很多博文用了error!=null这是错误的,请看下文其他属性部分
if (webRequest.isHttpError||webRequest.isNetworkError)
Debug.Log(webRequest.error);
else
{
Debug.Log(webRequest.downloadHandler.text);
}
}
IEnumerator Post()
{
WWWForm form = new WWWForm();
//键值对
form.AddField("key", "value");
form.AddField("name","mafanwei");
form.AddField("blog","qwe25878");
UnityWebRequest webRequest = UnityWebRequest.Post("http://www.baidu.com",form);
yield return webRequest.SendWebRequest();
//异常处理,很多博文用了error!=null这是错误的,请看下文其他属性部分
if (webRequest.isHttpError||webRequest.isNetworkError)
Debug.Log(webRequest.error);
else
{
Debug.Log(webRequest.downloadHandler.text);
}
}
}
脚本解析
其实上面的简单脚本已经满足了大多数情况下我们的使用需求,下面就来讲一下上面的脚本原理。
这里使用了Unity的协程IEnumerator。
协程是什么?
协程是一个能暂停执行,暂停后立即返回,直到中断指令完成后继续执行的函数。
通过yield return,我们就能让他暂停在这里,然后直到有了返回在继续进行下面的代码。
webRequest.SendWebRequest()这个方法就是开始与远程服务器通信。也就是调用这个方法了
UnityWebRequest将执行DNS解析(如有必要),将HTTP请求传输到目标URL处的远程服务器并处理服务器的响应。它返回的是WebRequestAsyncOperation对象,在协程内部产生WebRequestAsyncOperation将导致协程暂停,直到UnityWebRequest遇到系统错误或完成通信。
通过这个,我们就实现了当UnityWebRequest有联网完成后才运行下面的处理代码。
注意:
1.调用此方法后,我们将无法更改任何UnityWebRequest的属性。
2.此方法只能在任何给定的UnityWebRequest对象上调用一次。
其他常用方法
public void Abort();
它会尽快结束联网过程,可以随时调用此方法。 如果UnityWebRequest尚未完成,UnityWebRequest将尽快停止上传或下载数据。 中止的UnityWebRequests被认为遇到了系统错误。 isNetworkError或isHttpError属性将返回true,error属性将为“User Aborted”。
如果在调用Send之前调用此方法,则UnityWebRequest将在调用Send后立即中止。
在此UnityWebRequest遇到其他错误或已成功完成与远程服务器的通信后,对此方法的调用无效。
public static string EscapeURL(string s);
public static string EscapeURL(string s, Encoding e);
1
2
转义字符串中的字符以确保它们对URL友好。
某些文本字符在URL中存在时具有特殊含义。 如果需要在URL参数中包含这些字符,则必须使用转义序列表示它们。 建议您在将文本作为URL参数传递之前,对用户提供的任何文本使用此函数。 这将确保恶意用户无法操纵URL的内容来攻击Web服务器。 我们也可以使用UnityWebRequest.UnEscapeURL来将URL转译回来。
例子:(在http中&号是链接两个变量的具有特殊意义的字符)
using UnityEngine;
using UnityEngine.Networking;
public class ExampleClass : MonoBehaviour
{
void Start()
{
string escName = UnityWebRequest.EscapeURL(“Fish & Chips”);
}
}
public void Dispose();
1
表示不再使用此UnityWebRequest,并应清理它正在使用的任何资源。
无论请求成功还是失败,我们必须在完成使用UnityWebRequest对象后调用Dispose。
注意:但是这不代表我们需要每次都调用这个方法。因为Unity给我们提供了disposeDownloadHandlerOnDispose和disposeUploadHandlerOnDispose两个bool类型属性。他们的默认值是true,也就是我们不需要设置Unity就会自动在完成后调用Dispose()释放资源。
其他常用属性
public int timeout;
将UnityWebRequest设置为在超时秒数过后尝试中止。
发生超时时,错误返回“请求超时”。 当timeout设置为0时,不会应用超时。此属性默认为0。
注意:设置超时可能适用于Android上的每个网址重定向,这可能会导致更长的响应。
isHttpError
在此UnityWebRequest收到指示错误的HTTP响应代码后返回true。 (只读)
如果响应代码大于或等于400,则为True。
isNetworkError
在UnityWebRequest遇到系统错误后返回true。 (只读)
系统错误的示例包括无法解析DNS条目,套接字错误或超出重定向限制。 当此属性返回true时,error属性将包含描述错误的可读字符串。
注意:错误类型的服务器返回代码(例如404 / Not Found和500 / Internal Server Error)反映在isHttpError属性中,而不是isNetworkError属性中。
public float downloadProgress;
返回介于0.0和1.0之间的浮点值,指示从服务器下载正文数据的进度。 (只读)
注意:仅当服务器的响应包含Content-Length标头并且UnityWebRequest具有附加到downloadHandler属性的DownloadHandler时,此属性才有效。
如果UnityWebRequest已完成(成功或系统错误),则此属性将始终返回1.如果UnityWebRequest仍在与远程服务器通信,并且downloadHandler为null,则此属性将返回0.5。 如果尚未调用Send,则此属性将返回-1。
public float uploadProgress;
返回介于0.0和1.0之间的浮点值,指示将数据上载到服务器的进度。
如果UnityWebRequest完成(成功或系统错误),则此属性将始终返回1.如果UnityWebRequest仍在与远程服务器通信,并且uploadHandler为null,则此属性将返回零。 如果尚未调用Send,则此属性将返回-1。
public string error;
一个可读的字符串,描述此UnityWebRequest对象在处理HTTP请求或响应时遇到的任何系统错误。 (只读)
如果UnityWebRequest未遇到系统错误,则此属性将返回null。 系统错误的示例包括套接字错误,解析DNS条目的错误或超出的重定向限制。
注意:来自服务器的错误类型返回码(例如404 / File Not Found或500 / Internal Server Error)不被视为系统错误。
默认值:null。
public bool isDone;
UnityWebRequest完成与远程服务器通信后返回true。 (只读)
当UnityWebRequest成功完成或遇到系统错误时,此属性将返回true。 DownloadHandler(如果有)的所有后期下载处理将在此属性返回true之前完成。
————————————————
版权声明:本文为CSDN博主「mafanwei」的原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接及本声明。
原文链接:https://blog.csdn.net/qwe25878/article/details/85051911