웹 요청 저수준 API 레퍼런스
로우레벨 웹 요청 API를 사용하여 고급 HTTP 작업을 수행합니다.
읽는 시간 3분최근 업데이트: 9일 전
고수준 웹 요청 API는 보일러플레이트 코드의 필요성을 최소화하지만 저수준 웹 요청 API는 더 많은 유연성과 제어 기능을 제공합니다.
이 섹션에는 저수준 API 주요 구성원과 해당 시나리오가 나와 있습니다. 일반적으로 저수준 API를 사용하려면 특정 다운로드 및 업로드 사례를 위한 특수한 또는 객체를 첨부하는 를 생성해야 합니다.
DownloadHandlerUploadHandlerUnityWebRequest고수준 API와 저수준 API는 상호 배타적이지 않습니다. 일반 작업에 대한 더 많은 제어가 필요한 경우 고수준 API를 통해 생성된 객체를 언제든지 사용자 지정할 수 있습니다.
UnityWebRequestUnityWebRequest 오브젝트 인스턴스화
UnityWebRequestUnityWebRequestUnityWebRequest자세한 내용은 API 레퍼런스를 참조하십시오.
UnityWebRequest핸들러 다운로드
전문적인 다운로드 핸들러를 사용하면 특정 다운로드 사례를 처리하고 수신되는 데이터 처리를 제어할 수 있습니다. 다음 다운로드 핸들러를 사용할 수 있으며, 모두 기본 클래스를 특화합니다.
DownloadHandler핸들러 유형 | 설명 |
|---|---|
| 단순한 데이터 스토리지에 사용됩니다. 이 다운로드 핸들러는 가장 간단하며 대부분의 사용 사례를 처리합니다. 수신된 데이터를 네이티브 코드 버퍼에 저장합니다. 다운로드가 완료되면 버퍼링된 데이터에 바이트 배열 또는 텍스트 문자열로 액세스할 수 있습니다. |
| 메모리 사용량이 적은 대형 파일을 디스크로 다운로드하고 저장할 수 있는 특수한 다운로드 핸들러입니다. 다운로드한 바이트를 파일에 직접 작성하므로 다운로드되는 파일의 크기에 관계없이 메모리 사용량이 적습니다. 다른 다운로드 핸들러와의 차이점은 핸들러 자체가 아니라 저장된 파일에서 데이터를 가져오는 것입니다. |
| Unity Texture 오브젝트로 사용할 이미지를 다운로드하기 위해 최적화된 특수 다운로드 핸들러입니다. 이것은 |
| Unity 에셋 번들을 다운로드하기 위해 최적화된 전문 다운로드 핸들러입니다. 데이터를 Unity 에셋 시스템으로 직접 스트리밍하여 결과적으로 |
| 오디오 파일 다운로드에 최적화된 특수한 다운로드 핸들러입니다. 이것은 |
| 사용자 지정 스크립터블 |
UnityWebRequestUnityWebRequest.disposeDownloadHandlerOnDisposeUnityWebRequest.DisposeDownloadHandler.DisposeUnityWebRequestdisposeDownloadHandlerOnDispose핸들러 업로드
업로드 핸들러를 사용하면 업로드 프로세스의 요소를 더욱 자세하게 제어할 수 있습니다. 다음 업로드 핸들러를 사용할 수 있으며, 모두 기본 클래스를 특화합니다.
UploadHandler핸들러 유형 | 설명 |
|---|---|
| 구성 시 데이터 버퍼를 허용합니다. 이 버퍼가 바이트 배열이면 내부적으로 네이티브 코드 메모리에 복사됩니다. 원격 서버가 요청 본문 데이터를 받을 준비가 되었을 때 |
| 파일의 콘텐츠를 요청 본문으로 전송할 수 있습니다. 이 핸들러를 사용하면 많은 메모리를 사용하지 않고도 서버로 큰 파일을 보낼 수 있습니다. 핸들러가 계속해서 파일의 데이터를 읽고 전송하므로 주어진 시간에 파일의 일부만 메모리에 유지됩니다. |
UnityWebRequestContent-TypeUploadHandler.contentTypeUnityWebRequestContent-TypeContent-TypeUnityWebRequestUploadHandlerContent-Typeapplication/octet-streamContent-TypeUnityWebRequestdisposeUploadHandlerOnDisposeUnityWebRequest.DisposeUploadHandler.DisposeUnityWebRequestdisposeUploadHandlerOnDispose