에픽 온라인 서비스(Epic Online Services, EOS)를 시작 및 실행하려면 게임이 EOS 서비스에 액세스할 수 있도록 EOS SDK를 게임에 통합하세요. 통합하는 방법은 다음과 같습니다.
- 개발자 포털에서 에픽게임즈 계정과 조직을 설정합니다.
- EOS SDK를 다운로드합니다(C 또는 C# 사용 가능).
- 게임에 플랫폼 인터페이스를 통합합니다.
이 문서에서는 SDK 다운로드 시 함께 제공되는 샘플 코드에 대한 정보와 함께 이를 수행하는 방법을 안내합니다.
소개 블로그, FAQ, 언리얼 엔진 및 Unity용 EOS 게임 엔진 플러그인에 대한 몇 가지 정보를 포함한 소개 리소스도 있습니다. 이러한 정보에 관한 자세한 내용은 소개 리소스 페이지를 참고하세요.
시작 단계
시작하기 전 - 시스템 사양
시스템 사양 페이지에서 개발 환경과 게임 클라이언트 런타임 환경의 시스템 사양을 확인하세요.
1단계 - 에픽게임즈 계정 및 조직 설정
개발자 포털(dev.epicgames.com/portal)을 사용하여 게임에 EOS 서비스 사용을 설정하고, 서비스를 구성하고, SDK 다운로드에 액세스할 수 있습니다.
개발자 포털에서 에픽게임즈 계정을 '조직'과 연결합니다. 조직은 회사 또는 비즈니스입니다. 각 게임은 '제품'이라고 합니다. 조직에는 다수의 제품이 있을 수 있습니다.
모든 게임(개발자 포털의 제품 )에는 다음과 같은 것들이 있습니다.
- 제품 ID - 게임의 고유 식별자입니다.
- 하나 이상의 샌드박스 ID - 게임의 구현을 위해 서로 다르게 명명된 환경입니다. 사용 예시: 게임 구현의 개발, 테스트, 프로덕션 버전을 구분하는 3개의 서로 다른 샌드박스가 있습니다.
각 샌드박스에는 다음과 같은 것들이 있습니다.
- 하나 이상의 디플로이 ID - 샌드박스 내 게임 구현의 여러 반복작업입니다. 사용 예시: 테스트 샌드박스의 모든 디플로이는 베타 테스트 버전 또는 출시 후보 버전이며, 프로덕션 샌드박스의 모든 디플로이는 출시 버전입니다.
EOS SDK는 이를 사용하여 EOS 서비스로 게임을 식별합니다.
계정을 설정할 때 제품 관리 툴을 사용하는 방법에 관해 자세히 알아보려면 제품, 샌드박스, 디플로이 ID 문서를 참고하세요.
2단계 - EOS SDK 다운로드
개발자 포털에서 조직과 제품을 구성하고 나면 개발자 포털에서 EOS SDK를 다운로드할 수 있습니다.
SDK를 다운로드하려면 개발자 포털 홈페이지에서 SDK 다운로드(Download SDK) 를 클릭하세요.
참고: 에픽 온라인 서비스(EOS) SDK를 사용하려면 로컬 네트워크, 라우터, 방화벽에서 특정 호스트 주소에 액세스할 수 있도록 허용해야 합니다. 이러한 호스트 주소의 전체 목록은 방화벽 고려 사항 문서를 참조하세요.
EOS SDK 다운로드 타입
게임 클라이언트를 실행하는 플랫폼에 따라 다음과 같은 다양한 SDK 다운로드 유형을 사용해야 합니다.
- Windows, macOS, Linux - C 및 C# EOS SDK
- 모바일 - iOS용 EOS SDK, Android용 EOS SDK
- 콘솔 - C 및 C# 게임 콘솔용 EOS SDK를 다운로드할 수 있습니다.
콘솔용 SDK는 에픽게임즈와 플랫폼 저작권자로부터 승인받은 개발자만 다운로드할 수 있습니다.
플랫폼 저작권자로는 Microsoft(Xbox One, Xbox Series X), Sony(PlayStation 4, PlayStation 5), Nintendo(Switch)가 있습니다.
콘솔용 SDK 다운로드 액세스 받기 및 관련 문서:- 개발자 포털(dev.epicgames.com/portal)로 이동하여 하단의 SDK & RELEASE NOTES(SDK & 출시 노트), Request access(액세스 요청) 를 차례로 클릭하고 플랫폼 저작권자로부터 콘솔 개발 액세스를 신청하기 위한 지침을 확인하세요.
- 플랫폼 저작권자로부터 승인받으면 eoshelp.epicgames.com에서 에픽 온라인 서비스를 위한 콘솔 개발자 요청 양식을 사용하여 에픽게임즈에 승인을 요청할 수 있습니다.
EOS SDK 다운로드에 포함된 항목
EOS SDK 다운로드는 다음과 같은 디렉터리로 구성되어 있습니다.
디렉터리 | 콘텐츠 | ||
/Samples | EOS SDK의 작동 방식을 시연하는 샘플 구현입니다. | ||
/SDK | 게임에서 EOS 서비스를 사용할 수 있도록 EOS SDK를 게임과 통합하기 위해 게임에서 사용하는 라이브러리와 헤더 파일입니다. | ||
/ThirdPartyNotices | 지원하는 라이브러리에 관한 법적 정보입니다. |
샘플
플랫폼 기능 일부를 시연하는 샘플 디렉터리를 확인해 보시는 것이 좋습니다. 샘플에 관한 자세한 내용은 다음 문서를 참고하세요.
- 인증 및 친구 샘플
- 세션 매치메이킹 샘플
- 로비 샘플
- P2P NAT 샘플
- 플레이어 데이터 스토리지 샘플
- 타이틀 스토리지 샘플
- 리더보드 샘플
- 스토어 샘플
- 모드 샘플
- Android SDK 샘플 사용하기
- C# SDK 샘플 사용하기
- iOS SDK 샘플 사용하기
EOS SDK 추가 정보
EOS SDK 사용에 관한 추가적인 정보는 다음 문서를 참고하세요.
- 인터페이스 핸들, 명명 규칙, 오류 처리, 기타 핵심 정보는 EOS SDK 핵심 정보를 참고하세요.
- C# EOS SDK와 C EOS SDK의 구현에는 차이가 있습니다. C#와 Unity로 게임을 개발하고 있다면 C# EOS SDK 문서도 참고하세요.
3단계 - 플랫폼 인터페이스 통합
게임에서 EOS 서비스를 사용하려면 인터페이스를 통합해야 합니다. 인터페이스는 서비스별로 나뉩니다.
게임에 가장 먼저 통합할 인터페이스는 플랫폼 인터페이스입니다. 여기에는 다른 모든 인터페이스에 액세스하고 다른 모든 인터페이스를 실행하는 데 필요한 핸들이 포함되어 있습니다. 게임을 시작하면 SDK를 초기화하고 플랫폼 인터페이스 핸들을 얻어야 합니다.
자세한 내용은 플랫폼 인터페이스 문서를 참고하세요.
참고: 플랫폼 인터페이스는 게임 클라이언트가 실행되는 게임 플랫폼과 다릅니다. 문서에서는 이러한 게임 플랫폼을 '플랫폼에서의 EOS 활용'이라고 합니다.
지원
eoshelp.epicgames.com의 에픽 개발자 리소스 지원 커뮤니티를 활용하여 질문하고, 지원받고, 에픽 개발자 리소스 커뮤니티에 참여할 수 있습니다.
다음과 같은 사항이 지원됩니다.
- 개발자 포털
- 에픽게임즈 스토어
- 에픽 온라인 서비스(Epic Online Services, EOS)
- 키즈 웹 서비스(Kids Web Services, KWS)
새로운 기능
다음 문서에서 새로운 기능에 관한 최신 정보를 확인하세요.
EOS 로드맵(trello.com/~/eos-public-roadmap)에서는 개발 중인 사항을 확인하실 수 있습니다.