에픽 온라인 서비스(EOS) 설정하기

에픽게임즈 테크니컬 어카운트 매니저 Rajen Kishna |
2021년 9월 21일
이 시리즈의 첫 번째 연재글을 놓쳤다면, 에픽 온라인 서비스가 무엇이며 게임 개발 프로세스에 어떤 가치를 더할 수 있는지 간단히 알아보세요. 이 연재글에서는 다음을 비롯하여 에픽게임즈 개발자 포털에서 계정을 설정하는 방법에 대해 알아봅니다.

중요 사항

시작하기 전에, 연재글 전반에 걸쳐 염두에 두어야 할 몇 가지 중요 사항이 있습니다.
  • Visual Studio 2019의 C#로 WPF(Windows Presentation Foundation) 애플리케이션을 만드는 데 중점을 두며, 동일한 콘셉트를 C, Android, iOS용 SDK로도 바꿀 수 있습니다.
  • 샘플 애플리케이션은 각 서비스의 가장 중요한 API 콜을 위한 정상 경로(Happy Path)를 포함합니다. 추가 기능을 강화하고, 게임에 통합하며, 구현하는 것은 여러분의 몫입니다.
  • 로깅은 주로 디버그 출력을 통해 이루어지지만, 실제 구현에는 더 지속적인 메커니즘을 사용하는 것이 좋습니다.
  • 연재글과 샘플에서는 에픽게임즈를 인증 제공자로 활용하는 데 집중할 예정이지만, 다른 제공자를 지원하기 위한 정보를 찾을 수 있는 곳도 알아볼 것입니다.
  • 마지막으로 SDK 콘셉트를 이용하며 세부사항에 대해 알아보겠습니다. 에픽 온라인 서비스 문서의 개요 페이지를 참고하여 SDK의 중요 개념과 고려 사항을 확인하세요.

중요 사항 설명은 이것으로 마무리하고, 계정 설정부터 시작하겠습니다.

개발자 포털 등록하기

먼저 에픽게임즈 개발자 포털에서 조직과 제품을 관리하려면 에픽 계정이 필요합니다. https://dev.epicgames.com/portal/ko에 처음 방문했다면, 에픽 계정으로 로그인하거나 계정을 생성하게 될 것입니다. 이메일 주소, Facebook, Google, Steam과 같은 인증 제공자로부터 받은 인증 코드로 에픽 계정을 생성할 수 있습니다. 계정 생성 후, 개발자 포털에 액세스하려면 2단계 인증을 진행해야 합니다.

개발자 포털에 처음 로그인하면, ‘혼자서’ 시작할지, ‘조직으로서’ 시작할지 선택하게 됩니다. 우선은 ‘혼자서’를 선택합니다. 그러면 자동으로 생성되는 조직의 일원이 될 것입니다. 개발자 포털 문서에서 설명한 것처럼, 데이터는 단계가 구분된 시스템으로 정리됩니다. 조직에는 여러 제품이 있을 수 있습니다. 제품마다 하나 이상의 샌드박스(배포 환경)이 있으며, 샌드박스마다 하나 이상의 디플로이(배포)가 있습니다.
Developer Portal Default Organization Product
에픽게임즈 개발자 포털 기본 조직 및 제품

SDK는 제품 > 샌드박스 > 디플로이의 전체 계층구조로 초기화 됩니다. 디플로이 단계에서 제품 세션 데이터에 액세스할 수 있다는 뜻입니다. ‘혼자서’를 선택했다면 기본 ‘라이브’ 샌드박스가 있는 기본 제품이 제공됩니다. 따라서 ‘출시’ 디플로이가 포함되어 있습니다. 이번 샘플에는 기본 제품을 사용할 예정이지만, 필요에 따라 새 제품, 샌드박스 및 디플로이를 생성해도 됩니다.
Developer Portal Sandbox Deployment
기본 샌드박스 및 디플로이

제품 세팅 액세스하기

