Mods Sample

모드 마켓플레이스와의 상호작용을 시연하는 샘플

5 분 소요

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

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

이 문서는 모드 샘플을 설정하고 실행하는 방법을 안내하며 이러한 기능의 사용법을 알려줍니다.

시작하기 전에

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

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

Win64/Win32용 설정

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

Win64/Win32용 모드 샘플 앱 빌드

  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_DXDebug_DX 중 하나를 사용합니다.

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

    win64는 x64를, win32는 x86을 선택합니다.
  8. 솔루션 탐색기(Solution Explorer) 에서 모드 프로젝트를 우클릭하고 빌드(Build) 를 선택합니다.

    Visual Studio에서 솔루션을 빌드합니다.
  9. 빌드에 성공하면 \EOS-SDK\Samples\Mods\Bin\Win64\Release_DX\ 에 다음과 같은 파일이 생깁니다.

    Win64/Release_DX 폴더에 생긴 EOS 모드 샘플

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

Win64/Win32용 모드 샘플 앱 실행

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

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

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

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

  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에서 모드 샘플 애플리케이션을 설치하고 실행하는 방법을 설명합니다.

설정 준비 사항

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

  • SDL2
  • SDL2_ttf
  • GLEW
  • cmake
  • gcc(Xcode의 명령줄 툴(Command Line Tools)을 통해)

이는 시작하기 전에에 설명된 필수 구성 요소와 더불어 요구되는 항목들입니다.

MacOS용 모드 샘플 앱 빌드하기

  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\

    EOS-SDK\Samples\Mods\Build\에 있는 빌드 파일

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

모드 샘플 앱 실행

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

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

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

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

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

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

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

샘플 앱 실행

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

샘플 애플리케이션이 열립니다. 테스트를 진행할 수 있습니다. 자세한 정보는 모드 샘플 앱 실행을 참조하세요.

모드 샘플 앱 사용

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

모든 모드 나열

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

모든 모드 나열 기능은 사용자의 권한 유무와는 상관없이 앱에서 사용 가능한 모든 모드를 보여줍니다.

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

설치된 모드 나열

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

설치된 모드 나열 기능은 사용자가 앱에 설치한 모든 모드를 보여주며, 해당 모드를 관리할 수 있게 합니다.

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