UnityWebRequest 对象用于与 Web 服务器进行通信。
UnityWebRequest 处理 HTTP 与 Web 服务器进行通信的流程。其他对象 - 特别是 DownloadHandler 和 UploadHandler - 分别管理数据的下载和上传。
为方便起见,系统提供一组静态函数;这些函数可返回针对许多常见用例相应配置的 UnityWebRequest 对象。请参阅:Get、Post、Put、GetTexture。
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。 |
Put | Create a UnityWebRequest configured to upload raw data to a remote server via HTTP PUT. |
SerializeFormSections | 将 IMultipartFormSection 对象列表转换为包含原始多部分表单数据的字节数组。 |
SerializeSimpleForm | 将字符串字典序列化为包含经过 URL 编码的 UTF8 字符的字节数组。 |
UnEscapeURL | 将支持 URL 的转义序列转换回正常文本。 |