Packages de contenu téléchargeable (DLC) du GDK

​

Configurer l’identité de votre package principal

1. Recherchez le Store ID (chaîne alphanumérique de 12 caractères) de votre package d’application principal sur la page Game Setup de votre produit de jeu principal. (Exemple : 9PNX12345AAA)
2. Ajoutez l’élément StoreId au fichier MicrosoftGame.config de votre package principal.

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

​

Créer un package DLC

1. Créez votre extension de package DLC dans Partner Center à partir du menu Add-Ons de votre produit principal.
2. Placez tout le contenu de votre package DLC dans un seul répertoire.
3. Créez un fichier MicrosoftGame.config dans le même répertoire que le contenu de votre package DLC à l’aide des exemples de données ci-dessous.
4. Spécifiez la Target Device Family pour laquelle ce package DLC est créé dans le champ TargetDeviceFamilyForDLC. Les valeurs autorisées sont XBOX One, XBOX Series X|S ou PC. Ce champ doit obligatoirement être spécifié pour XBOX One et XBOX Series X|S, et il est facultatif sur PC tant que l’indicateur /pc est utilisé lors de la génération du fichier .MSIXVC du DLC à l’aide de makepkg.exe.
5. Recherchez le champ Package/Identity/Name de votre package d’application principal sur la page Game Setup de Partner Center, puis indiquez ce nom d’identité dans le champ MainPackageDependency. Par exemple, MyPackageName
6. Recherchez le Store ID (chaîne alphanumérique de 12 caractères) de votre package d’extension/DLC dans Partner Center, puis placez-le dans le champ StoreId comme suit.
7. Recherchez le Store ID (chaîne alphanumérique de 12 caractères) de votre package d’application principal sur la page Game Setup de votre produit de jeu principal. Placez-le dans le champ AllowedProduct comme suit. Par exemple, 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. Ouvrez une invite de commandes du Microsoft Game Development Kit (GDK) dans le dossier qui contient un seul dossier regroupant tout le contenu de votre jeu, puis exécutez la commande suivante.

9. Si vous créez un DLC pour PC, utilisez la commande suivante.

10. Si vous créez un DLC pour console, utilisez la commande suivante.

​

Accès aux packages DLC au moment de l’exécution depuis votre jeu

1. Énumérer les packages
2. Vérifier que l’utilisateur dispose d’une licence valide pour le package cible
3. Récupérez le packageIdentifier dans les résultats de l’énumération et transmettez-le à l’API XPackageMount.

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

​

Déploiement et test d’un package DLC

​

Documentation de référence des API

• XPackage (contenu de l’API)
  • Fonctions
    • xpackageenumeratepackages
    • XPackageMount