PC용 Unreal 개발: 시작(버전 4.26 이전)

아티클
11/06/2024

PC에서 Microsoft Store를 게시하기 위해 게임을 준비하고 게임에서 4.26 이전 버전의 Unreal Engine을 사용하는 경우 이 항목을 사용합니다.

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

Unreal Engine 버전 4.26 이상을 사용하는 경우 PC에서 Unreal로 시작을 참조하세요.

Unreal Engine 버전 4.25 이하를 사용 중이고 버전 4.26 이상으로 업그레이드할 수 없는 경우에도 게임 런타임 및 Xbox 서비스 API(XSAPI)의 가져오기 라이브러리를 사용하여 주요 Xbox 에코시스템 환경과 통합할 수 있습니다.

이 가져오기 라이브러리를 사용하면 게임에서 게임 프로젝트에 GDK 플랫폼 대상을 추가하지 않고도 게임 런타임 API 및 XSAPI를 직접 호출할 수 있습니다.

게임 런타임 및 XSAPI용 헤더 추가 및 라이브러리 가져오기

Unreal 프로젝트의 빌드 파일인 /Source/(ProjectName)/(ProjectName).Build.cs를 찾습니다.

아래 줄을 추가하여 _GAMING_DESKTOP 매크로를 정의합니다.

    PublicDefinitions.Add("_GAMING_DESKTOP");  // For Unreal 4.12 or earlier, use "Definitions.Add()" instead

다음 포함 경로 추가

    // Add the include path for Gaming Runtime
    PublicIncludePaths.Add(@"C:\Program Files (x86)\Microsoft GDK\241000\GRDK\GameKit\Include");
    // Add the include path for XSAPI
    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

가져오기 라이브러리에 대해 다음 라이브러리 경로를 추가합니다.

    // Add the import library for Gaming Runtime
    PublicAdditionalLibraries.Add(@"C:\Program Files (x86)\Microsoft GDK\241000\GRDK\GameKit\Lib\amd64\xgameruntime.lib");
    // Add the import library for 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

참고 항목

포함 경로 및 라이브러리 경로는 GDK 버전 및 설치 위치에 따라 컴퓨터에서 다르게 나타날 수 있습니다.

C++ 코드 파일에서 게임 런타임 및 XSAPI에 액세스

로그인 및 도전 과제 잠금 해제와 같은 항목에 대한 통합을 추가할 위치를 결정합니다.

게임 런타임 및 XSAPI용 헤더 추가

    // When using Unreal Engine 4.15 or later
    THIRD_PARTY_INCLUDES_START

    #include "XGameRuntimeInit.h" // For Gaming Runtime 
    #include "xsapi-c\services_c.h"  // For XSAPI

    // When using Unreal Engine 4.15 or later
    THIRD_PARTY_INCLUDES_END

서비스 호출과 통합합니다. 아래 예제를 참조하세요.

파트너 센터에서 제품 만들기

Xbox 서비스 기능을 테스트하거나 게임을 Microsoft Store 게시하기 전에 파트너 센터 Xbox 서비스 지원 제품을 만들어야 합니다. 파트너 센터에 대한 자세한 내용은 관리 파트너를 위해 파트너 센터에서 앱 또는 게임 설정을 참조하세요.

게임에 대한 MicrosoftGame.config 파일 만들기

게임이 Xbox 서비스에 로그인하려면 게임 패키지에 MicrosoftGame.config 파일을 포함하고 "MSAAppId" 및 "TitleId" 필드에 마지막 단계에서 만든 파트너 센터 프로젝트의 값을 입력해야 합니다. 구성 파일을 만드는 가장 쉬운 방법은 MicrosoftGame.config 편집기를 사용하는 것입니다.
MicrosoftGame.config 파일의 콘텐츠에 대한 자세한 내용은 MicrosoftGame.config 개요를 참조하세요.

참고 항목

MicrosoftGame.config 파일이 게임의 기본 실행 파일이 포함된 동일한 디렉터리에 있는지 확인합니다.

게임 패키지 만들기 및 등록

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

파일>패키지 프로젝트>Windows>Windows (64-bit)를 선택하여 패키징 대화 상자에 액세스합니다.
파일 탐색기 대화 상자에서 빌드 출력에 대한 폴더를 선택한 다음, 폴더 선택을 선택합니다.

wdapp으로 게임을 시작합니다.

    wdapp launch {full path to the game's executable in the same directory containing the MicrosoftGame.Config file}

또는 wdapp으로 패키지를 등록한 다음 시작 메뉴에서 게임을 시작할 수 있습니다.
```
    wdapp register {full path to the directory containing the MicrosoftGame.Config file}
```

참고 항목

실행 파일을 직접 두 번 클릭하여 Xbox 서비스에 로그인할 수 없습니다.

참고 항목

Unreal 개발 포럼
로그인 및 샌드박스 문제 해결

다음을 통해 공유

PC용 Unreal 개발: 시작(버전 4.26 이전)

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

게임 런타임 및 XSAPI용 헤더 추가 및 라이브러리 가져오기

C++ 코드 파일에서 게임 런타임 및 XSAPI에 액세스

파트너 센터에서 제품 만들기

게임에 대한 MicrosoftGame.config 파일 만들기

게임 패키지 만들기 및 등록

참고 항목

추가 리소스