The UnityWebRequest object is used to communicate with web servers.
UnityWebRequests handle the flow of HTTP communication with web servers. Other objects - specifically DownloadHandler and UploadHandler - govern downloading and uploading data, respectively.
A set of static functions are provided for convenience; these return UnityWebRequest objects properly configured for many common use cases. See: 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 SendWebRequest method.
Note: Proxy settings should be configured on Operating System level. UnityWebRequest picks these up later.
| kHttpVerbCREATE | The string "CREATE", commonly used as the verb for an HTTP CREATE request. |
| kHttpVerbDELETE | The string "DELETE", commonly used as the verb for an HTTP DELETE request. |
| kHttpVerbGET | The string "GET", commonly used as the verb for an HTTP GET request. |
| kHttpVerbHEAD | The string "HEAD", commonly used as the verb for an HTTP HEAD request. |
| kHttpVerbPOST | The string "POST", commonly used as the verb for an HTTP POST request. |
| kHttpVerbPUT | The string "PUT", commonly used as the verb for an HTTP PUT request. |
| 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 | If true, any DownloadHandler attached to this UnityWebRequest will have DownloadHandler.Dispose called automatically when UnityWebRequest.Dispose is called. |
| disposeUploadHandlerOnDispose | If true, any UploadHandler attached to this UnityWebRequest will have UploadHandler.Dispose called automatically when UnityWebRequest.Dispose is called. |
| downloadedBytes | Returns the number of bytes of body data the system has downloaded from the remote server. (Read Only) |
| downloadHandler | Holds a reference to a DownloadHandler object, which manages body data received from the remote server by this UnityWebRequest. |
| downloadProgress | Returns a floating-point value between 0.0 and 1.0, indicating the progress of downloading body data from the server. (Read Only) |
| error | A human-readable string describing any system errors encountered by this UnityWebRequest object while handling HTTP requests or responses. (Read Only) |
| isDone | Returns true after the UnityWebRequest has finished communicating with the remote server. (Read Only) |
| isModifiable | Returns true while a UnityWebRequest’s configuration properties can be altered. (Read Only) |
| method | Defines the HTTP verb used by this UnityWebRequest, such as GET or POST. |
| redirectLimit | Indicates the number of redirects which this UnityWebRequest will follow before halting with a “Redirect Limit Exceeded” system error. |
| responseCode | The numeric HTTP response code returned by the server, such as 200, 404 or 500. (Read Only) |
| result | The result of this UnityWebRequest. |
| timeout | Sets UnityWebRequest to attempt to abort after the number of seconds in timeout have passed. |
| uploadedBytes | Returns the number of bytes of body data the system has uploaded to the remote server. (Read Only) |
| uploadHandler | Holds a reference to the UploadHandler object which manages body data to be uploaded to the remote server. |
| uploadProgress | Returns a floating-point value between 0.0 and 1.0, indicating the progress of uploading body data to the server. |
| uri | Defines the target URI for the UnityWebRequest to communicate with. |
| url | Defines the target URL for the UnityWebRequest to communicate with. |
| useHttpContinue | Determines whether this UnityWebRequest will include Expect: 100-Continue in its outgoing request headers. (Default: true). |
| UnityWebRequest | Creates a UnityWebRequest with the default options and no attached DownloadHandler or UploadHandler. Default method is GET. |
| Abort | If in progress, halts the UnityWebRequest as soon as possible. |
| Dispose | Signals that this UnityWebRequest is no longer being used, and should clean up any resources it is using. |
| GetRequestHeader | Retrieves the value of a custom request header. |
| GetResponseHeader | Retrieves the value of a response header from the latest HTTP response received. |
| GetResponseHeaders | Retrieves a dictionary containing all the response headers received by this UnityWebRequest in the latest HTTP response. |
| SendWebRequest | Begin communicating with the remote server. |
| SetRequestHeader | Set a HTTP request header to a custom value. |
| ClearCookieCache | Clears stored cookies from the cache. |
| Delete | Creates a UnityWebRequest configured for HTTP DELETE. |
| EscapeURL | Escapes characters in a string to ensure they are URL-friendly. |
| GenerateBoundary | Generate a random 40-byte array for use as a multipart form boundary. |
| Get | Create a UnityWebRequest for HTTP GET. |
| Head | Creates a UnityWebRequest configured to send a HTTP HEAD request. |
| Post | 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 | Converts a List of IMultipartFormSection objects into a byte array containing raw multipart form data. |
| SerializeSimpleForm | Serialize a dictionary of strings into a byte array containing URL-encoded UTF8 characters. |
| UnEscapeURL | Converts URL-friendly escape sequences back to normal text. |