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

# Création de disques de test

> Création de disques de test

<Note>Ces instructions sont uniquement destinées aux tests. Pour les scénarios de vente au détail, ces données sont configurées automatiquement en fonction des métadonnées de Partner Center. Les options sélectionnées dans le flux de création de disques de compilation servent à contrôler l'ordre d'installation, l'exécution automatique, et plus encore. Vous ne nous soumettez pas directement les métadonnées de test ni les fichiers de configuration JSON lorsque vous soumettez vos jeux pour ingestion.</Note>

Cette rubrique explique comment créer des disques de test. Vous pouvez créer les types de disques de test suivants.

* [Compilations](#ID4E1)
* [Multidisques](#ID4EBE)

<a id="ID4E1" />

## Compilations

### Créer un disque de compilation de test

Pour créer et tester un disque de compilation, vous devez créer un fichier de métadonnées catalog.js et une disposition de disque comme décrit ci-dessous.

* [Créer une disposition de disque](#ID4EGB)
* [Catalog.js](#ID4EMC)
* [Ordre d'installation et notifications](#ID4ELD)
* [Déploiement](#ID4EYD)

<a id="ID4EGB" />

### Créer une disposition de disque

Créez une disposition de disque semblable à l'exemple suivant.

```
- Disc Root
    - Licenses (folder) - (Not needed for Xbox One ERA Development Kits - make sure to use XVCs created with /LT flag)
        License0.xml (file) - (Not needed for Xbox One ERA dev kits - make sure to use XVCs created with /LT flag)
    - MSXC (folder)
        - Package1.xvc (file)
        - Package2.xvc (file)
        - Metadata (folder)
            - catalog.js (file)
            - Bundle (folder)
                - Bundle images (files)
            - Package1.xvc (folder)
                - Package 1 images (files)
            - Package2.xvc (folder)
                - Package 2 images (files)  
```

Les répertoires ont le contenu suivant :

* **Licenses** contient les fichiers de licence des jeux. Ces informations ne sont pas nécessaires pour les trousses de développement ERA XBOX One. Assurez-vous d'utiliser des XVC créés avec l'indicateur **/LT**. Ensuite, ces fichiers peuvent être omis.

* **MSXC** contient les jeux empaquetés et les métadonnées utilisés par l'interface XBOX.

* **Metadata** contient les métadonnées que l'interface utilise pour les jeux sur le disque et pour les packages de jeux.

* **Bundle** contient les images utilisées par l'interface.

* **Package1.XVC** contient les images utilisées par l'interface pour le premier jeu. Le nom doit correspondre à celui du fichier de package du jeu dans MSXC.

* **Package2.XVC** contient les images utilisées par l'interface pour le deuxième jeu. Le nom doit correspondre à celui du fichier de package du jeu dans MSXC.

<a id="ID4EMC" />

### Catalog.js

Dans le dossier Metadata, créez un fichier nommé catalog.js. Modifiez ce fichier pour qu'il reflète les noms de vos packages et de vos images dans les autres dossiers. Ce fichier doit être encodé en UTF-16 LE. Nous vous recommandons d'utiliser un validateur JSON en ligne. Pour vous assurer que le JSON est valide, copiez-le dans un éditeur de texte, puis enregistrez le fichier au format UTF-16 LE.

<a id="ID4ESC" />

##### Exemple de fichier catalog.js commenté pour un scénario à plusieurs jeux

```js theme={null}
{
  "version": "4.1",                                        // Don't adjust this value.
  "bundle": {
    "oneStoreProductId": "9P436MXJ71GV",                   // Replace with your bundle product id.
    "titles": [
      {
        "locale": "default",
        "title": "Bundle Title"                            // Replace with bundle title.
      }
    ],
    "images": [
      {
        "size": "100x100",                                 // Don't change the size values.
        "image": "100x100_1.png"                           // Must match the image file names in MSXC\Metadata\Bundle\
      },
      {
        "size": "208x208",
        "image": "208x208_1.png"
      },
      {
        "size": "480x480",
        "image": "480x480_1.png"
      }
    ]
  },
  "packages": [                                             // This is an array of packages.
    {
      "packageName": "Package1.xvc",                        // Match your package name in MSXC\<package name> and MSXC\Metdata\<package name>
      "oneStoreProductId": "BX38WRFV50MJ",                  // Product id for package 1.
      "contentId": "2b05043b-4043-4ba0-80ed-fd4811c4b333",  // Content id for package 1.  Must match the content id of the package file.
      "franchiseGameHubId": "47445142-3636-3036-C048-464D4E574000", // Optional; Replace with the FranchiseGameHubId. This marks the package as a game hub
      "titleId": "037C3A1D",                                // Title id for package 1.
      "titles": [
        {
          "locale": "default",
          "title": "Killer Instinct"                        // Package 1 title.
        }
      ],
      "images": [
        {
          "size": "100x100",
          "image": "100x100_1.png"                          // Match file names in MSXC\Metadata\<Package1>\
        },
        {
          "size": "208x208",
          "image": "208x208_1.png"
        },
        {
          "size": "480x480",
          "image": "480x480_1.png"
        }
      ],
      "ratings": [
        {
          "system": "OFLC",
          "value": "M"
        },
        {
          "system": "DJCTQ",
          "value": "14"
        },
        {
          "system": "PCBP",
          "value": "Unrated"
        },
        {
          "system": "USK",
          "value": "16"
        },
        {
          "system": "ESRB",
          "value": "T"
        },
        {
          "system": "CERO",
          "value": "Unrated"
        },
        {
          "system": "CSRR",
          "value": "Unrated"
        },
        {
          "system": "COB",
          "value": "M"
        },
        {
          "system": "GRB",
          "value": "Unrated"
        },
        {
          "system": "PEGI",
          "value": "16"
        },
        {
          "system": "PEGIPortugal",
          "value": "Unrated"
        }
      ],
      "type": "Game"
  },
  {
    "packageName": "Package2.xvc",
    "oneStoreProductId": "BVC818MXZ6KG",
    "contentId": "4a6cb1d0-5ad3-47b7-9583-7480098b4a26",
    "associatedFranchiseGameHubId": "47445142-3636-3036-C048-464D4E574000", // Replace with the FranchiseGameHubId of the corresponding franchise game hub that this package is launched with. Optional;
    "titleId": "669E1864",
    "titles": [
      {
        "locale": "default",
        "title": "LocoCycle"
      }
    ],
    "images": [
      {
        "size": "100x100",
        "image": "100x100_1.png"
      },
      {
        "size": "208x208",
        "image": "208x208_1.png"
      },
      {
        "size": "480x480",
        "image": "480x480_1.png"
      }
    ],
    "ratings": [
      {
        "system": "OFLC",
        "value": "PG"
      },
      {
        "system": "DJCTQ",
        "value": "10"
      },
      {
        "system": "USK",
        "value": "12"
      },
      {
        "system": "ESRB",
        "value": "T"
      },
      {
        "system": "PEGI",
        "value": "12"
      },
      {
        "system": "COB",
        "value": "PG"
      }
    ],
    "type": "Game"
    }
  ]
}  
```

<a id="ID4EAD" />

##### Exemple de catalog.js pour un scénario de jeu et de contenu téléchargeable (DLC)

```js theme={null}
{
  "version": "4.0",                                        // Don't adjust this value.
  "bundle": {
    "oneStoreProductId": "9P436MXJ71GV",                   // Replace with bundle product id.
    "launchPackage": "Package3.xvc",                       // Should be the package name of the game package.  This is the package that is launched when the game disc is inserted.
    "titles": [
      {
        "locale": "default",                                        
        "title": "Game + DLC Bundle Title"                 // Replace with bundle name.
      }
    ],
    "images": [
      {
        "size": "100x100",
        "image": "100x100_1.png"                           // Must match the image file names in MSXC\Metadata\Bundle\
      },
      {
        "size": "208x208",
        "image": "208x208_1.png"
      },
      {
        "size": "480x480",
        "image": "480x480_1.png"
      }
    ]
  },
  "packages": [
    {
      "packageName": "Package1.xvc",                       // Match folder name in MSXC\Metadata\<folder name>
      "oneStoreProductId": "BX38WRFV50MJ",                 // Replace with DLC 1 product id.
      "contentId": "ace6ef3b-0c5b-4f17-a651-390e75169d5c", // Replace with DLC 1 content id. This must match the content id of the package file.
      "allowedOneStoreProductIds": [
        "BVC818MXZ6KG"                                     // Should match the product id of the game that will load this DLC.
      ],
      "titles": [
        {
          "locale": "default",
          "title": "DLC Title 1"
        }
      ],
      "images": [
        {
          "size": "100x100",
          "image": "100x100_1.png"                         // Match file names in MSXC\Metadata\Package1.xvc\
        },
        {
          "size": "208x208",
          "image": "208x208_1.png"
        },
        {
          "size": "480x480",
          "image": "480x480_1.png"
        }
      ],
      "ratings": [
        {
          "system": "ESRB",
          "value": "E"
        }
      ],
      "type": "Durable"                                    // Indicates that this is a DLC package.
    },
    {
      "packageName": "Package2.xvc",
      "oneStoreProductId": "9P436MXJ71GV",
      "contentId": "b0f77189-d74c-4005-b351-955d380cb875",
      "allowedOneStoreProductIds": [
        "BVC818MXZ6KG"
      ],
      "titles": [
        {
          "locale": "en-US",
          "title": "DLC Title 2"
        }
      ],
      "images": [
        {
          "size": "100x100",
          "image": "100x100_1.png"
        },
        {
          "size": "208x208",
          "image": "208x208_1.png"
        },
        {
          "size": "480x480",
          "image": "480x480_1.png"
        }
      ],
      "ratings": [
        {
          "system": "ESRB",
          "value": "E"
        }
      ],
      "type": "Durable"
    },
    {
      "packageName": "Package3.xvc",
      "oneStoreProductId": "BVC818MXZ6KG",
      "contentId": "5519355c-bff9-40b4-92bb-b5473fd9c577",
      "titleId": "35c8f637",
      "titles": [
        {
          "locale": "default",
          "title": "Game Title"
        }
      ],
      "images": [
        {
          "size": "100x100",
          "image": "100x100_1.png"
        },
        {
          "size": "208x208",
          "image": "208x208_1.png"
        },
        {
          "size": "480x480",
          "image": "480x480_1.png"
        }
      ],
      "ratings": [
        {
          "system": "ESRB",
          "value": "E"
        }
      ],
      "type": "Game"                                       // Indicates main game package.
    }
  ]
}  
```

<a id="ID4ELD" />

### Ordre d'installation et notifications

Les notifications d'installation de DLC sont généralement déclenchées lorsqu'un package DLC termine son installation. Pour certains types de disques de jeu, ce comportement n'est pas souhaitable, car il générerait un grand nombre de notifications en très peu de temps. Par exemple, une édition Jeu de l'année peut inclure un grand nombre de petits packages DLC sur le disque. Pour gérer cette situation, les notifications de DLC sont déclenchées uniquement lorsque le jeu auquel elles s'appliquent est déjà installé.

Pour les jeux comportant un grand nombre de petits packages DLC, nous recommandons d'ordonner les packages sur le disque de façon que le DLC soit installé avant le jeu. Ainsi, l'utilisateur n'est pas submergé de notifications lors de l'installation des packages DLC.

Pour les jeux comportant un petit nombre de gros packages DLC, nous recommandons d'installer le DLC après le jeu principal afin que l'utilisateur ne soit pas empêché de jouer tant que tous les packages DLC ne sont pas installés.

Pour contrôler l'ordre d'installation du DLC et du jeu, il suffit d'ajuster leur ordre dans le tableau JSON *Packages* de catalog.js. C'est ce tableau qui contrôle l'ordre d'installation par défaut.

<a id="ID4EYD" />

### Déploiement

Pour déployer le disque de compilation, gravez la structure de répertoires sur un disque. Lorsque vous insérez le disque dans une trousse de développement, il démarre exactement comme le ferait une version finale sur une console de vente au détail.

<a id="ID4EBE" />

## Multidisques

Pour créer des multidisques de test, divisez votre XVC existant en deux fichiers.

<Note>Les XVC ne peuvent être divisés qu'aux limites de blocs individuels, telles qu'elles sont définies dans votre fichier Layout.xml. Il peut être impossible de publier, au moyen de la fonctionnalité multidisque, des XVC comportant des blocs extrêmement volumineux (plus de 45 Go). En général, il est préférable que les blocs de votre titre fassent moins de 45 Go.</Note>

Pour diviser un XVC sur deux disques, créez un fichier DiscLayout.xml semblable à l'exemple suivant.

```xml theme={null}
<Packages>
  <Package Name="MultiDisc" Description="Package published on 2 discs" MaxDiscs="2">
  </Package>
</Packages>  
```

Ensuite, appelez SplitPkg pour produire les fichiers individuels qui seront gravés sur disque. Cette opération produit deux fichiers portant le nom de votre fichier XVC original suivi des suffixes « .MultiDisc.1 » et « .MultiDisc.2 ».

```
SplitPkg /f DiscLayout.xml /p sourceXVC /s Multidisc /pd outputDir  
```

Pour simuler une installation à partir de plusieurs disques, utilisez `xbapp install` pour le disque 1 et `xbapp install` pour le disque 2. Une fois le contenu du disque 1 installé, la console vous invite à insérer le disque 2.

<a id="ID4ENF" />

### Catalog.js

Pour graver ces disques de test, créez un fichier Catalog.js contenant les nouveaux champs **discNumber**, **discCount** et **discSetId**. Notez que *chaque* disque a besoin de toutes ces métadonnées. La seule différence entre les fichiers Catalog.js de chaque disque est la valeur du champ **discNumber**. Par exemple, le disque 1 doit avoir la valeur 1, et le disque 2, la valeur 2. Zéro (0) est une valeur réservée qui ne doit pas être utilisée.

<a id="ID4E5F" />

#### Exemple de Catalog.js pour des multidisques

```json theme={null}
{
  "version": "4.0",                                         // Don't adjust this value.
  "discNumber": 1,                                          // 1 for disc 1, 2 for disc 2.
  "discCount": 2,                                           // Same on all discs.
  "discSetId": "00000001",                                  // For test purposes, this can be 00000001. On retail discs, this value is unique for each published disc set. 
                                                            // Don't mix installations of test discs from different sets if they share this value. Cancel your installation before starting a new one.
  "packages": [                                             // This is an array of packages.
    {
      "packageName": "Package1.xvc",                        // Match your package name in MSXC\package-name and MSXC\Metdata\package-name
      "oneStoreProductId": "BX38WRFV50MJ",                  // Product id for package 1.
      "contentId": "2b05043b-4043-4ba0-80ed-fd4811c4b333",  // Content id for package 1. Must match the content id of the package file.
      "titleId": "037C3A1D",                                // Title id for package 1.
      "titles": [
      {
        "locale": "default",
        "title": "Killer Instinct"                          // Package 1 title.
      }
    ],
    "images": [
      {
        "size": "100x100",
        "image": "100x100_1.png"                            // Match file names in MSXC\Metadata\Package1\
      },
      {
        "size": "208x208",
        "image": "208x208_1.png"
      },
      {
        "size": "480x480",
        "image": "480x480_1.png"
      }
    ],
    "ratings": [
      {
        "system": "OFLC",
        "value": "M"
      },
      {
        "system": "DJCTQ",
        "value": "14"
      },
      {
        "system": "PCBP",
        "value": "Unrated"
      },
      {
        "system": "USK",
        "value": "16"
      },
      {
        "system": "ESRB",
        "value": "T"
      },
      {
        "system": "CERO",
        "value": "Unrated"
      },
      {
        "system": "CSRR",
        "value": "Unrated"
      },
      {
        "system": "COB",
        "value": "M"
      },
      {
        "system": "GRB",
        "value": "Unrated"
      },
        {
        "system": "PEGI",
        "value": "16"
      },
      {
        "system": "PEGIPortugal",
        "value": "Unrated"
      }
    ],
      "type": "Game"
    }
  ]
}  
```

## Voir aussi

* [Création de disques de test intergénérationnels](/fr-CA/build/core-features/common/packaging/creating-cross-gen-test-discs)
* [Création de disques](/fr-CA/build/core-features/common/packaging/creating-discs)
* [Fonctionnalité multidisque](/fr-CA/build/core-features/common/packaging/packaging-multi-disc)
* [Hubs de jeux de franchise](https://learn.microsoft.com/build/store/franchise-game-hubs)


## Related topics

- [Étapes de test de validation des supports](/fr-CA/publishing/game-publishing/concepts/certification/certification-media-validation-test-steps.md)
- [Étapes du test de validation des supports](/fr/publishing/game-publishing/concepts/certification/certification-media-validation-test-steps.md)
- [Guide de certification étape par étape](/fr-CA/publishing/game-publishing/concepts/certification/certification-guide.md)
- [Exigences XBOX testées lors de la certification pour les jeux sur console XBOX](/fr/publishing/certification/console-cert-tested-requirements.md)
- [XR-003 Qualité du titre pour la soumission](/fr/publishing/certification/xr/xr-003.md)