제품을 클릭하면 좌측 메뉴에 ‘제품 세팅’으로 이동할 수 있는 탭이 표시됩니다. 제품 세팅에서는 제품 이름과 커버 이미지를 변경할 수 있으며, 무엇보다 SDK가 요구하는 모든 크리덴셜을 비롯해 해당 제품에 액세스할 환경, ID 제공자, 클라이언트를 설정할 수 있습니다. 시리즈를 진행하면서 이 모든 요소를 자세히 알아볼 예정이지만, 지금은 이러한 정보를 어디서 찾을 수 있는지 아는 것으로 충분합니다. ‘일반’ 탭에는 기본으로 설정된 클라이언트나 애플리케이션이 없으니 다음에 진행하도록 하겠습니다.
 
Developer Portal Product Settings제품 세팅

클라이언트 및 클라이언트 정책 생성하기

샘플 앱으로 EOS를 연결하려면 앱으로 할 수 있는 것과 할 수 없는 것에 대한 권한을 설정하기 위해 클라이언트 정책클라이언트를 생성해야 합니다. 클라이언트가 어디에 쓰일지 고려하는 것이 중요합니다. 신뢰할 수 있는 환경(예: 컨트롤 가능한 서버 내 환경)인가요, 아니면 신뢰할 수 없는 환경(예: 게임 속 플레이어에 의한 환경)인가요? 에픽 온라인 서비스를 원치 않는 방식으로 사용하는 위험을 줄이려면, 이러한 요소를 바탕으로 최소한의 작업만 할당해야 합니다.
  1. 제품을 둘러보고 ‘제품 세팅’에서 ‘클라이언트’ 탭을 클릭합니다. 확인 후, 조항에 동의한다면 수락합니다.
  2. ‘클라이언트’ 탭으로 돌아오면 ‘클라이언트’와 ‘클라이언트 정책’에 해당하는 공간이 표시됩니다. 새 클라이언트를 생성하려면 ‘신규 클라이언트 추가’ 버튼을 클릭합니다.
  3. 표시되는 메뉴에서 클라이언트 이름(예: EOS 샘플)을 입력하고 ‘신규 클라이언트 정책 추가’ 버튼을 클릭하여 새 정책을 추가합니다.
  4. 표시되는 ‘클라이언트 정책’ 메뉴에서 클라이언트 정책 이름(예: EOS 샘플 게임 클라이언트 정책)을 입력하고 클라이언트 정책 유형을 선택합니다. 미리 정의된 정책이 많지만, 일단 ‘커스텀’을 선택합니다.
  5. 이제 클라이언트 정책의 조건과 기능을 선택할 수 있습니다. 샘플 앱에서 로그인 후에 모든 기능이 작동하므로 ‘User required’ 조건을 체크합니다.
  6. ‘기능’에서 클라이언트(샘플 앱)가 액세스할 서비스를 선택합니다. 기능을 활성화하면 기능마다 작업을 결정할 수 있습니다. 이러한 기능은 샘플을 만들고 나면 활성화할 테니, 지금은 비활성화 상태로 둬도 됩니다.
  7. ‘저장 & 종료’를 클릭하여 클라이언트와 클라이언트 정책 설정을 완료합니다.
Developer Portal Client Client Policy Added
클라이언트 및 클라이언트 정책 추가 완료

오늘은 여기서 마무리하겠습니다. 다음 시간에는 Visual Studio 2019 환경과 WPF 샘플 애플리케이션 구조를 설정하겠습니다. 이전 연재글의 시리즈 참조를 통해 이 시리즈의 모든 연재글을 확인할 수 있습니다. 에픽 온라인 서비스 커뮤니티 지원 포럼에 의견을 남겨주세요.

    여러분의 성공이 곧 에픽의 성공입니다

    에픽은 통합되고 열려 있는 게임 커뮤니티를 지향합니다. 저희는 이 온라인 서비스를 누구나 이용할 수 있도록 무료로 제공함으로써 더 많은 개발자들이 자신만의 플레이어 커뮤니티를 서비스할 수 있도록 지원하는 것을 목표로 하고 있습니다.