기술 자료

Unity 엔진

Unity 엔진

웹 요청 저수준 API 레퍼런스

로우레벨 웹 요청 API를 사용하여 고급 HTTP 작업을 수행합니다.
읽는 시간 3분최근 업데이트: 9일 전

고수준 웹 요청 API는 보일러플레이트 코드의 필요성을 최소화하지만 저수준 웹 요청 API는 더 많은 유연성과 제어 기능을 제공합니다.
이 섹션에는 저수준 API 주요 구성원과 해당 시나리오가 나와 있습니다. 일반적으로 저수준 API를 사용하려면 특정 다운로드 및 업로드 사례를 위한 특수한
DownloadHandler
또는
UploadHandler
객체를 첨부하는
UnityWebRequest
를 생성해야 합니다.
고수준 API와 저수준 API는 상호 배타적이지 않습니다. 일반 작업에 대한 더 많은 제어가 필요한 경우 고수준 API를 통해 생성된
UnityWebRequest
객체를 언제든지 사용자 지정할 수 있습니다.

UnityWebRequest 오브젝트 인스턴스화

UnityWebRequest
은 다른 모든 객체처럼 그 생성자를 통해 인스턴스화할 수 있습니다. 업로드 또는 다운로드 핸들러가 포함되어 있거나 없는 경우 여러 생성자 서명을 사용할 수 있습니다.
UnityWebRequest
또한 요청을 구성하고 상태를 추적하고 결과를 확인하는 프로퍼티도 포함합니다.
UnityWebRequest
자세한 내용은
UnityWebRequest
API 레퍼런스를 참조하십시오.

핸들러 다운로드

전문적인 다운로드 핸들러를 사용하면 특정 다운로드 사례를 처리하고 수신되는 데이터 처리를 제어할 수 있습니다. 다음 다운로드 핸들러를 사용할 수 있으며, 모두 기본
DownloadHandler
클래스를 특화합니다.

핸들러 유형

설명

DownloadHandlerBuffer
단순한 데이터 스토리지에 사용됩니다. 이 다운로드 핸들러는 가장 간단하며 대부분의 사용 사례를 처리합니다. 수신된 데이터를 네이티브 코드 버퍼에 저장합니다. 다운로드가 완료되면 버퍼링된 데이터에 바이트 배열 또는 텍스트 문자열로 액세스할 수 있습니다.
DownloadHandlerFile
메모리 사용량이 적은 대형 파일을 디스크로 다운로드하고 저장할 수 있는 특수한 다운로드 핸들러입니다. 다운로드한 바이트를 파일에 직접 작성하므로 다운로드되는 파일의 크기에 관계없이 메모리 사용량이 적습니다. 다른 다운로드 핸들러와의 차이점은 핸들러 자체가 아니라 저장된 파일에서 데이터를 가져오는 것입니다.
DownloadHandlerTexture
Unity Texture 오브젝트로 사용할 이미지를 다운로드하기 위해 최적화된 특수 다운로드 핸들러입니다. 이것은
DownloadHandlerBuffer
를 사용하여 이미지 파일을 다운로드한 다음
Texture.LoadImage
를 사용하여 원시 바이트에서 텍스처를 만드는 것보다 더 효율적인 대안입니다.
DownloadHandlerAssetBundle
Unity 에셋 번들을 다운로드하기 위해 최적화된 전문 다운로드 핸들러입니다. 데이터를 Unity 에셋 시스템으로 직접 스트리밍하여 결과적으로
AssetBundle
객체를 생성할 수 있습니다.
DownloadHandlerAudioClip
오디오 파일 다운로드에 최적화된 특수한 다운로드 핸들러입니다. 이것은
DownloadHandlerBuffer
를 사용하여 원시 바이트를 다운로드한 다음
AudioClip
를 만드는 것보다 더 효율적인 대안입니다.
DownloadHandlerScript
사용자 지정 스크립터블
DownloadHandler
구현을 위한 추상 기본 클래스입니다. 이 클래스에서 상속하여 네트워크에서 수신되는 데이터의 커스텀 처리를 수행하는 데 사용할 수 있는
UnityWebRequest
시스템의 콜백을 수신합니다.
UnityWebRequest
에는 기본값이 true인
UnityWebRequest.disposeDownloadHandlerOnDispose
프로퍼티가 있습니다. 이 프로퍼티가 true이면
UnityWebRequest.Dispose
호출은 연결된 다운로드 핸들러에서
DownloadHandler.Dispose
도 호출합니다. 다운로드 핸들러에 대한 레퍼런스를 연결된
UnityWebRequest
에 대한 레퍼런스보다 오래 유지하는 경우,
disposeDownloadHandlerOnDispose
를 false로 설정합니다.

핸들러 업로드

업로드 핸들러를 사용하면 업로드 프로세스의 요소를 더욱 자세하게 제어할 수 있습니다. 다음 업로드 핸들러를 사용할 수 있으며, 모두 기본
UploadHandler
클래스를 특화합니다.

핸들러 유형

설명

UploadHandlerRaw
구성 시 데이터 버퍼를 허용합니다. 이 버퍼가 바이트 배열이면 내부적으로 네이티브 코드 메모리에 복사됩니다. 원격 서버가 요청 본문 데이터를 받을 준비가 되었을 때
UnityWebRequest
시스템이 이 버퍼를 사용합니다. 버퍼를
NativeArray
로 제공하면 복제가 수행되지 않습니다.
UploadHandlerFile
파일의 콘텐츠를 요청 본문으로 전송할 수 있습니다. 이 핸들러를 사용하면 많은 메모리를 사용하지 않고도 서버로 큰 파일을 보낼 수 있습니다. 핸들러가 계속해서 파일의 데이터를 읽고 전송하므로 주어진 시간에 파일의 일부만 메모리에 유지됩니다.
UnityWebRequest
자체에 직접 값을 설정하지 않은 경우 웹 요청의
Content-Type
헤더 값에
UploadHandler.contentType
프로퍼티의 값이 사용됩니다.
UnityWebRequest
객체에
Content-Type
헤더를 설정하면 업로드 핸들러 객체의
Content-Type
가 무시됩니다.
UnityWebRequest
또는
UploadHandler
에 대해
Content-Type
를 설정하지 않으면 시스템은 기본적으로
application/octet-stream
의
Content-Type
를 설정합니다.
UnityWebRequest
에는
disposeUploadHandlerOnDispose
가 있으며 기본값은 true입니다. 이 프로퍼티가 true이면
UnityWebRequest.Dispose
호출은 연결된 업로드 핸들러에서
UploadHandler.Dispose
도 호출합니다. 업로드 핸들러에 대한 레퍼런스를
UnityWebRequest
에 대한 레퍼런스보다 오래 유지하는 경우,
disposeUploadHandlerOnDispose
를 false로 설정합니다.

추가 리소스