Provides methods to communicate with web servers.
UnityWebRequest handles the flow of HTTP communication with web servers. To download and upload data, use DownloadHandler and UploadHandler respectively.
UnityWebRequest includes static utility functions that return UnityWebRequest instances configured for common use cases. For example:
UnityWebRequest.Get
UnityWebRequest.Post
UnityWebRequest.Put
To send a web request from a UnityWebRequest instance, call UnityWebRequest.SendWebRequest. After the UnityWebRequest begins to communicate with a remote server, you can't change any of the properties in that UnityWebRequest instance.
HTTPS is supported, server certificate is validated against the root certificate store available on the system the app runs on. Validation can be disabled (for example for development server using self-signed certificate) or changed to a custom handling by assigning UnityWebRequest.certificateHandler property.
Depending on the platform your application runs on, UnityWebRequest either sets the User-Agent header itself or leaves it for the operating system to set. UnityWebRequest sets the User-Agent header for all platforms except iOS, Xbox platforms, and WebGL.
Note: From Unity 2019.2, UnityWebRequest sets the User-Agent header for Android devices. In earlier releases, the operating system set the User-Agent header.
Note: If the device that the application runs on uses proxy settings, UnityWebRequest applies the proxy settings after the application sends the request.
| kHttpVerbCREATE | "CREATE" 文字列。通常 HTTP CREATE リクエストの Verb として使用します。 |
| kHttpVerbDELETE | "DELETE" 文字列。通常、HTTP DELETE リクエストの Verb として使用します。 |
| kHttpVerbGET | "GET" 文字列。通常 HTTP GET リクエストの Verb として使用します。 |
| kHttpVerbHEAD | "HEAD" 文字列。通常 HTTP HEAD リクエストの Verb として使用します。 |
| kHttpVerbPOST | "POST" 文字列。通常 HTTP POST リクエストの Verb として使用します。 |
| kHttpVerbPUT | "PUT" 文字列。通常、HTTP PUT リクエストの Verb として使用します。 |
| certificateHandler | Holds a reference to a CertificateHandler object, which manages certificate validation for this UnityWebRequest. |
| disposeCertificateHandlerOnDispose | If true, any CertificateHandler attached to this UnityWebRequest will have CertificateHandler.Dispose called automatically when UnityWebRequest.Dispose is called. |
| disposeDownloadHandlerOnDispose | True の場合、この UnityWebRequest にアタッチされているいずれかの DownloadHandler は、UnityWebRequest.Dispose が呼び出されるとき、自動的に DownloadHandler.Dispose を呼び出します。 |
| disposeUploadHandlerOnDispose | True の場合、UnityWebRequest.Dispose が呼び出されたとき、この UnityWebRequest にアタッチされているいずれの UploadHandler は自動的に UploadHandler.Dispose を呼び出します。 |
| downloadedBytes | システムがリモートサーバーからダウンロードしたボディデータのバイト数を返します。 |
| downloadHandler | この UnityWebRequest でリモートサーバーから受信したデータを管理する DownloadHandler オブジェクトへの参照を保持します。 |
| downloadProgress | ボディデータをサーバーからダウンロードの進行状況を示す 0.0 と 1.0 の間の浮動小数点値を返します。 |
| error | HTTP リクエストまたはレスポンスを処理中に [UnityWebRequest]] オブジェクトによって発生したシステム エラーを説明する人間が判読できる文字列です。 |
| isDone | [UnityWebRequest]] はリモートサーバーとの通信が終了した後、true を返します。 |
| isModifiable | UnityWebRequest の設定のプロパティーを変更することができる間、true が返されます。 |
| method | GET や POST など、この UnityWebRequest によって使用される HTTP Verb を定義します。 |
| redirectLimit | Indicates the number of redirects that this UnityWebRequest follows before halting with a Redirect Limit Exceeded system error. |
| responseCode | 200 、404 、500 などサーバーによって返される数値の HTTP レスポンスコード。 |
| result | The result of this UnityWebRequest. |
| timeout | Sets UnityWebRequest to attempt to abort after the number of seconds in timeout have passed. |
| uploadedBytes | システムがリモートサーバーにアップロードしたボディデータのバイト数を返します。 |
| uploadHandler | リモートサーバーにアップロードするデータを管理する UploadHandler オブジェクトへの参照を保持します。 |
| uploadProgress | ボディデータをサーバーにアップロードする進行状況を示す 0.0 と 1.0 の間の浮動小数点値を返します。 |
| uri | Defines the target URI for the UnityWebRequest to communicate with. |
| url | [UnityWebRequest]] と通信するターゲット URL を定義します。 |
| useHttpContinue | UnityWebRequest が送信リクエストヘッダーに Expect: 100-Continue を含めるかどうかを決定します(デフォルト: true )。 |
| UnityWebRequest | デフォルトのオプションと UnityWebRequest を作成し、DownloadHandler または UploadHandler をアタッチしません。デフォルトのメソッドは GET です。 |
| Abort | 進行中の場合、UnityWebRequest をできるだけ早く停止させます。 |
| Dispose | Signals that this UnityWebRequest is no longer being used, and should clean up any resources it is using. |
| GetRequestHeader | カスタムリクエストヘッダの値を取得します。 |
| GetResponseHeader | 最新の HTTP レスポンスの受信からレスポンスヘッダーの値を取得します。 |
| GetResponseHeaders | 最新の HTTP レスポンスの UnityWebRequest によって受信されたすべてのレスポンスヘッダーを含むディクショナリを取得します。 |
| SendWebRequest | リモートサーバーとの通信を開始します。 |
| SetRequestHeader | HTTP リクエストヘッダーをカスタムの値にセットします。 |
| ClearCookieCache | Clears stored cookies from the cache. |
| Delete | HTTP DELETE のために設定した UnityWebRequest を作成します。 |
| EscapeURL | 文字列の文字をエスケープし、URL に親和性があることを保証します。 |
| GenerateBoundary | マルチパートフォームバウンダリーとして使うためのランダムな 40 バイトの配列を生成します。 |
| Get | Create a UnityWebRequest for HTTP GET. |
| Head | HTTP HEAD リクエストを送信するように設定された UnityWebRequest を作成します。 |
| Post | Creates a UnityWebRequest configured to send form data to a server via HTTP POST. |
| PostWwwForm | Creates a UnityWebRequest configured to send form data to a server via HTTP POST. |
| Put | Creates a UnityWebRequest configured to upload raw data to a remote server via HTTP PUT. |
| SerializeFormSections | IMultipartFormSection オブジェクトのリストを RAW マルチパートフォームデータを含むバイト配列に変換します。 |
| SerializeSimpleForm | URL エンコードされた UTF-8 のキャラクタを含むバイト配列にストリングのディクショナリをシリアライズします。 |
| UnEscapeURL | エスケープシーケンス（特殊文字）を変換し、ユーザーが使いやすいテキストを返します。 |