Uso del GDK con GameMaker

• Instalación del software necesario
• Descarga e instalación de GameMaker Studio 2
• GameMaker Studio 2 - Extensión de Microsoft Game Development Kit (GDK)
• Compilación de la extensión del GDK
• Creación de un producto en Microsoft Partner Center
• Prueba de la extensión del GDK
• Actualización de MicrosoftGame.config
• Integración de la extensión del GDK en su propio proyecto
• Prueba de los servicios de XBOX en su juego
• Publicación

​

Instalación del software necesario

• Visual Studio 2022
• GDK de junio de 2024 o posterior
• CMake
  • Asegúrese de que el instalador de CMake actualice las rutas del sistema. De lo contrario, el proyecto de la extensión no podrá encontrar CMake.

​

Actualización de Gaming Runtime Services (GRTS) y PC Bootstrapper

​

Descarga e instalación de GameMaker Studio 2

​

Configuración de la extensión del GDK de GameMaker Studio 2

​

Compilación de la extensión del GDK

​

Creación de un producto en Microsoft Partner Center

​

Prueba de la extensión del GDK

​

Actualización de MicrosoftGame.config

1. Vaya al panel de Partner Center.
2. Seleccione su juego en la lista de productos.
3. Seleccione la pestaña Game setup y, después, seleccione Identity details.
4. Seleccione Show Details para expandir la sección Identity details.
5. Use los siguientes valores de la tabla de la sección Identity details. Copie esos valores de Partner Center en el elemento y el campo correspondientes de MicrosoftGame.config.

​

Extracto de un archivo MicrosoftGame.config de ejemplo

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

​

Integración de la extensión del GDK en su proyecto

• Llame a gdk_init para inicializar el GDK. Debe llamar a gdk_init antes de usar cualquier otra funcionalidad del GDK.
• Llame a gdk_update una vez por fotograma mientras el GDK esté activo.
• Llame a gdk_quit para limpiar el GDK cuando su proyecto finalice y ya no necesite ninguna funcionalidad del GDK.

• Base Module: proporciona un conjunto de funciones que controlan la selección de usuario/cuenta para el jugador.
• Storage Module: proporciona un conjunto de funciones que controlan la carga y el guardado de datos asociados a un usuario.
• XBOX services Module: proporciona funciones para usar características de los servicios de XBOX, incluidas estadísticas, tablas de clasificación, logros y presencia enriquecida.
• In-App Purchases Module: proporciona funciones que integran los proyectos de GameMaker con los sistemas de comercio de Microsoft Store a través del GDK.

​

Prueba de los servicios de XBOX en su juego

​

Creación de una cuenta de prueba

​

Cambio de sandbox

1. Vaya a Partner Center.
2. Para encontrar su identificador de sandbox, seleccione XBOX services y, después, seleccione Gameplay settings.
   Su identificador de sandbox aparece en la primera pestaña de la página Gameplay settings. Usa un nombre similar a “ABCDEF.0”.
3. Seleccione el botón Inicio.
4. Escriba Microsoft GDK Command Prompts y, después, seleccione Entrar.
5. Abra el primer símbolo del sistema y, después, escriba XblPCSandbox.exe <su identificador de sandbox>.
6. Después de que el símbolo del sistema inicie varias aplicaciones, inicie sesión en la aplicación XBOX con su cuenta de prueba.

​

Publicación de su juego

• Crear un paquete MSIXVC con Package as Zip en GameMaker Studio 2.
• Actualizar su archivo MicrosoftGame.config con los valores correctos del proyecto que creó en Partner Center.
• Integrar la extensión del GDK en su juego.