> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Packages de contenu téléchargeable (DLC) du Microsoft Game Development Kit

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

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 theme={null}
<?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 en utilisant les exemples de données ci-dessous.

4. 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.

5. 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

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 theme={null}
<?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.

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

9. 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>`

10. 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.

1. [Énumérer les packages](/fr-CA/reference/system/xpackage/functions/xpackageenumeratepackages)
2. [Vérifier que l'utilisateur dispose d'une licence valide pour le package cible](https://learn.microsoft.com/build/store/commerce/fundamentals/xstore-manage-and-license-optional-packages)
3. Prendre le `packageIdentifier` dans les résultats de l'énumération et le transmettre à l'API [XPackageMount](/fr-CA/reference/system/xpackage/functions/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 :

```xml theme={null}
    <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](https://learn.microsoft.com/build/store/commerce/fundamentals/xstore-manage-and-license-optional-packages).

## Documentation de référence des API

* [XPackage (contenu de l'API)](/fr-CA/reference/system/xpackage/xpackage_members)
  * Fonctions
    * [xpackageenumeratepackages](/fr-CA/reference/system/xpackage/functions/xpackageenumeratepackages)
    * [XPackageMount](/fr-CA/reference/system/xpackage/functions/xpackagemount)


## Related topics

- [Guide BVT de certification pour PC](/fr/publishing/game-publishing/concepts/certification/certification-pc-bvt-guide.md)
- [XR037 Dépendances vis-à-vis des packages de contenu](/fr/publishing/certification/fma/xr-037.md)
- [XR-037 Dépendances vis-à-vis des packages de contenu](/fr/publishing/certification/xr/xr-037.md)
- [XR037 Dépendances envers les packages de contenu](/fr-CA/publishing/certification/fma/xr-037.md)
- [XR-037 Dépendances envers les paquets de contenu](/fr-CA/publishing/certification/xr/xr-037.md)