Unreal 엔진 SDKs

Unreal Engine SDK는 UE4 프로젝트와 엑솔라 상품 통합에 사용할 수 있습니다.

시스템 요구사항

  • 64비트 OS
  • Windows 7 이상
  • macOS 10.13.6 이상
  • XCode 10.1 이상(macOS)
  • Visual Studio 2017 이상
  • Unreal 엔진 4.21 이상

대상 OS

  • iOS
  • Android
  • Linux
  • macOS
  • Windows 32비트
  • Windows 64비트

선행 조건

  1. Epic Games 런처를 다운로드합니다.
  2. 새 UE4 프로젝트 생성.
  3. 다음으로부터 플러그인 다운로드: Unreal 엔진 마켓플레이스 혹은 GitHub.

  1. 필요한 경우 로그인 데모 또는 스토어 데모를 시도합니다.
  2. 엑솔라 게시자 계정을 생성합니다.
  3. 게시자 계정을 생성한 후 자동으로 생성된 게시자 계정을 다음과 같이 설정합니다.
    1. 프로젝트 블록에서 My game을 클릭한 후 프로젝트 설정으로 이동합니다.
    2. 설정 모드에서 프로젝트 이름을 지정한 후 저장을 클릭합니다.
    3. 통합 설정으로 이동하여 새 스토어 관리 메소드 통합 토글러 활성화 여부를 확인합니다.

프로젝트 블록에서 +. 아이콘을 클릭하여 새 프로젝트를 생성할 수 있습니다.

Login UE4 SDK

로그인 UE4 SDK를 사용하여 Xsolla Login API 메소드 앱을 통합하는데 이는 Unreal Engine에 기반합니다. 주요 기능:

  • 사용자 이름과 비밀번호를 사용한 인증
  • 가입
  • 이메일 확인
  • 비밀번호 초기화
  • Steam을 통한 인증 session_ticket
  • 인게임 브라우저에서 로그인 형식을 열어 Steam 계정을 통한 인증
  • 사용자 속성 관리
  • 플랫폼 교차 계정 연동. 본 기능을 사용하려면, 엑솔라 통합 팀에 이메일로 문의하세요 (integration@xsolla.com). 다음 지침을 따라 데모에서 계정 연결 기능을 사용해보세요

솔루션 작동 대상:

  • 엑솔라에 사용자 데이터 저장
  • 이메일/사용자 이름과 암호를 통한 인증
  • Steam을 통한 인증

데모

통합 데모는 Content Browser > 엑솔라 Content > Maps 폴더에서 사용 가능합니다. 하나의 예시로 사용할 수도 있습니다.

기본적으로 데모는 게시자 계정 프로젝트에서 사전 설정한 엑솔라 로그인 ID를 사용합니다.

Demo_Login 지도의 기본값:

  • 로그인 ID: e6dfaac6-78a8-11e9-9244-42010aa80004
  • 사용자 이름: xsolla
  • 이메일: support@xsolla.com
  • 암호: xsolla

통합

로그인 UE4 SDK 통합:

  1. 로그인을 게시자 계정에 설정합니다. 로그인 ID가 필요하며 이는 로그인 설정 > 로그인 ID에 표시됩니다. 이는 UUID 형식으로 되어 있습니다.

  1. UE4 프로젝트의 플러그인을 설정합니다.

게시자 계정에서 로그인 설정

  1. 프로젝트로 이동하여 로그인 블록의 연결을 클릭합니다.

  1. 로그인 설정을 엽니다.
  2. 로그인 프로젝트로 이동하여 새 로그인을 클릭합니다.

  1. 로그인 명칭을 명기하고 생성을 클립합니다.

  1. 일반 설정 > URL로 이동하여 이메일 확인 혹은 암호 재설정 이후에 사용자가 리디렉션되는 콜백 URL을 지정합니다.
  2. 사용자 데이터 스토리지 블록에서 엑솔라 스토리지를 선택합니다.

