런처와 Epic Games Store를 통합하는 방법

작동 방식

Epic Games Store(EGS)에서 런처와 게임을 통합할 수 있습니다. 엑솔라 런처를 통해 다른 EGS 게임을 홍보할 수 있습니다.

선행 조건

EGS 통합을 설정하려면 다음이 필요합니다:

• Epic App ID(Artifact ID)
• Epic Games 개발자 포털의 관리자 역할 및 게임 애플리케이션이 있는 계정
• EGS의 게시를 위한 게임 빌드
• 관리자 페이지에 구성된 사용 준비된 런처
• 최신 버전의 BuildPatch 도구

Epic App ID(아티팩트 ID) 얻기

Epic App ID를 찾는 방법:

1. Epic Games 개발자 포털에 로그인합니다.
2. 게임 상품으로 이동합니다.
3. 게임 카드에서, Epic Games Store 옵션을 선택합니다.

4. 사이드 메뉴에서, 아티팩트 및 바이너리를 클릭하고 샌드박스 및 아티팩트를 선택합니다.

5. Epic App ID를 보려면 아티팩트 이름 클릭

통합 단계

인증 설정

1. 클라이언트 정책이 없는 경우 해당 정책을 생성합니다:
   1. Epic Games 개발자 포털에 로그인합니다.
   2. 상품(게임) 설정에서, Product Settings > Clients > Add new client policy 섹션으로 이동합니다.
   3. 정책 이름을 Client policy 필드에 추가합니다.
   4. Client policy type 드롭다운 목록에서 GameClient 정책을 선택합니다.
   5. Add new policy를 클릭합니다.

2. 로그인 클라이언트를 생성합니다:
   1. 상품 설정에서 Product Settings > Clients > Add new client 섹션으로 이동합니다.
   2. 클라이언트 이름을 Client name 필드에 추가합니다.
   3. Client policy 드롭다운에서 새로 생성한 클라이언트 정책을 선택합니다.

3. Create Application을 클릭합니다.

4. 생성한 클라이언트를 할당합니다:
   1. 오른쪽 상단에 있는 Linked Clients를 클릭합니다.
   2. Select Clients 드롭다운 목록에서 이미 생성한 클라이언트를 선택합니다.

5. 권한이 구성되어 있는지 확인하고 Permissions 탐색 표시줄을 클릭합니다. Not configured으로 표시되어 있는 경우, 해당 옵션을 모두 활성화 및 비활성화하고 변경 사항을 저장합니다.

6. 관리자 페이지의 프로젝트에서, 로그인 섹션으로 이동합니다.
7. 로그인 옵션을 선택하고 인증 > 플랫폼 게시 > Epic Games 섹션으로 이동합니다.
8. 애플리케이션 ID 및 애플리케이션 비밀 키 필드를 입력합니다. Epic Games 개발자 포털(Product Settings > Clients > Edit client 섹션)에서 필드 값을 복사합니다.
9. 변경 사항 저장을 클릭합니다.

EGS 플랫폼 설정 및 파일 다운로드

1. 관리자 페이지의 프로젝트에서 런처 섹션으로 이동합니다.
2. 대시보드에서 런처를 찾아 런처 편집을 클릭합니다.
3. 설정 섹션으로 이동하고 Epic Games 플랫폼 로고 오른쪽으로 설정합니다.

4. 게임의 Epic App ID를 입력합니다.
5. 사용자 권한이 제대로 작동하도록 하려면 대상 아이템 ID를 지정합니다. 다음 단계를 수행하여 ID를 검색합니다:
   1. 제품 설정에서, Epic Games Store > 제안 섹션으로 이동합니다.
   2. 런처가 자격을 확인하기 위해 어떤 제안을 사용할지 결정합니다. 사용자가 선택한 권한 제안을 가지고 있으면 런처는 사용자가 게임을 소유한 것으로 간주합니다.
   Edit offer를 클릭하여 Audience Item ID를 확인합니다.

7. 런처 호스트 다운로드를 클릭하여 Windows 또는 macO용 LauncherHost.zip 아카이브를 다운로드합니다.
8. 구성 다운로드를 클릭하여 Windows 또는 macO용 hostArgs.json 구성 파일을 다운로드합니다.

런처 설치 프로그램 생성 및 다운로드

EGS용 게임 빌드 준비

1. LauncherHost.zip 아카이브(이전 단계에서 다운로드해야 함)를 선택한 폴더에 압축을 풉니다. 이 아카이브는 GameBuild 디렉터리를 포함하는 데 이는 Epic 개발자 포털로 로드되는 게임 빌드를 준비하는 데 사용됩니다.

• LauncherHost.exe - LauncherHost 유틸리티의 실행 파일
• Qt5Core.dll vcruntime140-140_1.dll, msvcp140-140_1.dll - LauncherHost.exe 유틸리티
• installer의 서비스 라이브러리 - 런처 설치 프로그램을 포함하는 디렉터리

MacOS의 디렉터리 구조:

• LauncherHost - LauncherHost 유틸리티에 대한 실행 파일
• Frameworks - LauncherHost 유틸리티 라이브러리
• installer에 대한 시스템 폴더 - 런처 설치 프로그램을 포함하는 폴더

