Création de disques de test

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.

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

Compilations
Multidisques

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
Catalog.js
Ordre d’installation et notifications
Déploiement

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.

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.

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

{
  "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"
    }
  ]
}  

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

{
  "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.
    }
  ]
}  

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.

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.

Multidisques

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

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.

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

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

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.

Exemple de Catalog.js pour des multidisques

{
  "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"
    }
  ]
}  

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

Compilations

Créer un disque de compilation de test

Créer une disposition de disque

Catalog.js

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

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

Ordre d’installation et notifications

Déploiement

Multidisques

Catalog.js

Exemple de Catalog.js pour des multidisques

Voir aussi

​Compilations

​Créer un disque de compilation de test

​Créer une disposition de disque

​Catalog.js

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

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

​Ordre d’installation et notifications

​Déploiement

​Multidisques

​Catalog.js

​Exemple de Catalog.js pour des multidisques

​Voir aussi

Compilations

Créer un disque de compilation de test

Créer une disposition de disque

Catalog.js

Ordre d’installation et notifications

Déploiement

Multidisques

Catalog.js

Exemple de Catalog.js pour des multidisques

Voir aussi