UnityWebRequest

UnityEngine.Networking 中的类

反馈

描述

提供与 Web 服务器通信的方法。

UnityWebRequest 处理与 Web 服务器的 HTTP 通信流程。要下载和上传数据，请分别使用 DownloadHandler 和 UploadHandler。

UnityWebRequest 包含用于返回针对常见用例配置的 UnityWebRequest 实例的静态实用程序函数。例如

要从 UnityWebRequest 实例发送 Web 请求，请调用 UnityWebRequest.SendWebRequest。在 UnityWebRequest 开始与远程服务器通信后，您无法更改该 UnityWebRequest 实例中的任何属性。支持 HTTPS，服务器证书将针对应用程序运行的系统上可用的根证书存储进行验证。验证可以被禁用（例如，对于使用自签名证书的开发服务器）或通过分配 UnityWebRequest.certificateHandler 属性更改为自定义处理。

根据您的应用程序运行的平台，UnityWebRequest 或者会自行设置 User-Agent 标头，或者将其留给操作系统设置。 UnityWebRequest 为除 iOS、Xbox 平台和 WebGL 之外的所有平台设置 User-Agent 标头。

注意：从 Unity 2019.2 开始，UnityWebRequest 会为 Android 设备设置 User-Agent 标头。在早期版本中，操作系统会设置 User-Agent 标头。

注意：如果应用程序运行的设备使用代理设置，则 UnityWebRequest 会在应用程序发送请求后应用代理设置。

静态属性

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

属性

certificateHandler	保存对 CertificateHandler 对象的引用，该对象管理此 UnityWebRequest 的证书验证。
disposeCertificateHandlerOnDispose	如果为 true，则附加到此 UnityWebRequest 的任何 CertificateHandler 都将在调用 UnityWebRequest.Dispose 时自动调用 CertificateHandler.Dispose。
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 请求或响应时遇到的任何系统错误。默认值为 null。（只读）
isDone	在 UnityWebRequest 完成与远程服务器的通信后返回 true。（只读）
isModifiable	当 UnityWebRequest 的配置属性可以更改时返回 true。（只读）
method	定义此 UnityWebRequest 使用的 HTTP 动词，例如 GET 或 POST。
redirectLimit	指示此 UnityWebRequest 在因“重定向限制超出”系统错误而停止之前所执行的重定向次数。
responseCode	服务器返回的数字 HTTP 响应代码，例如 200、404 或 500。（只读）
result	此 UnityWebRequest 的结果。
timeout	设置 UnityWebRequest 在超时秒数后尝试中止。
uploadedBytes	返回系统上传到远程服务器的主体数据字节数。（只读）
uploadHandler	保存对 UploadHandler 对象的引用，该对象管理要上传到远程服务器的主体数据。
uploadProgress	返回一个介于 0.0 和 1.0 之间的浮点值，指示向服务器上传主体数据的进度。
uri	定义 UnityWebRequest 要与其通信的目标 URI。
url	定义 UnityWebRequest 要与其通信的目标 URL。
useHttpContinue	确定此 UnityWebRequest 是否将在其传出的请求标头中包含 Expect: 100-Continue。（默认值：true）。

构造函数

UnityWebRequest

创建使用默认选项且没有附加 DownloadHandler 或 UploadHandler 的 UnityWebRequest。默认方法是 GET。

公共方法

Abort	如果正在进行，则尽快停止 UnityWebRequest。
Dispose	表示此 UnityWebRequest 不再使用，应清理其使用的任何资源。
GetRequestHeader	检索自定义请求标头的值。
GetResponseHeader	检索从收到的最新 HTTP 响应中接收到的响应标头的值。
GetResponseHeaders	检索一个字典，其中包含此 UnityWebRequest 在最新 HTTP 响应中收到的所有响应标头。
SendWebRequest	开始与远程服务器通信。
SetRequestHeader	将 HTTP 请求标头设置为自定义值。

静态方法

ClearCookieCache	从缓存中清除存储的 cookie。
Delete	创建为 HTTP DELETE 配置的 UnityWebRequest。
EscapeURL	转义字符串中的字符，以确保它们是 URL 友好的。
GenerateBoundary	生成一个随机的 40 字节数组，用作多部分表单边界。
Get	创建用于 HTTP GET 的 UnityWebRequest。
Head	创建配置为发送 HTTP HEAD 请求的 UnityWebRequest。
Post	创建配置为通过 HTTP POST 将表单数据发送到服务器的 UnityWebRequest。
PostWwwForm	创建配置为通过 HTTP POST 将表单数据发送到服务器的 UnityWebRequest。
Put	创建配置为通过 HTTP PUT 将原始数据上传到远程服务器的 UnityWebRequest。
SerializeFormSections	将 IMultipartFormSection 对象列表转换为包含原始多部分表单数据的字节数组。
SerializeSimpleForm	将字符串字典序列化为包含 URL 编码 UTF8 字符的字节数组。
UnEscapeURL	将 URL 友好的转义序列转换回普通文本。

Did you find this page useful? Please give it a rating:

Report a problem on this page

此处描述的内容是否按预期工作？这可能是 已知问题。请查看问题跟踪器： issuetracker.unity3d.com.

脚本 API

UnityWebRequest

成功！

提交失败

描述

静态属性

属性

构造函数

公共方法

静态方法