> ## 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) du 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 de lots 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 d'empaquetage et certaines API d'exécution ont été mis à jour et sont plus faciles à utiliser.

Les packages DLC sont pris en charge sur PC à l'aide de la même structure d'empaquetage, et sont accessibles 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 à 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 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 du Product ID de votre jeu principal sur la ligne de commande avec 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 répertoriés dans votre fichier MicrosoftGame.config.

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

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

1. [Énumérer les packages](/fr/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. Récupérez le `packageIdentifier` dans les résultats de l'énumération et transmettez-le à l'API [XPackageMount](/fr/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, sauf si vous spécifiez `XboxOne` pour le champ `DlcCompatibility` dans votre 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, tandis que les DLC XBOX One ne sont soumis à aucune restriction de ce type ; tenez-en compte avant d'activer cette option pour votre jeu.

## Déploiement et test d'un package DLC

Veillez à installer votre package de jeu principal avant d'installer votre package DLC.

Pour une console XBOX, installez votre package DLC avec la commande suivante.
`xbapp install <Your_DLC_Package.xvc>`

Pour un PC, installez votre package DLC avec 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 également être effectués avec des packages téléchargés depuis le Microsoft Store.

Pour plus d'informations, consultez [Gérer et accorder des licences pour le contenu téléchargeable](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/reference/system/xpackage/xpackage_members)
  * Fonctions
    * [xpackageenumeratepackages](/fr/reference/system/xpackage/functions/xpackageenumeratepackages)
    * [XPackageMount](/fr/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)