Version: 5.6 (switch to 2017.1b)
LanguageEnglish
  • C#
  • JS

Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

WWW Constructor

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

public WWW(url: string)
public WWW(string url);

Parameters

url The url to download. Must be '%' escaped.

Returns

void A new WWW object. When it has been downloaded, the results can be fetched from the returned object.

Description

Creates a WWW request with the given URL.

This function creates and sends a GET request. The stream will automatically start downloading the response.

After the stream is created you have to wait for it to complete, then you can access the downloaded data. As a convenience the stream can be yielded, so you can very easily tell Unity to wait for the download to complete.

Note: URL must be '%' escaped.

#pragma strict
// Get the latest webcam shot from outside "Friday's" in Times Square
public var url: String = "http://images.earthcam.com/ec_metros/ourcams/fridays.jpg";
function Start() {
	// Start a download of the given URL
	var www: WWW = new WWW(url);
	www// assign texture
	var renderer: Renderer = GetComponent.<Renderer>();
	renderer.material.mainTexture = www.texture;
}
using UnityEngine;
using System.Collections;

// Get the latest webcam shot from outside "Friday's" in Times Square public class ExampleClass : MonoBehaviour { public string url = "http://images.earthcam.com/ec_metros/ourcams/fridays.jpg";

IEnumerator Start() { // Start a download of the given URL WWW www = new WWW(url);

// Wait for download to complete yield return www;

// assign texture Renderer renderer = GetComponent<Renderer>(); renderer.material.mainTexture = www.texture; } }

public WWW(url: string, form: WWWForm)
public WWW(string url, WWWForm form);

Parameters

url The url to download. Must be '%' escaped.
form A WWWForm instance containing the form data to post.

Returns

void A new WWW object. When it has been downloaded, the results can be fetched from the returned object.

Description

Creates a WWW request with the given URL.

This function creates and sends a POST request with form data contained in a WWWForm parameter. This is the same as calling new WWW(url,form.data, form.headers). The stream will automatically start downloading the response.

After the stream is created you have to wait for it to complete, then you can access the downloaded data. As a convenience the stream can be yielded, so you can very easily tell Unity to wait for the download to complete.

Note: URL must be '%' escaped.


public WWW(url: string, postData: byte[])
public WWW(string url, byte[] postData);

Parameters

url The url to download. Must be '%' escaped.
postData A byte array of data to be posted to the url.

Returns

void A new WWW object. When it has been downloaded, the results can be fetched from the returned object.

Description

Creates a WWW request with the given URL.

This function creates and sends a POST request with raw post data contained in postData. The stream will automatically start downloading the response. Use this version if you need to post raw post data in a custom format to the server.

After the stream is created you have to wait for it to complete, then you can access the downloaded data. As a convenience the stream can be yielded, so you can very easily tell Unity to wait for the download to complete.

Note: URL must be '%' escaped.


Obsolete public WWW(url: string, postData: byte[], headers: Hashtable)
Obsolete public WWW(string url, byte[] postData, Hashtable headers);

Parameters

url The url to download. Must be '%' escaped.
postData A byte array of data to be posted to the url.
headers A hash table of custom headers to send with the request.

Returns

void A new WWW object. When it has been downloaded, the results can be fetched from the returned object.

Description

Creates a WWW request with the given URL.

This function creates and sends a POST request with raw post data contained in postData and custom request headers supplied in the headers hashtable. The stream will automatically start downloading the response. Use this version if you need to post raw post data in a custom format to the server or if you need to supply custom request headers.

After the stream is created you have to wait for it to complete, then you can access the downloaded data. As a convenience the stream can be yielded, so you can very easily tell Unity to wait for the download to complete.

Note: URL must be '%' escaped.


public WWW(url: string, postData: byte[], headers: Dictionary<string,string>)
public WWW(string url, byte[] postData, Dictionary<string,string> headers);

Parameters

url The url to download. Must be '%' escaped.
postData A byte array of data to be posted to the url.
headers A dictionary that contains the header keys and values to pass to the server.

Returns

void A new WWW object. When it has been downloaded, the results can be fetched from the returned object.

Description

Creates a WWW request with the given URL.

This function creates and sends a POST request with raw post data contained in postData and custom request headers supplied in the headers Dictionary. The stream will automatically start downloading the response. Use this version if you need to post raw post data in a custom format to the server or if you need to supply custom request headers.

After the stream is created you have to wait for it to complete, then you can access the downloaded data. As a convenience the stream can be yielded, so you can very easily tell Unity to wait for the download to complete.

Note: URL must be '%' escaped.