기술 자료

Unity Engine

User Manual

Script Reference

Unity Engine

Unity Web Request Retrieving Texture

Download and store a texture efficiently from a remote server using UnityWebRequestTexture.GetTexture.
읽는 시간 1분최근 업데이트: 한 달 전
원격 서버에서 텍스처 파일을 가져오려면 
UnityWebRequestTexture.GetTexture
를 사용하면 됩니다. 이 기능은 
UnityWebRequest.Get
과 매우 유사하지만 텍스처를 효율적으로 다운로드하고 저장하도록 최적화되어 있습니다.
UnityWebRequestTexture.GetTexture
는 문자열 또는 
Uri
오브젝트를 다운로드하고 텍스처로 사용할 이미지 파일의 URL을 지정하는 인자로 사용합니다. 또한 
DownloadedTextureParams
를 두 번째 인자로 사용하여 생성될 텍스처를 더 세밀하게 제어할 수 있습니다.

세부 정보

  • 이 함수는 
    UnityWebRequest
    를 생성하고 타겟 URL을 문자열 인자로 설정합니다. 이 함수는 다른 플래그나 커스텀 헤더를 설정하지 않습니다.
  • 이 함수는 
    DownloadHandlerTexture
    오브젝트를 
    UnityWebRequest
    에 연결합니다. DownloadHandlerTexture는 Unity 엔진에서 텍스처로 사용할 이미지를 저장하기 위해 최적화된 특수 다운로드 핸들러입니다. 이 클래스를 사용하면 원시 바이트를 다운로드하고 스크립트에서 수동으로 텍스처를 생성하는 것보다 메모리 재할당이 크게 줄어듭니다.
  • 기본적으로 이 함수는 업로드 핸들러를 연결하지 않습니다. 원하는 경우 수동으로 추가할 수 있습니다.

예제

using UnityEngine;using System.Collections;using UnityEngine.Networking; public class MyBehaviour : MonoBehaviour {    void Start() {        StartCoroutine(GetTexture());    }     IEnumerator GetTexture() {        UnityWebRequest www = UnityWebRequestTexture.GetTexture("https://www.my-server.com/image.png");        yield return www.SendWebRequest();        if (www.result != UnityWebRequest.Result.Success) {            Debug.Log(www.error);        }        else {            Texture myTexture = DownloadHandlerTexture.GetContent(www);        }    }}