Version: 2018.3 (switch to 2019.1 )
Common operations: using the HLAPI
Retrieving a Texture from an HTTP Server (GET)
Other Versions

Retrieving text or binary data from an HTTP Server (GET)

Note: UNet is deprecated, and will be removed from Unity in the future. A new system is under development. For more information and next steps see this blog post and the FAQ.

To retrieve simple data such as textual data or binary data from a standard HTTP or HTTPS web server, use the UnityWebRequest.GET call. This function takes a single string as an argument, with the string specifying the URL from which data is retrieved.

This function is analogous to the standard WWW constructor:

WWW myWww = new WWW("http://www.myserver.com/foo.txt");
// ... is analogous to ...
UnityWebRequest myWr = UnityWebRequest.Get("http://www.myserver.com/foo.txt");

Details

  • This function creates a UnityWebRequest and sets the target URL to the string argument. It sets no other custom flags or headers.
  • By default, this function attaches a standard DownloadHandlerBuffer to the UnityWebRequest. This handler buffers the data received from the server and make it available to your scriptsA piece of code that allows you to create your own Components, trigger game events, modify Component properties over time and respond to user input in any way you like. More info
    See in Glossary
    when the request is complete.
  • By default, this function attaches no UploadHandler to the UnityWebRequest. You can attach one manually if you wish.

Example

using UnityEngine;
using System.Collections;
using UnityEngine.Networking;
 
public class MyBehaviour : MonoBehaviour {
    void Start() {
        StartCoroutine(GetText());
    }
 
    IEnumerator GetText() {
        UnityWebRequest www = UnityWebRequest.Get("http://www.my-server.com");
        yield return www.SendWebRequest();
 
        if(www.isNetworkError || www.isHttpError) {
            Debug.Log(www.error);
        }
        else {
            // Show results as text
            Debug.Log(www.downloadHandler.text);
 
            // Or retrieve results as binary data
            byte[] results = www.downloadHandler.data;
        }
    }
}

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

Common operations: using the HLAPI
Retrieving a Texture from an HTTP Server (GET)