Version: 2017.3

UnityWebRequest

class in UnityEngine.Networking

切换到手册

描述

UnityWebRequest 对象用于与 Web 服务器进行通信。

UnityWebRequest 处理 HTTP 与 Web 服务器进行通信的流程。其他对象 - 特别是 DownloadHandlerUploadHandler - 分别管理数据的下载和上传。

为方便起见,系统提供一组静态函数;这些函数可返回针对许多常见用例相应配置的 UnityWebRequest 对象。请参阅:GetPostPutGetTexture

Note: Most properties on the UnityWebRequest object cannot be altered once the UnityWebRequest has begun communicating with a remote server by calling the Send method.

静态变量

kHttpVerbCREATE字符串“CREATE”,通常用作 HTTP CREATE 请求的动词。
kHttpVerbDELETE字符串“DELETE”,通常用作 HTTP DELETE 请求的动词。
kHttpVerbGET字符串“GET”,通常用作 HTTP GET 请求的动词。
kHttpVerbHEAD字符串“HEAD”,通常用作 HTTP HEAD 请求的动词。
kHttpVerbPOST字符串“POST”,通常用作 HTTP POST 请求的动词。
kHttpVerbPUT字符串“PUT”,通常用作 HTTP PUT 请求的动词。

变量

chunkedTransfer指示 UnityWebRequest 系统是否应采用 HTTP/1.1 分块传输编码方法。
disposeDownloadHandlerOnDispose如果值为 true,则任何附加到此 UnityWebRequest 的 DownloadHandler 将在调用 UnityWebRequest.Dispose 时自动调用 DownloadHandler.Dispose。
disposeUploadHandlerOnDispose如果值为 true,则任何附加到此 UnityWebRequest 的 UploadHandler 将在调用 UnityWebRequest.Dispose 时自动调用 UploadHandler.Dispose。
downloadedBytes返回系统从远程服务器下载的主体数据的字节数。(只读)
downloadHandler拥有对 DownloadHandler 对象的引用,该对象可管理此 UnityWebRequest 从远程服务器接收的主体数据。
downloadProgress返回一个 0.0 和 1.0 之间的浮点值,用于表示从服务器下载主体数据的进度。(只读)
error一个可读字符串,用于描述此 UnityWebRequest 对象在处理 HTTP 请求或响应时遇到的任何系统错误。(只读)
isDone当 UnityWebRequest 结束与远程服务器的通信后,返回 true。(只读)
isHttpError当此 UnityWebRequest 接收到指示错误的 HTTP 响应代码后,返回 true。(只读)
isModifiable当 UnityWebRequest 的配置属性可更改时,返回 true。(只读)
isNetworkError当此 UnityWebRequest 遇到系统错误后,返回 true。(只读)
method定义此 UnityWebRequest 使用的 HTTP 动词,如 GET 或 POST。
redirectLimit表示在此 UnityWebRequest 将执行多少次重定向后,会发生“超出重定向限制”系统错误而停止。
responseCode服务器返回的数字 HTTP 响应代码,如 200、404 或 500。(只读)
timeout将 UnityWebRequest 设置为在经过 timeout 中的秒数后尝试中止。
uploadedBytes返回系统上传到远程服务器的主体数据的字节数。(只读)
uploadHandler拥有对 UploadHandler 对象的引用,该对象可管理要上传到远程服务器的主体数据。
uploadProgress返回一个 0.0 和 1.0 之间的浮点值,用于表示将主体数据上传到服务器的进度。(只读)
url定义 UnityWebRequest 要通信的目标 URL。
useHttpContinue确定此 UnityWebRequest 是否将在其传出请求的标头中包含 Expect: 100-Continue。(默认值:true)。

构造函数

UnityWebRequest使用默认选项创建 UnityWebRequest,且不附加 DownloadHandler 或 UploadHandler。默认方法为 GET。

公共函数

Abort如果 UnityWebRequest 在进行中,请尽快停止。
Dispose表示不再使用此 [UnityWebRequest],并应清理它使用的任何资源。
GetRequestHeader检索自定义请求标头的值。
GetResponseHeader从收到的最新 HTTP 响应中检索响应标头的值。
GetResponseHeaders检索包含着此 UnityWebRequest 在最新 HTTP 响应中收到的所有响应标头的字典。
SendWebRequest开始与远程服务器通信。调用此方法后,UnityWebRequest 将执行 DNS 解析(如有必要),将一个 HTTP 请求传输到位于目标 URL 的远程服务器,并处理该服务器的响应。只能在任意给定的 UnityWebRequest 对象上调用一次此方法。调用此方法后,您将无法更改 UnityWebRequest 的任何属性。此方法将返回一个 WebRequestAsyncOperation 对象。在协程内部生成 WebRequestAsyncOperation 将导致协程暂停,直到 UnityWebRequest 遇到系统错误或结束通信为止。
SetRequestHeader将 HTTP 请求标头设置为自定义值。

静态函数

Delete创建针对 HTTP DELETE 进行配置的 UnityWebRequest。
EscapeURL对字符串中的字符进行转义以确保其支持 URL。
GenerateBoundary生成一个随机的 40 字节数组来用作多部分表单边界。
Get创建针对 HTTP GET 进行配置的 UnityWebRequest。
GetAssetBundle创建经过优化的 UnityWebRequest,以通过 HTTP GET 下载 Unity 资源捆绑包。
Head创建一个经配置可发送 HTTP HEAD 请求的 UnityWebRequest。
Post创建一个经配置可通过 HTTP POST 向服务器发送表单数据的 UnityWebRequest。
PutCreate a UnityWebRequest configured to upload raw data to a remote server via HTTP PUT.
SerializeFormSections将 IMultipartFormSection 对象列表转换为包含原始多部分表单数据的字节数组。
SerializeSimpleForm将字符串字典序列化为包含经过 URL 编码的 UTF8 字符的字节数组。
UnEscapeURL将支持 URL 的转义序列转换回正常文本。