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

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

Important: UNet is a deprecated solution, and a new Multiplayer and NetworkingThe Unity system that enables multiplayer gaming across a computer network. More info
See in Glossary
Solution (Netcode for GameObjects) is under development. For more information and next steps see the information on the Unity Netcode for GameObjects website.

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("https://www.myserver.com/foo.txt");
// ... is analogous to ...
UnityWebRequest myWr = UnityWebRequest.Get("https://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("https://www.my-server.com");
        yield return www.SendWebRequest();
 
        if (www.result != UnityWebRequest.Result.Success) {
            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;
        }
    }
}
Common operations: using the HLAPI
Retrieving a Texture from an HTTP Server (GET)