Unity HTTP 통신(UnityWebRequest, Get/Post, IMultipartFormSection)

* HTTP: 웹상에서 클라이언트와 서버 간에 request/response 로 데이터를 주고 받을 수 있는 프로토콜.

 

HTTP 메소드 중 많이 쓰는 2가지. GET, POST.

 

1) GET: 서버로부터 정보를 조회하기 위해 설계된 메소드.

             데이터를 요청할 때 필요한 데이터를 Body 에 담지 않고 쿼리 스트링을 통해 전송한다.

             URL의 끝에 ?와 함께 이름과 값으로 쌍을 이루는 요청 파라미터를 쿼리스트링이라고 부른다.

             요청 파라미터가 여러개 이면 &로 연결해서 전송한다.

 

ex) 쿼리 스트링을 포함한 URL 샘플

www.example-url.com/resources?name1=value1&name2=value2

 

2) POST: 리소스를 생성/변경하기 위해 설계된 메소드.

                전송해야할 데이터를 HTTP 메세지의 Body에 담아서 전송한다.

                Body 의 길이에 제한없이 대용량의 데이터를 전송할 수 있다.

                Request Header 의 Content-Type 에 요청 데이터 타입을 표시해야 한다.

 

☞ 주소에 정보가 있으면 GET 방식이고, 없으면 POST 방식이라 생각하면 쉽다.

---

Unity에서 HTTP 통신을 할 때는 UnityWebRequest 를 사용한다.

UnityWebRequest 에서 Get 메소드와 Post 메소드를 간단하게 제공한다.

이 때, Json 형식의 데이터로 통신한다면 JsonConvert.SerializeObject(객체) or JsonConvert.DeserializeObject<객체형> 과정으로 변환작업이 필요하다.

 

1) UnityWebReqeust.Get

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;
        }
    }
}

UnityWebRequest.Get 으로 url에 정보를 요청한 모습이다.

받아온 결과값을 코드 버퍼에 저장하고 사용하기 위해 downloadHandler 를 사용한다.

 

2) UnityWebRequest.Post

using UnityEngine;
using UnityEngine.Networking;
using System.Collections;
using System.Collections.Generic;

public class MyBehavior : MonoBehaviour {
    void Start() {
        StartCoroutine(Upload());
    }

    IEnumerator Upload() {
        List<IMultipartFormSection> formData = new List<IMultipartFormSection>();
        formData.Add(new MultipartFormDataSection("field1=foo&field2=bar"));
        formData.Add(new MultipartFormFileSection("my file data", "myfile.txt"));

        UnityWebRequest www = UnityWebRequest.Post("https://www.my-server.com/myform", formData);
        yield return www.SendWebRequest();

        if (www.result != UnityWebRequest.Result.Success) {
            Debug.Log(www.error);
        }
        else {
            Debug.Log("Form upload complete!");
        }
    }
}

UnityWebRequest.Post 방식으로 데이터를 전달할 수 있다.

데이터는 List<IMultipartFormSection> 를 생성하여 Post 메소드 인자로 보낸다.

이 때, 파일 데이터를 보낼 때는 MultipartFormFileSection, 파일이 아닌 일반 데이터를 보낼 때는 MultipartFormDataSection 인터페이스를 사용한다.

---

* 참고

UnityWebRequest - Unity 매뉴얼

 

HTTP 서버에서 텍스트 또는 바이너리 데이터 가져오기(GET) - Unity 매뉴얼

HTTP 서버로 양식 보내기(POST) - Unity 매뉴얼

 

Unity - Scripting API: IMultipartFormSection