WWW Manual     Reference     Scripting  
Scripting > Runtime Classes > WWW
WWW Inherits from IDisposable

Simple access to web pages.

This is a small utility module for retrieving the contents of URLs.

You start a download in the background by calling WWW(url) which returns a new WWW object.

You can inspect the isDone property to see if the download has completed or yield the download object to automatically wait until it is (without blocking the rest of the game).

Use it if you want to get some data from a web server for integration with a game such as highscore lists or calling home for some reason. There is also functionality to create textures from images downloaded from the web and to stream & load new web player data files.

The WWW class can be used to send both GET and POST requests to the server. The WWW class will use GET by default and POST if you supply a postData parameter.

See Also: WWWForm for a way to build valid form data for the postData parameter.

Note: http://, https:// and file:// protocols are supported on iPhone. ftp:// protocol support is limited to anonymous downloads only. Other protocols are not supported.

Note: The security sandbox present in web-player builds prevents you from accessing content not hosted the server where the webplayer is hosted.

JavaScript
// Get the latest webcam shot from outside "Friday's" in Times Square
var url = "http://images.earthcam.com/ec_metros/ourcams/fridays.jpg";
function Start () {
// Start a download of the given URL
var www : WWW = new WWW (url);

// Wait for download to complete
yield www;

// assign texture
renderer.material.mainTexture = www.texture;
}

using UnityEngine;
using System.Collections;

public class example : MonoBehaviour {
public string url = "http://images.earthcam.com/ec_metros/ourcams/fridays.jpg";
IEnumerator Start() {
WWW www = new WWW(url);
yield return www;
renderer.material.mainTexture = www.texture;
}
}

import UnityEngine
import System.Collections

class example(MonoBehaviour):

public url as string = 'http://images.earthcam.com/ec_metros/ourcams/fridays.jpg'

def Start() as IEnumerator:
www as WWW = WWW(url)
yield www
renderer.material.mainTexture = www.texture

Variables
text

Returns the contents of the fetched web page as a string (Read Only).

bytes

Returns the contents of the fetched web page as a byte array (Read Only).

error

Returns an error message if there was an error during the download (Read Only).

texture

Returns a Texture2D generated from the downloaded data (Read Only).

textureNonReadable

Returns a non-readable Texture2D generated from the downloaded data (Read Only).

movie

Returns a MovieTexture generated from the downloaded data (Read Only).

isDone

Is the download already finished? (Read Only)

progress

How far has the download progressed (Read Only).

uploadProgress

How far has the upload progressed (Read Only).

url

The URL of this WWW request (Read Only).

assetBundle

Streams an AssetBundle that can contain any kind of asset from the project folder.

threadPriority

Priority of AssetBundle decompression thread.

Constructors
WWW

Creates a WWW request with the given URL.

Functions
GetAudioClip

Returns an AudioClip generated from the downloaded data (Read Only).

LoadImageIntoTexture

Replaces the contents of an existing Texture2D with an image from the downloaded data.

LoadUnityWeb

Loads the new web player data file.

Class Functions
EscapeURL

Encodes string into an URL-friendly format.

UnEscapeURL

Decodes string from an URL-friendly format.

LoadFromCacheOrDownload

Loads an AssetBundle with the specified version number from the cache. If the AssetBundle is not currently cached, it will automatically be downloaded and stored in the cache for future retrieval from local storage.