GDK를 4.26 이전 Unreal Engine 프로젝트에 통합

Microsoft Store에 게임을 게시할 준비를 하고 있고, 게임이 4.26 이전의 Unreal Engine 버전을 사용하는 경우 이 항목을 참고하세요.

​

이전 Unreal Engine 버전 사용(4.26 이전)

Unreal Engine 4.26 이상을 사용한다면 PC에서 Unreal 시작하기를 참조하세요. Unreal Engine 4.25 이하를 사용하고 있고, 4.26 이상으로 업그레이드할 수 없다면, Gaming Runtime과 XBOX Services API(XSAPI)의 임포트 라이브러리를 사용해 여전히 주요 XBOX 생태계 경험과 통합할 수 있습니다. 이러한 임포트 라이브러리는 게임 프로젝트에 GDK 플랫폼 타깃을 추가할 필요 없이 Gaming Runtime API와 XSAPI로 직접 호출할 수 있게 해줍니다.

​

Gaming Runtime과 XSAPI용 헤더 및 임포트 라이브러리 추가

1. Unreal 프로젝트의 빌드 파일을 찾습니다: /Source/(ProjectName)/(ProjectName).Build.cs
2. _GAMING_DESKTOP 매크로를 정의하기 위해 아래 줄을 추가합니다.
       PublicDefinitions.Add("_GAMING_DESKTOP");  // Unreal 4.12 이하는 대신 "Definitions.Add()" 사용
   
3. 다음 include 경로를 추가합니다.
       // Gaming Runtime의 include 경로 추가
       PublicIncludePaths.Add(@"C:\Program Files (x86)\Microsoft GDK\241000\GRDK\GameKit\Include");
       // XSAPI의 include 경로 추가
       PublicIncludePaths.Add(@"C:\Program Files (x86)\Microsoft GDK\241000\GRDK\ExtensionLibraries\Xbox.Services.API.C\Include");
   

Microsoft GDK(2024년 6월) 이하의 경우 다음을 사용하세요: C:\Program Files (x86)\Microsoft GDK\230300\GRDK\ExtensionLibraries\Xbox.Services.API.C\DesignTime\CommonConfiguration\Neutral\Include

1. 임포트 라이브러리를 위한 다음 라이브러리 경로를 추가합니다.
       // Gaming Runtime의 임포트 라이브러리 추가
       PublicAdditionalLibraries.Add(@"C:\Program Files (x86)\Microsoft GDK\241000\GRDK\GameKit\Lib\amd64\xgameruntime.lib");
       // XSAPI의 임포트 라이브러리 추가
       PublicAdditionalLibraries.Add(@"C:\Program Files (x86)\Microsoft GDK\241000\GRDK\ExtensionLibraries\Xbox.Services.API.C\Lib\Release\Microsoft.Xbox.Services.142.GDK.C.Thunks.lib");
   

Microsoft GDK(2024년 6월) 이하의 경우 다음을 사용하세요: C:\Program Files (x86)\Microsoft GDK\230300\GRDK\ExtensionLibraries\Xbox.Services.API.C\DesignTime\CommonConfiguration\Neutral\Lib\Release\Microsoft.Xbox.Services.141.GDK.C.Thunks.lib

​

C++ 코드 파일에서 Gaming Runtime과 XSAPI 접근

1. 로그인이나 업적 잠금 해제와 같은 통합을 추가할 위치를 결정합니다.
2. Gaming Runtime과 XSAPI용 헤더를 추가합니다.
       // Unreal Engine 4.15 이상 사용 시
       THIRD_PARTY_INCLUDES_START
       
       #include "XGameRuntimeInit.h" // Gaming Runtime용 
       #include "xsapi-c\services_c.h"  // XSAPI용
       // Unreal Engine 4.15 이상 사용 시
       THIRD_PARTY_INCLUDES_END
   
3. 서비스 호출과 통합합니다. 아래 예시를 참조하세요.

• 방법: 사용자 로그인을 위한 모범 사례
• 타이틀 관리 업적 업데이트

​

Partner Center에서 제품 만들기

XBOX 서비스 기능을 테스트하거나 Microsoft Store에 게임을 게시하려면 먼저 Partner Center에서 XBOX 서비스가 활성화된 제품을 만들어야 합니다. Partner Center에 대한 자세한 내용은 Managed Partner를 위한 Partner Center에서 앱 또는 게임 설정을 참조하세요.

​

게임을 위한 MicrosoftGame.config 파일 생성

게임이 XBOX 서비스에 로그인하려면 게임 패키지에 MicrosoftGame.config 파일을 포함하고, 이전 단계에서 생성한 Partner Center 프로젝트의 값으로 “MSAAppId”와 “TitleId” 필드를 채워야 합니다. config 파일을 만드는 가장 쉬운 방법은 MicrosoftGame.config Editor를 사용하는 것입니다. MicrosoftGame.config 파일에 대한 자세한 내용은 MicrosoftGame.config 개요를 참조하세요.

​

게임 패키지 생성 및 등록

게임에서 XBOX 서비스에 로그인하고 서비스 통합을 테스트하려면 패키지를 생성하고 등록해야 합니다.

1. File > Package Project > Windows > **Windows (64-bit)**를 선택해 패키징 대화 상자에 접근합니다.
2. File Explorer 대화 상자에서 빌드 출력을 위한 폴더를 선택한 다음 Select Folder를 선택합니다.
3. wdapp으로 게임을 실행합니다.
       wdapp launch {MicrosoftGame.Config 파일이 있는 동일 디렉터리 내 게임 실행 파일의 전체 경로}
   
4. 또는 wdapp으로 패키지를 등록한 뒤 시작 메뉴에서 게임을 실행할 수 있습니다.
       wdapp register {MicrosoftGame.Config 파일이 있는 디렉터리의 전체 경로}
   

​

참고

로그인 및 샌드박스 문제 해결