Información general de los discos de prueba entre generaciones

Use este tema para crear discos de prueba entre generaciones, de modo que pueda probar su título en las consolas de la familia XBOX One y en las consolas XBOX Series.

Estas instrucciones son solo para fines de prueba. En los escenarios comerciales, estos datos se configuran automáticamente según los metadatos que se encuentran en Partner Center. Las opciones seleccionadas en el flujo de creación de discos de compilación se usan para controlar configuraciones como el orden de instalación y la reproducción automática (AutoPlay). No debe enviar los metadatos de prueba ni los archivos de configuración JSON a Microsoft cuando envíe sus juegos para su incorporación.

Puede crear los siguientes tipos de discos de prueba.

Discos de Smart Delivery
Discos multiproducto

Creación de discos de Smart Delivery

Los discos de Smart Delivery contienen un paquete para las consolas de la familia XBOX One y las consolas XBOX Series. Los paquetes tienen una licencia que funciona para ambos paquetes. Forman parte del mismo producto en Partner Center. Cuando se inserta en una consola, se instala el paquete adecuado para el tipo de consola. La instalación incluye el inicio de cualquier actualización de contenido aplicable, si está disponible.

Si quiere crear un paquete para su juego por generación de consola, usando productos independientes de Partner Center en un disco, esto se denomina disco multiproducto. Para obtener más información, consulte la sección Discos multiproducto de este tema.

Creación y prueba de discos de Smart Delivery

Para crear y probar un disco de Smart Delivery, cree un archivo de metadatos catalog.js y un diseño de disco tal como se describe en las secciones siguientes de este tema.

Creación de un diseño de disco
Catalog.js

Creación de un diseño de disco

Cree un diseño de disco similar al del ejemplo siguiente.

- Disc Root
    - Licenses (folder) - (Not needed for Xbox One ERA Development Kits. Use XVCs that are created with the /LT flag or /LK flag.)
        License0.xml (file) - (Not needed for Xbox One ERA dev kits. Use XVCs that are created with the /LT or /LK flag.)
    - MSXC (folder)
        - Package_x.xvc (file)
        - Package_xs.xvc (file)
        - Metadata (folder)
            - catalog.js (file)
            - Package_x.xvc (folder)
                - Package images (files)
            

Package_x.xvc y Package_xs.xvc son los paquetes por generación de consola. La herramienta MakePkg agregará como sufijo del paquete _x para los paquetes de XBOX One o _xs para los paquetes de la generación XBOX Series X|S. Uno de estos paquetes se declara como una “variante” del otro paquete en el archivo catalog.js. En el ejemplo anterior, Package_xs.xvc es una variante de Package_x.xvc. Los directorios tienen el contenido siguiente.

Licenses contiene los archivos de licencia de los juegos. Esta información no es necesaria para los kits de desarrollo de XBOX One ERA. Use XVC creados con la marca /LT o /LK. Después, se pueden omitir.

Si usa un paquete creado con la marca /LK, deberá usar xbapp installkey para instalar el archivo CEKB en la consola de destino. Esto permitirá el descifrado del paquete /LK del disco. Consulte xbapp.exe (tema de NDA) para obtener más detalles.

MSXC contiene los juegos empaquetados y los metadatos que usa el shell de XBOX.
Metadata contiene los metadatos que el shell usa para los juegos del disco y para los paquetes de juego.
Package_x.xvc contiene las imágenes que el shell usa para el juego. El nombre debe coincidir con el archivo del paquete del juego que está en MSXC. No es necesario proporcionar imágenes para los paquetes que son variantes de otros paquetes.

Catalog.js

En la carpeta Metadata, cree un archivo llamado catalog.js. Edite este archivo para reflejar los nombres de sus paquetes e imágenes que están en las otras carpetas.

Este archivo debe estar codificado en UTF-8. Se recomienda usar un validador de JSON en la web. Para asegurarse de que el JSON esté validado, cópielo en un editor de texto y, a continuación, guarde el archivo en formato UTF-8.

Ejemplo de un producto de Smart Delivery

El siguiente es un ejemplo de un archivo catalog.js de un único producto que usa Smart Delivery, con comentarios insertados.

