Relay 시작하기

다음 섹션을 읽고 Relay 프로젝트를 어떻게 설정하는지, 그리고 Relay 샘플 프로젝트를 어떻게 사용하는지 살펴보십시오. 아직 Unity Dashboard를 사용해 보지 않았다면 UGS 시작하기에서 Unity Dashboard로 작업하는 방법을 알아볼 수 있습니다.

참고: 바인딩 및 Relay 서버를 통해 수행되는 다른 상호 작용은 UTPNGO 등의 네트워킹 솔루션을 사용하여 처리됩니다. NGO는 더 높은 수준이며 내부적으로 UTP를 사용합니다.

Relay 프로젝트 설정

Relay는 무료 티어가 있는 PAYG(Pay As You Go) 서비스입니다. 무료 티어 월간 사용량 제한을 초과하는 경우, 결제 정보를 입력해야만 Relay와 다른 모든 서비스를 계속 사용할 수 있습니다. 자세한 내용은 UGS 가입을 확인하십시오.

참고: 계속하려면 Unity Dashboard 계정이 있어야 합니다. 자세한 내용은 UGS 개요 기술 자료를 참고하십시오.

  1. Unity Dashboard 프로젝트를 생성합니다.

  2. Relay 서비스를 활성화합니다.

    1. Unity Dashboard에서 Multiplayer > Relay를 선택합니다.
    2. Set up Relay를 선택합니다.
    3. Unity Dashboard에 내장된 Relay 설정 가이드를 계속 진행합니다.
  3. Unity 에디터에 Relay 프로젝트를 연결합니다.

    1. Unity 엔진에서 프로젝트를 열고 Edit > Project Settings로 이동합니다.
    2. Project Settings 창에서 Services 탭으로 이동합니다.
    3. Use an existing Unity project ID를 클릭하고 설정 가이드에 표시된 Dashboard 프로젝트에 연결합니다.
    4. 프로젝트를 연결하면 다음 연동 프로세스 단계로 넘어갈 수 있습니다.
  4. Relay 패키지를 설치합니다.

    1. Unity에서 Window > Package Manager로 이동합니다.
    2. 패키지 관리자에서 검색하거나 스크롤하여 Unity Registry 내에 있는 'Relay' 패키지를 찾습니다.
    3. 패키지를 선택하고 Install 버튼을 클릭합니다.
  5. Simple Relay 샘플 프로젝트를 통해 샘플 프로젝트와 상호 작용하는 방법을 알아봅니다.

Simple Relay 샘플

Simple Relay 샘플은 Relay SDK를 활용하는 예시 프로젝트입니다. 프로젝트에는 여러 버튼으로 구성된 간단한 UI(사용자 인터페이스)가 있으며, 이 프로젝트의 목적은 SDK를 직접 테스트하는 것입니다. 샘플 프로젝트를 사용해 보려면 다음 단계를 따르십시오.

참고: Simple Relay 샘플은 스탠드얼론 Relay SDK의 기능만 보여 주며, 서버에 대한 바인딩은 포함되지 않습니다. 스탠드얼론 Relay SDK는 할당 및 참여 코드를 생성하기 위해 Relay 백엔드 서비스에 HTTP API를 호출하며, 이는 클라이언트의 네트워크 연결에 영향을 미치지 않습니다.

Simple Relay 샘플 프로젝트 임포트

  1. Unity 에디터(버전 2020.3)에서 Relay 프로젝트를 엽니다. 아직 Relay 프로젝트를 설정하지 않았다면 Relay 프로젝트 설정을 확인하십시오.

  2. Package Manager를 열고 Relay 패키지로 이동합니다.

  3. Samples 섹션을 펼칩니다.

  4. Import를 선택하여 Simple Relay 샘플 프로젝트를 임포트합니다.

  5. Simple Relay 샘플 프로젝트를 임포트하고 나면 이 프로젝트를 씬으로 열 수 있습니다. 샘플 프로젝트는 현재 프로젝트에서 Assets/Samples/Relay/1.0.1-pre.3/Simple Relay Sample 아래에 있습니다.

  6. File > Open Scene을 선택합니다.

  7. Simple Relay 샘플 씬으로 이동합니다.

샘플 프로젝트를 어떻게 사용하는지 알아보려면 Simple Relay 샘플 사용을 확인하십시오.

Simple Relay 샘플 사용

  1. Unity 에디터에 로그인합니다.

  2. Account > **Sign in…**으로 이동합니다.

  3. Sign in 버튼을 선택하면 브라우저 창에서 Unity Dashboard가 열립니다. Relay를 활성화한 프로젝트와 동일한 계정으로 로그인했는지 확인하십시오.

  4. 프로젝트를 Simple Relay 샘플에 연결합니다.

  5. Edit > **Project Settings…**를 선택합니다.

  6. Use an existing Unity project ID를 선택합니다.

  7. 조직과 프로젝트를 선택합니다.

  8. Link project ID를 선택합니다.

  9. 성공하면 프로젝트 ID가 Unity Project ID 아래에 표시됩니다.

Simple Relay 샘플 시작

  1. 플레이 버튼을 선택해서 샘플을 시작합니다.

  2. 샘플을 플레이하면서 샘플 내의 각 버튼을 선택하여 다음 작업을 할 수 있습니다.

    1. Sign In (Anonymously)은 Unity 익명 인증을 사용하여 Relay에 로그인합니다. 이때 플레이어 ID가 생성됩니다.
    2. Get Regions는 Relay 서버를 사용할 수 있는 모든 지역을 나열합니다.
    3. Create Relay는 Relay 할당을 생성하고 호스트 할당 ID를 반환합니다.
    4. Get Join Code는 호스트가 다른 플레이어와 공유할 수 있는 참여 코드를 생성합니다.
    5. Join Relay는 Relay 할당에 참여하고 플레이어 할당 ID를 반환합니다.