2. GameBuild 폴더에서 새 폴더를 생성합니다.
3. 게임 빌드를 해당 폴더에 복사 붙여넣기합니다.
4. 게임 > 빌드 > 실행 파일 섹션에서 게임 실행 파일 이름(Windows/mac OS)을 설정하고 게임 실행 파일의 상대 경로를 지정합니다.

5. 런처 설치 프로그램과 hostArgs.json 파일을 GameBuild 디렉터리로 복사합니다. 결과적으로, GameBuild 디렉터리는 다음과 같은 구조를 가져야 합니다:
   • Windows의 경우:

\---GameBuild
    |   hostArgs.json
    |   LauncherHost.exe
    |   msvcp140.dll
    |   msvcp140_1.dll
    |   Qt5Core.dll
    |   vcruntime140.dll
    |   vcruntime140_1.dll
    |
    \---installer
            installer.exe

2. • macOS의 경우:

\---GameBuild
    |   hostArgs.json
    |   LauncherHost
    |
    +---Frameworks
    |   \---QtCore.framework
    |       \---Versions
    |           \---5
    |               |   QtCore
    |               |
    |               \---Resources
    |                       Info.plist
    |                       QtCore.prl
    |
    \---installer
            Launcher.pkg

EGS에 게임 빌드 업로드

1. 이전에 다운로드한 BuildPatch 도구의 압축을 풉니다.
2. 게임 빌드를 위한 캐시 디렉터리로 사용할 BuildPatch 도구의 디렉터리를 생성합니다.
3. 압축을 풀지 않은 디렉터리 BuildPatchTool_x.y.z/Engine/Binaries/Win64(BuildPatch 도구 버전과 운영 체제에 따라 다름)로 이동합니다.
4. 이 디렉터리 내에서 터미널을 열고 다음 명령을 실행하여 게임 바이너리를 업로드합니다. 보다 세부적인 지침은 문서를 참조할 수 있습니다.

.\BuildPatchTool.exe
  -ClientId="<YourClientId>"
  -ClientSecret="<secret>"
  -mode=UploadBinary
  -OrganizationId="<YourOrg>"
  -ProductId="<YourProduct>"
  -ArtifactId="<YourArtifact>"
  -BuildRoot="<absolute-path-to-GameBuild-directory>"
  -CloudDir="<absolute-path-to-cache-directory>"
  -BuildVersion="1.0.2-launcher-win"
  -AppLaunch="LauncherHost.exe"
  -AppArgs=""

명령 매개 변수:

• ClientId 및 ClientSecret은 Product Settings > BPT Credentials 섹션의 Epic 개발자 포털에서 사용 가능합니다.

• OrganizationId는 Organization > Settings 탭의 General Settings 섹션에서 사용할 수 있습니다.

• ProductId는 Product Settings > SDK Download & Credentials탭의 EOS SDK Credentials 섹션에서 사용할 수 있습니다.

• ArtifactId 및 BuildVersion 매개 변수 값을 찾으려면 지침을 참조하십시오. BuildVersion 매개 변수 값은 Epic Games 런처의 게임 카드에 있는 동작 메뉴에서도 사용할 수 있습니다.

• AppLaunch - 다음 형식으로 되어 있는 BuildRoot 관련 주요 실행 파일에 대한 경로:
  • LauncherHost.exe - Windows의 경우 LauncherHost - MacOS의 경우

• AppArgs - 추가 실행 인수. 빈 문자열일 수 있습니다.

아티팩트에 플랫폼 할당

1. 아티팩트 페이지로 이동합니다.
2. 오른쪽에서, Inactive binaries 섹션으로 스크롤하고, 동작 메뉴 버튼(…)을 클릭한 다음, Assign platforms을 클릭합니다. 이에 따라 플랫폼을 선택합니다.

EGS 런처에서 게임에 대한 개발자 액세스 권한 얻기

1. 새 사용자를 그룹에 추가합니다:
   1. Product Settings > Player Groups 섹션으로 이동합니다.
   2. 특정 플레이어 그룹에서 동작 메뉴 버튼(…)을 클릭하고 Edit Group을 클릭합니다.
   3. Add accounts 탭으로 이동하고, ID 제공자로 Epic Games를 선택한 다음, 계정 ID를 지정합니다.

2. 액세스 키를 생성합니다:
   1. 프로젝트 설정의 Epic Games Store > Access keys 페이지로 이동합니다.
   2. 오른쪽 상단에 있는 Generate keys를 클릭합니다.

2. 3. 샌드박스와 키를 생성하려는 제안을 선택합니다.

2. 4. Batch name 필드에 키 이름을 입력합니다.
   5. Testing 유형을 선택합니다.
   6. 수량을 지정합니다.

2. 5. 키가 생성되면 다운로드합니다. 동작 메뉴 버튼(…)을 클릭한 다음, Download를 클릭합니다.

5. EGS 런처의 오른쪽 상단에 있는 프로필 버튼을 클릭한 다음, Redeem Code 옵션을 클릭합니다.
6. 다운로드한 키를 사용하십시오. 제안을 위한 키가 성공적으로 제공되면 사용자에게 해당 제안을 사용할 수 있는 권한이 부여됩니다.

게임 빌드 업데이트

기존 게임 빌드를 업데이트하려면 게임 빌드 준비, EGS로 업로드, 아티팩트로 할당 절차를 반복하십시오.