{
    "version": "4.0",                                               // Don't adjust this value.
    "packages": [                                                   // This is an array of packages.
    {
        "packageName": "Package_x.xvc",                             // Match your package name in MSXC\<package name> to the package name in MSXC\Metadata\<package name>.
        "generation": "8",                                        // Enter "8" for Xbox One packages, or enter "9" for Xbox Series X&#124;S generation packages.
        "oneStoreProductId": "BX38WRFV50MJ",                        // Partner Center Product ID for the package.
        "contentId": "2b05043b-4043-4ba0-80ed-fd4811c4b333",        // Content ID for your package. Match this to the Content ID of the package file.
        "titleId": "037C3A1D",                                      // Title ID for your package.
        "variants" : [
            {
                "generation": "9",                                  // The console generation for this variant of the package. Enter "8" for Xbox One packages, or enter "9" for Xbox Series X&#124;S generation packages.
                "packageName": "Package_xs.xvc"                     // The package name for this variant. All packages must have the same Content ID or Product ID.
            }
        ],
        "titles": [
          {
              "locale": "default",
              "title": "Killer Instinct"                            // Package title.
          }
        ],
        "images": [
          {
              "size": "100x100",
              "image": "100x100_1.png"                              // Match the file names to MSXC\Metadata\<Package_x>\.
          },
          {
              "size": "208x208",
              "image": "208x208_1.png"
          },
          {
              "size": "480x480",
              "image": "480x480_1.png"
          }
        ],
        "ratings": [                                                // This ratings information is only for example purposes.
          {                                                         // This is automatically generated for your discs
              "system": "OFLC",                                     // by using the information that's published in Partner Center.
              "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"
    }
  ]
}  

Discos multiproducto

Los discos multiproducto contienen un paquete para las consolas XBOX One y XBOX Series X|S. Los discos contienen una licencia para cada paquete. Estos paquetes proceden de productos independientes que están en Partner Center. Tienen una relación generacional explícita que se configura en Partner Center. Solo uno de los paquetes se instala de forma predeterminada cuando se venden como un paquete digital o cuando se instalan en una consola mediante el disco. Cuando el disco se inserta en una consola, se instala el paquete adecuado para el tipo de consola. Esto incluye el inicio de cualquier actualización de contenido aplicable, si está disponible.

Si quiere crear un paquete por generación de consola usando un único producto de Partner Center, esto se denomina disco de Smart Delivery entre generaciones. Para obtener más información, consulte la sección Smart Delivery de este tema.

Ejemplo de un disco multiproducto

El siguiente es un ejemplo de un archivo catalog.js de un disco multiproducto con comentarios insertados.

{
  "version": "4.0",                                                 // Don't change this value.
  "bundle": {
    "oneStoreProductId": "9P436MXJ71GV",                            // Replace with the game bundle Product ID.
    "launchPackage": "Package1_x.xvc",                              // This is the package that is launched when the game disc is inserted into the console.
    "titles": [
      {
        "locale": "default",                                        
        "title": "Game Title"                                       // Replace with the game bundle name.
      }
    ],
    "images": [
      {
        "size": "100x100",
        "image": "100x100_1.png"                                    // Match this to the image file names that are in MSXC\Metadata\Bundle\.
      },
      {
        "size": "208x208",
        "image": "208x208_1.png"
      },
      {
        "size": "480x480",
        "image": "480x480_1.png"
      }
    ]
  },
  "siblings": [                                                     // The sibling entry that sets these two packages as
    [                                                               // related. The correct package for the console
      "Package1_x.xvc",                                             // type is chosen.
      "Package2_xs.xvc"                                             // Note: the sibling relationships are an array
    ]                                                               // of arrays.
  ],
  "packages": [
    {
      "packageName": "Package1_x.xvc",                              // Match this to the folder name that's in MSXC\Metadata\<folder name>.
      "generation": "8",                                            // Xbox One family generation that's used for Xbox One and Xbox Series X&#124;S consoles.
      "oneStoreProductId": "BX38WRFV50MJ",                          // Replace with Package 1 Product ID.
      "contentId": "ace6ef3b-0c5b-4f17-a651-390e75169d5c",          // Replace with Package 1 Content ID. Match the ID to the Content ID of the package file.
      "titles": [
        {
          "locale": "default",
          "title": "Game Title Xbox One Edition"
        }
      ],
      "images": [
        {
          "size": "100x100",
          "image": "100x100_1.png"                                  // Match file names that are in MSXC\Metadata\Package1_x.xvc\.
        },
        {
          "size": "208x208",
          "image": "208x208_1.png"
        },
        {
          "size": "480x480",
          "image": "480x480_1.png"
        }
      ],
      "ratings": [
        {
          "system": "ESRB",
          "value": "E"
        }
      ],
      "type": "Game"
    },
    {
      "packageName": "Package2_xs.xvc",
      "generation": "9",
      "oneStoreProductId": "BVC818MXZ6KG",
      "contentId": "5519355c-bff9-40b4-92bb-b5473fd9c577",
      "titleId": "35c8f637",
      "titles": [
        {
          "locale": "default",
          "title": "Game Title Xbox Series generation edition"
        }
      ],
      "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"
    }
  ]
}  

Consulte también

Creación de discos Creación de discos de prueba Funcionalidad multidisco

GDK and Game Engines Integration

Steam porting guide

Game Principles

Core Features

Console Features

Información general de los discos de prueba entre generaciones

Creación de discos de Smart Delivery

Creación y prueba de discos de Smart Delivery

Creación de un diseño de disco

Catalog.js

Ejemplo de un producto de Smart Delivery

Discos multiproducto

Ejemplo de un disco multiproducto

Consulte también

​Creación de discos de Smart Delivery

​Creación y prueba de discos de Smart Delivery

​Creación de un diseño de disco

​Catalog.js

​Ejemplo de un producto de Smart Delivery

​Discos multiproducto

​Ejemplo de un disco multiproducto

​Consulte también

Creación de discos de Smart Delivery

Creación y prueba de discos de Smart Delivery

Creación de un diseño de disco

Catalog.js

Ejemplo de un producto de Smart Delivery

Discos multiproducto

Ejemplo de un disco multiproducto

Consulte también