이 섹션에서는 모든 Microsoft 게임 개발 키트(GDK) 개발에 필요한 설정 단계와 PC 또는 Xbox용 Microsoft 게임 개발 키트(GDK) 게임 개발을 지원하는 데 필요한 플랫폼별 설정 단계에 대해 설명합니다. 본체용으로 개발하는 경우 Xbox 확장(GDKx)을 사용하여 Microsoft 게임 개발 키트를 설치해야 합니다.
Microsoft 게임 개발 키트(GDK) 사용을 시작하려면 먼저 개발자 환경 설정의 단계를 거쳐야 합니다.
본체용으로 개발하는 경우 개발 환경을 설정한 후 Xbox 개발 키트 설정권한 부여 필요 의 단계를 따라야 합니다. Xbox 개발 키트가 설정되면 필요에 따라 Xbox 콘솔 샘플 실행 및 Xbox One권한 부여 필요용 Microsoft 게임 개발 키트 포팅 가이드를권한 부여 필요 검토합니다.
미들웨어 엔진을 사용하는 경우 시작하는 데 도움이 되는 추가 콘텐츠는 엔드투엔드 가이드 집합에서 찾을 수 있습니다. 엔드 투 엔드 가이드는 Unity, Unreal, GameMaker 및 사용자 지정 게임 엔진에 대해 제공됩니다.
개발 환경 설정
게임 런타임 타이틀 개발을 위해 개발 PC 설정의 단계에 따라 Xbox 확장에서 GDK 또는 GDK를 사용하여 개발을 준비하도록 PC를 설정합니다.
새 GDK 프로젝트 생성 또는 기존 데스크톱 프로젝트에 GDK 통합
다음 단계는 처음부터 시작하는 경우 새 GDK 프로젝트를 생성하거나 GDK를 기존 데스크톱 프로젝트에 통합하는 것입니다.
- 새 프로젝트를 생성하려면 GDK 프로젝트 템플릿을 사용하여 새 타이틀 개발 시작의 지침을 따르세요.
- GDK를 기존 프로젝트에 통합하려면 기존 데스크톱 프로젝트에 GDK 추가의 지침을 따르세요.
Xbox 서비스 개발 준비
도전 과제 및 클라우드 저장과 같은 기능을 사용하려면 Xbox 서비스 기능을 게임에 통합해야 합니다.
Xbox 서비스를 사용한 개발에 대한 자세한 내용은 Xbox 서비스 시작하기를 참조하세요.
PC에서 Xbox 서비스 로그인을 관리하려면 Xbox 앱을 설치하는 것이 좋습니다.
타이틀이 Xbox 서비스 멀티플레이어 기능을 지원하는 경우 Xbox Game Bar를 설치해야 합니다(Microsoft Store에서 설치).
참고 항목
Xbox Game Bar는 대부분의 Windows 10 버전에 자동으로 포함됩니다. 테스트를 위해 Xbox Game Bar는 항상 최신 버전으로 업데이트되어야 합니다.
파트너 센터 프로젝트 생성 및 이를 사용하도록 게임 구성
게임에 대한 파트너 센터 프로젝트를 만들고 파트너 센터 프로젝트의 값을 사용하도록 게임을 구성할 때까지 Xbox 서비스 기능을 테스트할 수 없습니다.
파트너 센터에서 제품 만들기
Xbox 서비스 기능을 테스트하거나 게임을 Microsoft Store 게시하기 전에 파트너 센터 Xbox 서비스 지원 제품을 만들어야 합니다. 파트너 센터에 대한 자세한 내용은 관리 파트너를 위해 파트너 센터에서 앱 또는 게임 설정을 참조하세요.
MicrosoftGame.config 업데이트 중
새 GDK 프로젝트 생성 또는 기존 데스크톱 프로젝트에 GDK 통합 섹션에서 프로젝트를 생성할 때 생성된 MicrosoftGame.config 파일에는 Gaming Runtime, Microsoft Store 및 타이틀 ID의 기능을 사용하기 시작할 때까지 추가 구성 없이 PC 및 Xbox에서 초기 개발을 허용하는 기본값이 있습니다. Xbox 서비스 기능을 사용하려면 파트너 센터 프로젝트 ID 세부 정보로 프로젝트의 MicrosoftGame.config를 업데이트해야 합니다.
- 파트너 센터 대시보드로 이동합니다.
- 제품 목록에서 게임을 선택합니다.
- 게임 설정 탭을 선택하고 ID 세부 정보를 선택합니다.
- 세부 정보 표시를 선택하요 ID 세부 정보 섹션을 확장합니다.
- Identity details 섹션의 표에서 다음 값을 사용한 다음 파트너 센터에서 해당 값을 MicrosoftGame.config의 해당 요소 및 필드에 복사합니다.
| 파트너 센터의 이름 | MicrosoftGame.config |
|---|---|
| Xbox 타이틀 ID | TitleId |
| Package/Identity/Name | ID->이름 |
| Package/Identity/Publisher | ID->게시자 |
| Xbox 서비스 -> Xbox 설정 -> MSAAppId | MSAAppId |
예를 들어 파트너 센터에서 다음 ID 세부 정보를 사용하면 MicrosoftGame.config가 아래 샘플과 같이 표시됩니다.
| 파트너 센터의 이름 | 예제 값 |
|---|---|
| Xbox 타이틀 ID | 64353034 |
| Package/Identity/Name | 41336MicrosoftATG.Achievements2017Redux |
| Package/Identity/Publisher | CN=A4954634-DF4B-47C7-AB70-D3215D246AF1 |
| Xbox 서비스 -> Xbox 설정 -> MSAAppId | 0000000000000000 |
<?xml version="1.0" encoding="utf-8"?>
<Game configVersion="1">
<Identity Name='41336MicrosoftATG.Achievements2017Redux' Version="1.1.0.0" Publisher='CN=A4954634-DF4B-47C7-AB70-D3215D246AF1' />
<TitleId>64353034</TitleId>
<MSAAppId>0000000000000000</MSAAppId>
<ExecutableList>
<Executable Name="Achievements2017_desktop.exe"
TargetDeviceFamily="PC"
Id="Game"/>
</ExecutableList>
<ShellVisuals DefaultDisplayName="Achievements2017 Desktop Sample"
PublisherDisplayName="Xbox Advanced Technology Group"
StoreLogo="Assets\StoreLogo.png"
Square150x150Logo="Assets\Logo.png"
Square44x44Logo="Assets\SmallLogo.png"
Square480x480Logo="Assets\LargeLogo.png"
Description="Achievements2017"
ForegroundText="dark"
BackgroundColor="#000000"
SplashScreenImage="Assets\SplashScreen.png"/>
</Game>
MicrosoftGame.config의 값에 대한 추가 정보는 MicrosoftGame.config 개요를 참조하세요.
Xbox 서비스 기능 테스트
게임에서 사용하는 Xbox 서비스 기능을 테스트하려면 하나 이상의 테스트 계정을 만들고 개발 샌드박스로 전환해야 합니다.
테스트 계정 만들기
Xbox 서비스 기능을 테스트하려면 개발 샌드박스에 액세스할 수 있는 테스트 계정을 만들어야 합니다. 테스트 계정 만들기에 대한 자세한 내용은 테스트 계정 만들기를 참조하세요.
개발 샌드박스 전환
테스트 계정을 만든 후 계정을 사용하고 다음 단계를 따라 개발 샌드박스에 액세스합니다.
- 샌드박스 ID를 찾으려면 파트너 센터로 이동합니다.
- 게임으로 이동합니다.
- 왼쪽 탐색 창에서 Xbox 서비스>게임 플레이 설정을 선택합니다.
참고 항목
샌드박스 ID는 게임 플레이 설정 페이지의 왼쪽 위 모서리에 있는 첫 번째 탭에 있습니다. 이름은 "ABCDEF.0"와 같은 형식입니다.
- 시작 메뉴를 엽니다.
- Microsoft GDK Command Prompts를 입력하고 키보드의 Enter 키를 누릅니다.
- 첫 번째 명령 프롬프트를 엽니다.
- 명령 프롬프트에 XblPCSandbox.exe [샌드박스 ID]를 입력합니다.
- 명령 프롬프트에서 여러 개 앱이 시작되면 테스트 계정을 사용하여 Xbox 앱에 로그인합니다.
성공적으로 로그인할 수 있으면 테스트 계정을 만들고 테스트를 시작하기 위해 샌드박스로 변경한 것입니다. 로그인하는 데 문제가 있는 경우 로그인 및 샌드박스 문제 해결을 참조하여 도움을 받으세요.
원격 PC 테스트
원격 테스트 PC를 설정하고 원격 디버깅을 구성하는 테스트에 도움이 될 수도 있습니다. 자세한 내용은 원격 테스트 PC 설정 및 Visual Studio에서 C++ 프로젝트 원격 디버깅 항목을 참조하세요.
게임 패키징
게임을 게시하려면 먼저 게임을 패키지해야 합니다. MSIXVC는 Microsoft Store에서 요구하는 패키징 형식입니다. 패키징된 게임은 Microsoft Store에서 타이틀 ID와 타이틀별 셸 화면을 활성화하는 MicrosoftGame.config 파일을 필요로 합니다. 자세한 내용은 MicrosoftGame.config 개요를 참조하세요.
PC 게임 패키징을 시작하려면 PC용 패키징 시작을 참조하세요.
콘솔 게임 패키징을 시작하려면 콘솔용 패키징 시작을 참조하세요.
참고 항목
2022년 3월 게임 서비스 릴리스부터 MSIXVC 패키지를 설치한 결과 디스크에 파일이 배치되는 방식이 개선되었습니다. 이러한 개선 사항을 통해 게임 파일을 더 쉽게 검색할 수 있고 설치된 MSIXVC 게임을 간편하게 관리할 수 있습니다. 자세한 내용은 플랫 파일 설치 개요를 참조하세요.
게시
게시할 준비가 되면 파트너 센터 게임을 제출해야 합니다. 게임을 제출하려면 파트너 센터로 이동하고 UI의 지침에 따릅니다.
유용한 링크
Microsoft 게임 개발 키트 도구를 활용하여 PC 타이틀 설치 및 시작
Xbox 개발 및 테스트 키트 개요권한 부여 필요
Xbox 개발 및 테스트 키트에 대해 설명합니다.
Xbox 소매 및 개발 키트 하드웨어 사양권한 부여 필요
Xbox Series X, Xbox Series X 개발 키트, Xbox Series S 하드웨어 사양을 제공합니다.
이 섹션의 내용
개발자 환경 설정
Xbox 콘솔용 게임과 PC용 게임 개발에 공통으로 적용되는 필수 설정 단계를 설명합니다.
PlayFab을 사용하여 GDK 타이틀 시작
Microsoft GDK(게임 개발 키트) 타이틀에 PlayFab 사용을 시작하는 방법을 설명합니다.
Xbox ATG 계약(NDA 토픽)권한 부여 필요
Xbox Advanced Technology Group에 참여하는 방법을 설명합니다.