Mods Sample

에픽 온라인 서비스(Epic Online Services, EOS) SDK의 모드 샘플은 다음과 같은 모드 마켓플레이스의 상호작용을 보여줍니다.

• 애플리케이션에서 사용 가능한 모든 모드 열거하기
• 사용자가 설치한 모드 열거하기
• 모드 설치 또는 설치 제거하기
• 모드 업데이트하기

이 문서는 모드 샘플을 설정하고 실행하는 방법을 안내하며 이러한 기능의 사용법을 개괄적으로 보여줍니다.

모드 샘플을 사용하려면 다음과 같은 필수 구성 요소가 필요합니다.

• EOS-SDK.zip
• 에픽게임즈 스토어 런처 클라이언트가 설치되어 있어야 합니다.
• 개발자 포털에 다음과 같은 정보로 구성된 에픽게임즈 스토어 테스트 앱이 있어야 합니다.
  • productid
  • sandboxid
  • deploymentid
  • clientid
  • clientsecret

이 섹션은 32비트 및 64비트 Windows 운영 체제에서 모드 샘플 앱을 빌드하고 실행하는 방법을 설명합니다.

1. 원하는 위치에 EOS-SDK.zip의 압축을 풉니다.

2. \EOS-SDK\Samples\ 로 이동합니다.

3. Samples.sln 을 더블 클릭합니다. 솔루션 탐색기에서 Visual Studio가 함께 열립니다.

4. 스타트업 프로젝트(StartUp Project) 를 Mods 프로젝트로 설정합니다.

5. SampleConstants.h 를 열고 테스트 앱의 값에 따라 ProductId, SandboxId, DeploymentId, ClientCredentialsId, ClientCredentialsSecret 을 업데이트합니다.

6. 솔루션 구성을 선택합니다. Release_DX 와 Debug_DX 중 하나를 사용합니다.

   

7. 솔루션 플랫폼을 x64 (Win64) 또는 x86 (Win32) 중에서 선택합니다.

   

8. 솔루션 탐색기(Solution Explorer) 에서 Mods 프로젝트를 우클릭하고 빌드(Build) 를 선택합니다.

   

9. 빌드에 성공하면 \EOS-SDK\Samples\Mods\Bin\Win64\Release_DX\ 에 다음과 같은 파일이 생깁니다.

   

이제 샘플 애플리케이션을 실행할 수 있습니다.

모드 샘플 앱을 실행하려면 시작하기 전에에서 설명한 필수 구성 요소가 있어야 하며, 이전 섹션에서 설명한 테스트 애플리케이션을 빌드한 상태여야 합니다. 또한 런처가 설치되어 있고 해당 테스트 빌드를 가리키고 있어야 합니다. 다음 단계에 따라 애플리케이션을 준비하고 실행하세요:

1. 테스트 빌드를 가리키는 런처를 열고 테스트 앱을 설치합니다.

2. EOS SDK의 로컬 위치 \EOS-SDK\ 로 이동합니다. 여기에 이전 섹션에서 빌드한 샘플이 있을 것입니다.

3. 별도의 파일 탐색기에서 테스트 앱의 설치 위치 로 이동합니다.

4. 로컬 EOS-SDK 에 있는 다음 파일을 앱의 설치 위치에 복사합니다.

   • \Mods\Bin\Win64\Release_DX\EOSSDK-Win64-Shipping.dll
   • \Mods\Bin\Win64\Release_DX\Mods.exe
   • \Shared\Assets\*.*
   

5. 명령 프롬프트에서 cd 를 이용하여 Mods.exe 위치로 이동합니다. 예시: C:\Program Files\Epic Games\TestApp\Samples\Mods\Bin\Win64\Release_DX\

6. 샘플 앱을 열려면 다음 명령을 실행합니다. start ./Mods.exe

위 설정을 완료하면 모드 샘플 앱이 실행됩니다. 클릭하면 이미지가 확대됩니다.