UE4 프로젝트를 위해 플러그인 설정

  1. Unreal 편집기에서 UE 프로젝트를 엽니다.
  2. Blueprint 프로젝트에만 해당:
    1. UE 프로젝트를 컴파일합니다.
    2. Content Browser로 이동하여 새 C++ Class를 추가하는데 이는 부모 노드가 None입니다.
  3. 설정 > 플러그인 > 설치됨 > 엑솔라 SDK로 이동하여 활성화됨 체크 박스에 체크하고, 지금 재시작 버튼으로 설정을 저장합니다.
  4. 설정 > 프로젝트 설정 > 플러그인 > 엑솔라 로그인으로 이동하여 게시자 계정 > 프로젝트 설정 > 프로젝트 ID에서 확인할 수 있는 프로젝트 ID게시자 계정 > 로그인 설정 > Login ID에서 확인할 수 있는 Login ID를 입력합니다. 이는 UUID 형식으로 되어 있습니다.

  1. Content Browser > View Options로 이동하여 Show Engine ContentShow Plugin Content 체크 박스에 체크.

  1. Content Browser > Xsolla Content > Maps으로 이동하여 Demo_Login 게임 맵을 실행합니다.

  1. 새 사용자를 생성하고 확정 이메일을 확인합니다.

  1. 새 사용자로 로그인하여 필요한 경우 암호를 변경합니다.

필요한 경우 통합 데모 설정을 사용자 정의할 수 있습니다:

  • 문서에 따라 사용자 인터페이스 디자인
  • 이벤트 처리 설정

Store UE4 SDK

Xsolla Store UE4 SDK를 사용하여 Xsolla Store API 메소드를 Unreal 엔진에 기반한 앱에 통합합니다.

솔루션 작동 대상:

  • 가상 아이템 판매
  • 인게임 스토어 관리
  • 사용자 인벤토리 관리
  • 게임 머니 관리

플러그인을 사용하기 전에 게시자 계정에서 스토어와 로그인 모듈을 설정해야 합니다. 통합 필요 사항:

  • 프로젝트 ID. 프로젝트 설정 > 프로젝트 ID에서 확인 가능.

  • 로그인 ID. 로그인 설정 > 로그인 ID에서 확인 가능. UUID 형식으로 되어 있습니다.

데모

통합 데모는 Content Browser > 엑솔라 Content > Maps 폴더에서 사용 가능합니다. 하나의 예시로 사용할 수도 있습니다.

기본적으로 데모는 완전히 구성한 스토어가 있으며 사전에 설정한 게시자 계정의 엑솔라 프로젝트 ID로그인 ID를 사용합니다.

3종류의 데모 지도가 제공됩니다:

  • 로그인 모듈만 사용하는 Demo_Login.
  • 스토어 모듈만 사용하는 Demo_Store. 스토어 모듈을 테스트하기 위한 등록이 필요하지 않습니다.
  • 로그인 모듈과 스토어 연결이 연결된 데모.

데모 지도의 기본값:

  • 로그인 ID: e6dfaac6-78a8-11e9-9244-42010aa80004
  • 사용자 이름: xsolla
  • 이메일: support@xsolla.com
  • 암호: xsolla
  • 프로젝트 ID: 44056

통합

Store UE4 SDK 통합:

  1. 게시자 계정에서 가상 아이템 모듈 설정.
  2. UE4 프로젝트에 대하여 플러그인 설정.

게시자 계정에서 가상 아이템 모듈 설정

  1. 프로젝트로 이동하여 스토어 블록의 연결을 클릭합니다.

  1. 가상 아이템 블록의 연결을 클릭합니다.

  1. 그룹 생성을 클릭합니다.

  1. 그룹코드그룹 이름을 설정하고 스토어에서 그룹 표시를 켭니다. 그룹 만들기를 클릭합니다.

  1. 아이템을 생성하고 다음 정보를 각각에 지정합니다:
    • 아이템이 속하는 하나 이상의 그룹
    • SKU
    • 명칭과 간단한 설명
    • 실제 및 게임머니 가격
    • 이미지(옵션)

  1. 그룹 상태가 활성화됨인지 확인합니다.

UE4 프로젝트를 위해 플러그인 설정

  1. Unreal 편집기에서 UE 프로젝트를 엽니다.
  2. Blueprint 프로젝트에만 해당:
    1. UE 프로젝트를 컴파일합니다.
    2. Content Browser로 이동하여 새 C++ Class를 추가하는데 이는 부모 노드가 None.
  3. Settings > Plugins > Installed > Xsolla Store SDK로 이동하여 Enabled 체크 박스에 체크하고, Restart Now 버튼으로 설정을 저장합니다.
  4. Settings > Project Settings > Plugins > Xsolla Login으로 이동하여 로그인 ID를 입력합니다. Settings > Project Settings > Plugins > Xsolla Store으로 이동하여 프로젝트 ID를 입력합니다.

  1. Content Browser > View Options로 이동하여 Show Engine ContentShow Plugin Content 체크 박스에 체크.

  1. Content Browser > Xsolla Content > Maps으로 이동하여 Demo_Login 게임 맵을 실행합니다. 다음의 Demo_Store를 먼저 실행하면 사용자 변경은 불가합니다.

  1. 새 사용자를 생성합니다. 확인 이메일을 확인합니다.

  1. 새 사용자로 로그인하여 필요한 경우 암호를 변경합니다.

