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

Les packages de contenu téléchargeable (DLC) pour le Microsoft Game Development Kit (GDK) sont des packages distincts de votre jeu principal. Les packages DLC sont vendus et téléchargés indépendamment du reste de votre jeu, ou dans le cadre d’ensembles d’achat. Le processus de création, de publication et d’utilisation des packages DLC est conceptuellement le même que pour les titres de console XBOX One, mais certains formats de fichiers de package et certaines API d’exécution ont été mis à jour et sont plus faciles à utiliser. Les packages DLC sont pris en charge sur PC au moyen de la même structure de package, et on y accède avec les mêmes API d’exécution sur console et sur PC. Avec les consoles XBOX Series X|S et XBOX One, un fichier stub de package DLC peut être généré et utilisé pour les deux plateformes. Si le package DLC contient de réelles différences de contenu, utilisez l’élément TargetDeviceFamilyForDLC pour générer des packages DLC propres à chaque plateforme.

Configurer l’identité de votre package principal

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

Créez votre extension de package DLC dans Partner Center à partir du menu Add-Ons de votre produit principal.
Placez tout le contenu de votre package DLC dans un seul répertoire.
Créez un fichier MicrosoftGame.config dans le même répertoire que le contenu de votre package DLC en utilisant les exemples de données ci-dessous.
Spécifiez dans le champ TargetDeviceFamilyForDLC la Target Device Family pour laquelle ce package DLC est créé. 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, pourvu que l’indicateur /pc soit utilisé lors de la génération du fichier .MSIXVC du DLC au moyen de makepkg.exe.
Recherchez le champ Package/Identity/Name de votre package d’application principal sur la page Game Setup de Partner Center, puis inscrivez ce nom d’identité dans le champ MainPackageDependency. Par exemple, MyPackageName
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.
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>

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.

MakePkg genmap /f layout.xml /d <Your_dlc_folder>

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

MakePkg pack /f layout.xml /lt /d <Your_dlc_folder_name> /pc /pd <Output_Folder_Name>

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

MakePkg pack /f layout.xml /lt /d <Your_dlc_folder_name> /pd <Output_Folder_Name> Dans les SDK précédents, vous transmettiez le GUID de l’ID de produit de votre jeu principal sur la ligne de commande au moyen de l’indicateur /ProductID. Avec le modèle MicrosoftGame.Config de configuration des relations de vos packages DLC, n’utilisez pas le paramètre /ProductID. MakePkg place automatiquement les informations appropriées dans votre package en fonction des StoreID énumérés dans votre fichier MicrosoftGame.config.

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

Les étapes de base pour utiliser le contenu d’un package DLC sont les suivantes.

Énumérer les packages
Vérifier que l’utilisateur dispose d’une licence valide pour le package cible
Prendre le packageIdentifier dans les résultats de l’énumération et le transmettre à l’API XPackageMount.

Sur les consoles XBOX Series X|S, vous ne pouvez utiliser que des packages DLC dont le TargetDeviceFamilyForDLC est XBOX Series X|S, à moins de spécifier XboxOne pour le champ DlcCompatibility dans votre fichier MicrosoftGame.config :

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

Les DLC XBOX Series X|S ne peuvent être installés que sur un stockage rapide, alors que les DLC XBOX One ne sont pas soumis à cette restriction; assurez-vous donc d’en tenir compte avant d’activer cette option pour votre jeu.

Déploiement et test d’un package DLC

Assurez-vous d’installer le package de votre jeu principal avant d’installer votre package DLC. Pour une console XBOX, installez votre package DLC à l’aide de la commande suivante. xbapp install <Your_DLC_Package.xvc> Pour un PC, installez votre package DLC à l’aide de la commande suivante. wdapp install <Your_DLC_Package.msixvc> Le contenu DLC peut également être inscrit à partir d’un répertoire contenant des fichiers libres, et les tests peuvent aussi être effectués avec des packages téléchargés à partir du Microsoft Store. Pour plus d’informations, consultez Gérer le contenu téléchargeable et ses licences.

Documentation de référence des API

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

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

Configurer l’identité de votre package principal

Créer un package DLC

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

Déploiement et test d’un package DLC

Documentation de référence des API

​Configurer l’identité de votre package principal

​Créer un package DLC

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

​Déploiement et test d’un package DLC

​Documentation de référence des API

Configurer l’identité de votre package principal

Créer un package DLC

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

Déploiement et test d’un package DLC

Documentation de référence des API