샘플 애플리케이션이 열립니다. 테스트를 진행할 수 있습니다. 자세한 정보는 [모드-샘플-앱-실행하기](#모드 샘플 앱 실행하기)를 참고하세요.

이 섹션은 MacOS에서 모드 샘플 애플리케이션을 설치하고 실행하는 방법을 설명합니다.

MacOS에서 모드 샘플 앱을 빌드하려면 다음 종속성을 설치해야 합니다.

• SDL2
• SDL2_ttf
• GLEW
• cmake
• gcc(Xcode의 Command Line Tools를 통해)

이러한 항목은 시작하기 전에에서 설명한 필수 구성 요소와 더불어 요구됩니다.

1. 원하는 위치에 EOS-SDK.zip의 압축을 풉니다.

2. 터미널(Terminal)에서 \EOS-SDK\Samples\Mods\ 로 이동합니다.

3. SampleConstants.h를 열고 테스트 앱의 값에 따라 ProductId, SandboxId, DeploymentId, ClientCredentialsId, ClientCredentialsSecret 을 업데이트합니다.

4. ./Build.sh 를 실행합니다.

5. 빌드가 완료되면 \EOS-SDK\Samples\Mods\Build\ 경로에 파일이 새로 생깁니다.

   

이제 샘플 앱을 실행할 수 있습니다.

1. 테스트 빌드를 가리키는 런처를 엽니다.

2. 테스트 앱을 설치합니다.

3. EOS SDK의 로컬 위치 \EOS-SDK\ 로 이동합니다. 이전에 빌드한 샘플이 이 디렉터리에 있습니다.

4. 별도의 파인더(Finder) 창에서 새롭게 설치한 테스트 앱의 설치 위치로 이동합니다.

5. 로컬 EOS-SDK에 있는 다음 파일을 앱 설치 위치에 복사합니다.

   • /Build/Mods
   • /Build/Assets/
   

6. 터미널에서 cd 를 이용하여 앱 설치 위치 아래의 Build 폴더로 이동합니다. 예를 들면 ~/Users/Shared/Epic Games/TestApp/Build/

7. 샘플 앱을 열려면 다음 명령을 실행합니다. ./Mods

위 설정을 완료하면 모드 샘플 앱이 실행됩니다. 클릭하면 이미지가 확대됩니다.

샘플 애플리케이션이 열립니다. 테스트를 진행할 수 있습니다. 자세한 정보는 [모드-샘플-앱-실행하기](#모드 샘플 앱 실행하기)를 참고하세요.

개발자 인증 도구(Developer Authentication Tool)로 로그인하려면 개발자 인증(Dev Auth) 옵션을 선택하고 로그인(Log In) 을 선택합니다. 로그인하면 모드 샘플 앱에 다음 옵션이 포함됩니다.

모든 모드 열거(Enumerate All Mods) 옵션을 선택하면 애플리케이션에서 사용 가능한 모든 모드를 가져와서 목록으로 표시합니다. 이 목록은 사용자에게 해당 모드를 사용할 권한이 있는지와는 상관없이 각 모드의 설치 상태도 표시합니다. 사용자는 이 보기에서 모드를 설치, 업데이트, 설치해제할 수 있습니다.

모든 모드 열거 함수 기능은 사용자의 권한 유무와는 상관없이 앱에서 사용 가능한 모든 모드를 보여줍니다. 클릭하면 이미지가 확대됩니다.

설치된 모드 열거(Enumerate Installed Mods) 를 선택하면 현재 사용자가 설치한 모든 목록을 가져와서 목록으로 표시합니다. 이 목록에는 사용자가 해당 모드를 사용할 권한이 있는지를 포함하여 각 모드의 설치 상태도 표시합니다. 사용자는 이 보기에서 모드를 업데이트 및 삭제할 수 있습니다.

설치된 모드 열거 함수 기능은 사용자가 앱에 설치한 모든 모드를 보여주며, 해당 모드를 관리할 수 있게 합니다. 클릭하면 이미지가 확대됩니다.