필요한 경우 통합 데모 설정을 사용자 정의할 수 있습니다:

  • 문서에 따라 사용자 인터페이스 디자인
  • 이벤트 처리 설정

데모에서 계정 연결 방법 시도하기

다른 플랫폼 상의 플레이어의 계정을 기본 계정으로 연결하여 다음 기능을 구현할 수 있습니다:

  • 다른 플랫폼 상의 자동 플레이어 인증
  • 다른 플랫폼 상의 단일 교차 플랫폼 인벤토리 관리

사전 게시자 계정 프로젝트를 위해 플랫폼 계정의 기본 계정에의 연결을 확인하기 위하여 데모 맵을 사용할 수 있습니다.

Info: 개별 플랫폼 별로 1개의 계정만을 기본 계정에 연결할 수 있습니다.

데모 프로젝트에서 계정 연결 시험 방법:

  1. Unreal 편집기의 UE 프로젝트로 이동.
  2. 데모 맵을 설정하여 플랫폼 계정을 통해 애플리케이션에 로그인:
    1. Settings > Project Settings > Plugins > Xsolla Login로 이동. Use cross-platform account linking 온션 활성화. PlatformPlatform Account ID을 지정.
    2. Settings > Project Settings > Plugins > Xsolla Store로 이동. Use cross-platform account linking 옵션을 활성화. Platform을 선택, Xsolla Login과 동일.
  3. Demo 데모 맵을 Content Browser > Xsolla Content > Maps 폴더에서 시작. 데모는 플랫폼 계정을 통한 인증을 시뮬레이션하여, 자동으로 인증하고 인게임 스토어로 진행하게 됩니다.
  4. 데모 맵에서 Account linking를 클릭. 데모 프로젝트는 기본 브라우저에서 열려서 다른 플랫폼에서의 시작을 시뮬레이션하게 됩니다.
  5. Create an account을 클릭.
  6. 이메일과 비밀번호를 지정하고 Accept and create을 클릭.
  7. 카탈로그에서 아이템을 선택하고 Buy on Xsolla을 클릭. 다음 시험용 신용 카드 중 하나를 사용하여 구매. 영수증 종료.
  8. 화면 상단의 이메일을 클릭하여 메뉴를 엽니다. Inventory을 클릭. 구매한 아이템을 인벤토리에서 사용할 수 있는지 확인.
  9. Get code을 클릭. 열린 창의 Request the code을 클릭. 수신한 계정 연결 코드를 기입.
  10. UE 데모 맵으로 이동.
  11. 수신한 계정 연결 코드를 입력 (스텝 9 참조)하고 Confirm을 클릭.
  12. 이제 플랫폼 계정이 기본 계정으로 연결됩니다. 구매한 아이템을 데모 맵의 인벤토리에서 사용할 수 있는지 확인하세요.
  13. 이 계정이 이미 기본 계정에 연결되었으므로, 이로부터 계정 연결 코드를 구할 수 있습니다. Get linking code을 클릭. 수신한 코드 기입.
  14. 데모 맵을 설정하여 다른 플랫폼 계정을 통해 애플리케이션에 로그인합니다 (스텝 2 참조). Publishing platform는 스텝 2에서 선택한것과 달라야 합니다.
  15. Demo 데모 맵을 Content Browser > Xsolla Content > Maps 폴더에서 시작합니다.
  16. 플레이어의 인벤토리가 비어 있는지 확인합니다.
  17. Account linking를 클릭합니다. UE 데모 맵을 유지합니다.
  18. 수신한 계정 연결 코드를 입력하고 (스텝 13 참조) Confirm를 클릭합니다.
  19. 이제 새 플랫폼의 계정 또한 기본 계정에 연결됩니다. 구매한 아이템을 UE 데모 맵 인벤토리에서 사용할 수 있는지 확인합니다.

레시피를 따라 여러분 프로젝트에 대한 계정 연결 구성.