GameMaker와 함께 GDK 사용

• 필수 소프트웨어 설치
• GameMaker Studio 2 다운로드 및 설치
• GameMaker Studio 2 - Microsoft Game Development Kit(GDK) 확장
• GDK 확장 빌드
• Microsoft Partner Center에서 제품 만들기
• GDK 확장 테스트
• MicrosoftGame.config 업데이트
• 프로젝트에 GDK 확장 통합
• 게임에서 XBOX 서비스 테스트
• 게시

​

필수 소프트웨어 설치

• Visual Studio 2022
• 2024년 6월 GDK 이상
• CMake
  • CMake 설치 프로그램이 시스템 경로를 업데이트하도록 하세요. 그렇지 않으면 확장 프로젝트가 CMake를 찾을 수 없습니다.

​

Gaming Runtime Services(GRTS) 및 PC Bootstrapper 업데이트

​

GameMaker Studio 2 다운로드 및 설치

​

GameMaker Studio 2 GDK 확장 설정

​

GDK 확장 빌드

​

Microsoft Partner Center에서 제품 만들기

​

GDK 확장 테스트

​

MicrosoftGame.config 업데이트

1. Partner Center 대시보드로 이동합니다.
2. 제품 목록에서 게임을 선택합니다.
3. Game setup 탭을 선택한 다음 Identity details를 선택합니다.
4. Show Details를 선택해 Identity details 섹션을 확장합니다.
5. Identity details 섹션의 표에서 다음 값을 사용합니다. Partner Center의 값을 MicrosoftGame.config의 해당 요소와 필드로 복사하세요.

​

MicrosoftGame.config 파일 발췌 예시

<?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>

​

프로젝트에 GDK 확장 통합

• gdk_init를 호출해 GDK를 초기화합니다. 다른 GDK 기능을 사용하기 전에 반드시 gdk_init를 호출해야 합니다.
• GDK가 활성 상태인 동안 프레임당 한 번씩 gdk_update를 호출합니다.
• 프로젝트가 종료되고 더 이상 GDK 기능이 필요하지 않으면 gdk_quit를 호출해 GDK를 정리합니다.

• Base Module: 플레이어의 사용자/계정 선택을 제어하는 함수 집합을 제공합니다.
• Storage Module: 사용자와 연결된 데이터의 로드 및 저장을 제어하는 함수 집합을 제공합니다.
• XBOX services Module: 스탯, 리더보드, 업적, 리치 프레즌스 등 XBOX 서비스 기능을 사용하는 함수를 제공합니다.
• In-App Purchases Module: GameMaker 프로젝트를 GDK를 통해 Microsoft Store 커머스 시스템과 통합하는 함수를 제공합니다.

​

게임에서 XBOX 서비스 테스트

​

테스트 계정 만들기

​

샌드박스 전환

1. Partner Center로 이동합니다.
2. 샌드박스 ID를 찾으려면 XBOX services를 선택한 다음 Gameplay settings를 선택합니다.
   샌드박스 ID는 Gameplay settings 페이지의 첫 번째 탭에 표시되며, “ABCDEF.0”과 같은 이름을 사용합니다.
3. 시작 버튼을 선택합니다.
4. Microsoft GDK Command Prompts를 입력한 다음 Enter를 선택합니다.
5. 첫 번째 명령 프롬프트를 열고 XblPCSandbox.exe <샌드박스 ID> 를 입력합니다.
6. 명령 프롬프트가 여러 앱을 실행한 후 테스트 계정으로 XBOX 앱에 로그인합니다.

​

게임 게시

• GameMaker Studio 2에서 Package as Zip으로 MSIXVC 패키지를 만듭니다.
• Partner Center에서 만든 프로젝트의 올바른 값으로 MicrosoftGame.config 파일을 업데이트합니다.
• GDK 확장을 게임에 통합합니다.