기술 자료

Unity 엔진

Unity 엔진

Unity 웹 요청 API 소개

Unity 웹 요청 API의 주요 용도 및 아키텍처를 이해합니다.
읽는 시간 2분최근 업데이트: 9일 전

UnityWebRequest
는 Unity의 HTTP/HTTPS 네트워킹 API로, 런타임 시 웹 서비스와 통신하고 파일을 전송하고 스트리밍 데이터를 전송합니다.
Unity 웹 요청 시스템의 일반적인 용도는 다음과 같습니다.
  • 런타임 시 콘텐츠 다운로드(예:
    • 일반 에셋 번들 또는 Adressables 시스템을 사용할 때 원격 서버의 에셋 번들.
    • 구성, Localization 및 라이브 튜닝을 위한 텍스트/JSON.
    • 동적 콘텐츠를 위한 이미지(텍스처로) 및 오디오(오디오 클립으로)
    • 원격 매니페스트를 통한 빌드 타임 또는 런타임 패치 적용
  • 서버에 데이터 업로드(예:
    • 플레이어 지표입니다.
    • 저장된 게임 상태.
    • 오류/예외 로그 및 크래시 리포트
    • 맞춤형 텔레메트리 및 Analytics
  • 컨텐츠 전송 네트워크, Authentication 및 보안, 결제 플랫폼, Multiplayer Services, 진단 및 원격 빌드 파이프라인과의 통합
  • 낮은 트래픽의 네트워크 Multiplayer 및 턴제 게임(예: 체스)을 구현합니다.

아키텍처

Unity 웹 요청 시스템은 두 개의 레이어로 구성됩니다.
  • 고수준 API(HLAPI)는 저수준 API를 래핑하고 일반적인 작업을 위한 편리한 인터페이스를 제공합니다.
  • 로우레벨 API(LLAPI)는 보다 고급 작업을 위한 최대의 유연성을 제공합니다.
시스템은 HTTP 거래를 다음 작업으로 분류합니다.
  • 서버에 데이터 전송.
  • 서버에서 데이터를 수신합니다.
  • HTTP 플로 제어(예: 리디렉션 및 오류 처리)
각 작업은 특정 타입의 오브젝트에 의해 관리되며, 이를 사용하여 거래의 요소를 커스터마이즈하고 제어할 수 있습니다.
  • UploadHandler
    객체는 서버로의 데이터 전송을 처리합니다.
  • 서버에서 수신한 데이터의 수신, 버퍼링 및 포스트 프로세싱을 처리하는
    DownloadHandler
    객체입니다.
  • UnityWebRequest
    객체는 다른 두 개의 객체를 관리하고 HTTP 플로 제어도 처리합니다. 이 오브젝트는 커스텀 헤더와 URL이 정의되고 오류 및 리디렉트 정보가 저장되는 곳입니다.

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 양식을 제공합니다.
  • (선택 사항) 다운로드 핸들러를 생성하여 웹 요청에 연결합니다.
  • 웹 요청을 보냅니다.
  • (선택 사항) 다운로드 핸들러에서 수신한 데이터를 읽습니다.
  • (선택 사항) 오류 정보, HTTP 상태 코드 및
    UnityWebRequest
    객체의 응답 헤더를 읽습니다.
이러한 단계를 설명하는 자세한 코드 예시는
UploadHandlerRaw
에 대한 API 문서를 참조하십시오.

추가 리소스