Paquetes de contenido descargable (DLC) del GDK

​

Configurar la identidad del paquete principal

1. Busca el Store ID (cadena alfanumérica de 12 caracteres) del paquete de aplicación principal en la página Game Setup del producto de tu juego principal. (Ejemplo: 9PNX12345AAA)
2. Agrega el elemento StoreId al archivo MicrosoftGame.config de tu paquete principal.

<?xml version="1.0" encoding="utf-8"?>
<Game configVersion="1">
    <!-- Content omitted for brevity. -->
    <StoreId>**REPLACE WITH STOREID**</StoreId>
</Game>

​

Crear un paquete de DLC

1. Crea el complemento de tu paquete de DLC en Partner Center desde el menú Add-Ons de tu producto principal.
2. Coloca todo el contenido de tu paquete de DLC en un único directorio.
3. Crea un archivo MicrosoftGame.config en el mismo directorio que el contenido de tu paquete de DLC usando los datos de ejemplo siguientes.
4. Especifica la Target Device Family para la que se crea este paquete de DLC en el campo TargetDeviceFamilyForDLC. Los valores permitidos son XBOX One, XBOX Series X|S o PC. Es obligatorio especificarlo para XBOX One y XBOX Series X|S, y es opcional en PC siempre que se use la marca /pc al generar el archivo .MSIXVC de DLC mediante makepkg.exe.
5. Busca el campo Package/Identity/Name del paquete de aplicación principal en la página Game Setup de Partner Center y, a continuación, coloca el Identity Name en el campo MainPackageDependency. Por ejemplo, MyPackageName
6. Busca el Store ID (cadena alfanumérica de 12 caracteres) de tu paquete de complemento/DLC en Partner Center y, a continuación, colócalo en el campo StoreId como se indica a continuación.
7. Busca el Store ID (cadena alfanumérica de 12 caracteres) del paquete de aplicación principal en la página Game Setup del producto de tu juego principal. Colócalo en el campo AllowedProduct como se indica a continuación. Por ejemplo, 9PNX12345AAA

<?xml version="1.0" encoding="utf-8"?>
<Game configVersion="1">
    <Identity Name="**REPLACE**"
        Publisher="**REPLACE**"
        Version="1.0.0.0"/>
    <ShellVisuals DefaultDisplayName="**REPLACE**"
                  PublisherDisplayName="**REPLACE**"
                  StoreLogo="Storelogo.png"
                  Square150x150Logo="Logo.png"
                  Square44x44Logo="SmallLog.png"
                  Description="**REPLACE**"
                  BackgroundColor="#000040"
                  SplashScreenImage="SplashScreen.png"/>
    <StoreId>**REPLACE WITH STOREID OF ADD-ON / DLC**</StoreId>
    <TargetDeviceFamilyForDLC>**REPLACE**</TargetDeviceFamilyForDLC>
    <AllowedProducts>
      <AllowedProduct>**REPLACE WITH STOREID OF BASE GAME**</AllowedProduct>
    </AllowedProducts>

<!-- The Desktop Registration section is for PC only. -->
    <DesktopRegistration>
      <MainPackageDependency Name="**REPLACE_WITH_IDENTITY_OF_PARENT_PRODUCT**" />
      <ProcessorArchitecture>x64</ProcessorArchitecture>
    </DesktopRegistration>
</Game>

8. Abre un símbolo del sistema del Microsoft Game Development Kit (GDK) en la carpeta que contiene una única carpeta con todo el contenido de tu juego y, a continuación, ejecuta el siguiente comando.

9. Si estás creando DLC para PC, usa el siguiente comando.

10. Si estás creando DLC para consola, usa el siguiente comando.

​

Acceso a los paquetes de DLC en tiempo de ejecución desde el juego

1. Enumerar los paquetes
2. Comprobar que existe una licencia de usuario válida para el paquete de destino
3. Toma el packageIdentifier de los resultados de la enumeración y pásalo a la API XPackageMount.

    <VirtualMachine>
        <DlcCompatibility>XboxOne</DlcCompatibility>
    </VirtualMachine>

​

Implementación y prueba de un paquete de DLC

​

Documentación de referencia de la API

• XPackage (contenido de la API)
  • Funciones
    • xpackageenumeratepackages
    • XPackageMount