Unity API(一) ------ UnityWebRequest类解析

• 官方API :https://docs.unity3d.com/ScriptReference/Networking.UnityWebRequest.html

最近项目要用到热更中的东西,欢喜~前面学的知识就派上用场啦,不过UnityWebRequest中的属性及方法还不熟悉,所以打算翻译一下官方的API

首先你要知道这个类是干嘛的,主要是从服务器或者本地加载AB包的,官方解释为:

UnityWebRequest对象用于与web服务器通信。
unitywebre任务处理与web服务器的HTTP通信流。其他对象——特别是下载处理程序和UploadHandler——分别管理下载和上传数据。
为方便起见，提供了一组静态函数;这些返回UnityWebRequest对象为许多常见用例正确配置。看： Get, Post, Put, GetTexture.
注意：当UnityWebRequest通过调用Send方法开始与远程服务器通信时，不能改变UnityWebRequest对象上的大多数属性。

1.静态变量:

kHttpVerbCREATE	字符串“CREATE”，通常用作HTTP CREATE request的动词。
kHttpVerbDELETE	字符串“DELETE”，通常用作HTTP DELETErequest的动词。
kHttpVerbGET	字符串“GET”，通常用作HTTP GETrequest的动词。
kHttpVerbHEAD	字符串“HEAD”，通常用作HTTP HEADrequest的动词。
kHttpVerbPOST	字符串“POST”，通常用作HTTP POSTrequest的动词。
kHttpVerbPUT	字符串“PUT”，通常用作HTTP PUTrequest的动词。

         没看懂是用来干嘛的,但是这里笔者没有用到,如果用到再补充

2.属性

certificateHandler	持有对证书处理程序对象的引用，该对象负责管理UnityWebRequest的证书验证。
chunkedTransfer	表示UnityWebRequest系统是否应该采用HTTP/1.1传输编码方法。
disposeCertificateHandlerOnDispose	如果为true，那么连接到UnityWebRequest的任何证书处理程序都将拥有证书处理程序。当UnityWebRequest时自动调用,处理。
disposeDownloadHandlerOnDispose	如果为true，那么任何连接到这个UnityWebRequest的下载处理程序都将拥有DownloadHandler。当UnityWebRequest时自动调用。处理。
disposeUploadHandlerOnDispose	如果为true，任何附加到这个UnityWebRequest的UploadHandler都将拥有UploadHandler。当UnityWebRequest时自动调用,处理。
downloadedBytes	返回系统从远程服务器下载的主体数据的字节数。(只读)
downloadHandler	持有一个DownloadHandler对象的引用，该对象管理由这个UnityWebRequest从远程服务器接收的主体数据。
downloadProgress	返回0.0到1.0之间的浮点值，指示从服务器下载数据的进度。(只读)
error	一种可读的字符串，描述了在处理HTTP请求或响应时，UnityWebRequest对象遇到的任何系统错误。(只读)
isDone	在UnityWebRequest完成与远程服务器的通信之后，返回true。(只读)
isHttpError	在这个UnityWebRequest收到一个表示错误的HTTP响应代码之后，返回true。(只读)
isModifiable	当UnityWebRequest的配置属性可以被改变时，返回true。(只读)
isNetworkError	在这个UnityWebRequest遇到系统错误后返回true。(只读)
method	定义这个UnityWebRequest使用的HTTP动词(就是上面的静态属性)，如GET或POST。
redirectLimit	在停止使用“重定向限制超过”系统错误之前，指示UnityWebRequest将遵循的重定向的数量。
responseCode	服务器返回的数字HTTP响应代码，如200404或500。(只读)
timeout	设置UnityWebRequest在超时数秒后尝试中止。
uploadedBytes	返回系统上载到远程服务器主体体数据字节数。(只读)
uploadHandler	持有对UploadHandler对象的引用，该对象管理将上传到远程服务器的主体数据。
uploadProgress	返回0.0到1.0之间的浮点值，指示将数据上传至服务器的进度。
uri	定义UnityWebRequest与之通信的目标URI。
url	定义UnityWebRequest与之通信的目标URL。
useHttpContinue	确定这个UnityWebRequest是否包括Expect:100-继续在其传出的请求头中。(默认值:true)。

     主要常用的几个属性为:

         downloadProgress/isDone/timeout/uri/uploadProgress

3.静态方法

Abort	如果有进展，就尽快停止UnityWebRequest。
Dispose	这是一种信号，表明这个UnityWebRequest不再被使用，并且应该清理它所使用的任何资源。
GetRequestHeader	检索定制请求头的值。
GetResponseHeader	从收到的最新HTTP响应中检索响应头的值。
GetResponseHeaders	在最新的HTTP响应中检索一个包含这个UnityWebRequest所接收到的所有响应头的字典。
SendWebRequest	开始与远程服务器通信。在调用此方法之后，UnityWebRequest将执行DNS解析（如果必要的话），将HTTP请求发送到目标URL的远程服务器并处理服务器的响应。这种方法只能在任何给定的UnityWebRequest对象中调用一次。一旦这个方法被调用，您就不能更改UnityWebRequest的任何属性。这个方法返回一个WebRequestAsyncOperation对象。在一个coroutine中产生WebRequestAsyncOperation会导致coroutine暂停，直到UnityWebRequest遇到系统错误或完成通信。
SetRequestHeader	设置一个HTTP请求头到一个定制值。

4.公共方法

Abort	如果有进展，就尽快停止UnityWebRequest。
Dispose	这是一种信号，表明这个UnityWebRequest不再被使用，并且应该清理它所使用的任何资源。
GetRequestHeader	检索定制请求头的值。
GetResponseHeader	从收到的最新HTTP响应中检索响应头的值。
GetResponseHeaders	在最新的HTTP响应中检索一个包含这个UnityWebRequest所接收到的所有响应头的字典。
SendWebRequest	开始与远程服务器通信。在调用此方法之后，UnityWebRequest将执行DNS解析（如果必要的话），将HTTP请求发送到目标URL的远程服务器并处理服务器的响应。这种方法只能在任何给定的UnityWebRequest对象中调用一次。一旦这个方法被调用，您就不能更改UnityWebRequest的任何属性。这个方法返回一个WebRequestAsyncOperation对象。在一个coroutine中产生WebRequestAsyncOperation会导致coroutine暂停，直到UnityWebRequest遇到系统错误或完成通信。
SetRequestHeader	设置一个HTTP请求头到一个定制值。

使用：

      https://blog.csdn.net/a8856621/article/details/79700346

 下载AB包：

 public IEnumerator LoadABRes()
    {
        request = UnityWebRequest.GetAssetBundle(uri);
        yield return request.SendWebRequest();
        AssetBundle ab = (request.downloadHandler as DownloadHandlerAssetBundle).assetBundle;
    }