Unity 웹 요청 API 소개
Unity 웹 요청 API의 주요 용도 및 아키텍처를 이해합니다.
읽는 시간 2분최근 업데이트: 9일 전
UnityWebRequestUnity 웹 요청 시스템의 일반적인 용도는 다음과 같습니다.
-
런타임 시 콘텐츠 다운로드(예:
- 일반 에셋 번들 또는 Adressables 시스템을 사용할 때 원격 서버의 에셋 번들.
- 구성, Localization 및 라이브 튜닝을 위한 텍스트/JSON.
- 동적 콘텐츠를 위한 이미지(텍스처로) 및 오디오(오디오 클립으로)
- 원격 매니페스트를 통한 빌드 타임 또는 런타임 패치 적용
-
서버에 데이터 업로드(예:
- 플레이어 지표입니다.
- 저장된 게임 상태.
- 오류/예외 로그 및 크래시 리포트
- 맞춤형 텔레메트리 및 Analytics
-
컨텐츠 전송 네트워크, Authentication 및 보안, 결제 플랫폼, Multiplayer Services, 진단 및 원격 빌드 파이프라인과의 통합
-
낮은 트래픽의 네트워크 Multiplayer 및 턴제 게임(예: 체스)을 구현합니다.
아키텍처
Unity 웹 요청 시스템은 두 개의 레이어로 구성됩니다.
- 고수준 API(HLAPI)는 저수준 API를 래핑하고 일반적인 작업을 위한 편리한 인터페이스를 제공합니다.
- 로우레벨 API(LLAPI)는 보다 고급 작업을 위한 최대의 유연성을 제공합니다.
시스템은 HTTP 거래를 다음 작업으로 분류합니다.
- 서버에 데이터 전송.
- 서버에서 데이터를 수신합니다.
- HTTP 플로 제어(예: 리디렉션 및 오류 처리)
각 작업은 특정 타입의 오브젝트에 의해 관리되며, 이를 사용하여 거래의 요소를 커스터마이즈하고 제어할 수 있습니다.
- 객체는 서버로의 데이터 전송을 처리합니다.
UploadHandler - 서버에서 수신한 데이터의 수신, 버퍼링 및 포스트 프로세싱을 처리하는 객체입니다.
DownloadHandler - 객체는 다른 두 개의 객체를 관리하고 HTTP 플로 제어도 처리합니다. 이 오브젝트는 커스텀 헤더와 URL이 정의되고 오류 및 리디렉트 정보가 저장되는 곳입니다.
UnityWebRequest

Data sent from user code passes through an UploadHandler and then a UnityWebRequest before reaching the HTTP web server. Data received from the server passes through a UnityWebRequest and then a DownloadHandler before reaching user code.
다음은 HTTP 거래의 개요입니다.
-
객체를 구성합니다.
UnityWebRequest- 커스텀 헤더를 설정합니다.
- HTTP 동사 설정(예: ,
GET,POST- 모든 플랫폼에서 사용자 지정 동사 사용 가능).HEAD - URL 설정합니다.
-
(선택 사항) 업로드 핸들러를 생성하고 웹 요청에 연결합니다.
- 업로드할 데이터를 제공합니다.
- 업로드할 HTTP 양식을 제공합니다.
-
(선택 사항) 다운로드 핸들러를 생성하여 웹 요청에 연결합니다.
-
웹 요청을 보냅니다.
- 코루틴에서 요청이 완료될 때까지 기다리는 호출 결과를
UnityWebRequest.SendRequest할 수 있습니다.yield
- 코루틴에서 요청이 완료될 때까지 기다리는
-
(선택 사항) 다운로드 핸들러에서 수신한 데이터를 읽습니다.
-
(선택 사항) 오류 정보, HTTP 상태 코드 및객체의 응답 헤더를 읽습니다.
UnityWebRequest
이러한 단계를 설명하는 자세한 코드 예시는 에 대한 API 문서를 참조하십시오.
UploadHandlerRaw