Intelligent Delivery: especificadores de dispositivo

Los especificadores de dispositivo declaran las consolas de la familia XBOX One y las consolas XBOX Series a las que se aplica el contenido de un fragmento (chunk) de instalación. Los especificadores de dispositivo le permiten ofrecer las experiencias de mayor fidelidad posibles en una generación de consolas, sin causar descargas innecesarias a los usuarios que no usan la consola de gama más alta de esa generación. En la familia de dispositivos XBOX One, podría marcar determinado contenido, como los gráficos HDR, como fragmentos que solo deben descargarse en dispositivos XBOX One X. Esto permitirá que los usuarios de XBOX One y XBOX One S tengan descargas más eficientes que no incluyan recursos HDR no compatibles con esos dispositivos. Parte del contenido será común a ambas consolas. Por ejemplo, los recursos de audio podrían ser idénticos para cualquier dispositivo en el que se ejecute el título. Los fragmentos que contienen esos recursos no tendrán un especificador de dispositivo. Los especificadores de dispositivo habilitan los escenarios siguientes.

Al publicar títulos nuevos para dispositivos de toda la familia de consolas XBOX, puede declarar qué contenido solo es necesario en los dispositivos de gama alta de la familia de consolas. El contenido sin especificador de dispositivo se instala en todas las consolas. Para obtener más información, consulte la sección Diseño de empaquetado para títulos nuevos.
Al agregar fragmentos nuevos con los recursos de mayor fidelidad, puede actualizar un título existente para admitir la resolución más alta en dispositivos XBOX One X o XBOX Series X. Si marca estos fragmentos nuevos con el especificador de dispositivo correcto, los jugadores que ya tienen su título instalado en consolas XBOX One, XBOX One S o XBOX Series S no se ven afectados negativamente. Para obtener más información, consulte la sección sobre especificar recursos solo para dispositivos XBOX One X o Anaconda.

Diseño de empaquetado para títulos nuevos que se ejecutan en varios dispositivos de la misma generación con recursos especializados por dispositivo

Los títulos nuevos que se publican simultáneamente para dispositivos XBOX One, XBOX One S y XBOX One X, o en dispositivos XBOX Series S y XBOX Series X, pueden usar Intelligent Delivery para dirigir contenido específico a tipos de dispositivo específicos. Hay dos estrategias generales para dirigir los recursos.

Ajustar contenido específico para cada clase de dispositivo

Una estrategia para dirigir recursos a distintos dispositivos consiste en ajustar contenido específico para cada dispositivo dentro de la misma generación. En este escenario, su título empaqueta los recursos específicos de cada dispositivo en fragmentos dirigidos a un dispositivo específico.

Los nombres de archivo y las rutas de acceso no pueden duplicarse en fragmentos diferentes, aunque solo se instale a la vez uno de los fragmentos que contienen los duplicados. Se recomienda agrupar los archivos en fragmentos según el nombre de la carpeta, por ejemplo agrupando todos los recursos de mayor resolución en una carpeta específica, o modificar los nombres de archivo de forma que su título pueda distinguirlos, por ejemplo anexando “_sco” o “_ana” al nombre de archivo.

Los siguientes segmentos de ejemplo de un archivo layout.xml declaran dos fragmentos dirigidos a dispositivos diferentes. En el momento de la instalación, el sistema determina si se instala el fragmento 2001 o el fragmento 2002, según el tipo de dispositivo de hardware. Para la generación XBOX One:

<Chunk Id="2001" Devices="Xbox-Durango">
    <FileGroup DestinationPath="\Data\Maps\XboxOneOnly\LightMaps"             SourcePath="Y:\Maps\Level1\XboxOneOnly\LightMaps" Include="*.map"/>
<Chunk>
<Chunk Id="2002" Devices="Xbox-Scorpio">
    <FileGroup DestinationPath="\Data\Maps\Scorpio\HiResLightMaps"             SourcePath="Y:\Maps\Level1\Scorpio\HiResLightMaps" Include="*.map"/>
<Chunk>  

Para dispositivos Lockhart y Anaconda:

<Chunk Id="2001" Devices="Xbox-Lockhart">
    <FileGroup DestinationPath="\Data\Maps\LockhartOnly\LightMaps"             SourcePath="Y:\Maps\Level1\LockhartOnly\LightMaps" Include="*.map"/>
<Chunk>
<Chunk Id="2002" Devices="Xbox-Anaconda">
    <FileGroup DestinationPath="\Data\Maps\Anaconda\HiResLightMaps"             SourcePath="Y:\Maps\Level1\Anaconda\HiResLightMaps" Include="*.map"/>
<Chunk>  

Obtención del tipo de dispositivo

En tiempo de ejecución, haga que su título use el método XSystemGetDeviceType para determinar en qué dispositivo se está ejecutando el título, y debe usar el conjunto de recursos adecuado según esa información.

#include <XSystem.h>

XSystemDeviceType deviceType = XSystemGetDeviceType();

switch (deviceType)
{
case XSystemDeviceType::Pc:                     ... break;
case XSystemDeviceType::XboxOne:                ... break;   //Xbox-Durango device specifier tag
case XSystemDeviceType::XboxOneS:               ... break;   //Xbox-Durango device specifier tag
case XSystemDeviceType::XboxOneX:               ... break;   //Xbox-Scorpio device specifier tag
case XSystemDeviceType::XboxOneXDevkit:         ... break;
case XSystemDeviceType::XboxScarlettLockhart:   ... break;   //Xbox-Lockhart device specifier tag
case XSystemDeviceType::XboxScarlettAnaconda:   ... break;   //Xbox-Anaconda device specifier tag
case XSystemDeviceType::XboxScarlettDevkit:     ... break;
case XSystemDeviceType::Unknown:                ... break;
}

Los valores de XSystemGetDeviceType para las consolas comerciales corresponden a las etiquetas de especificador de dispositivo que usará en el archivo layout.xml. Tenga en cuenta que Xbox-Durango es la etiqueta de especificador de dispositivo tanto para XBOX One como para XBOX One S.

Etiqueta de especificador de dispositivo	XSystemDeviceType
`Xbox-Durango`	XBOX One XBOX One S
`Xbox-Scorpio`	XBOX One X
`Xbox-Lockhart`	XBOX Series S
`Xbox-Anaconda`	XBOX Series X

Las etiquetas de especificador de dispositivo son los valores que usará en el archivo layout.xml.

Declaración de recursos específicos de XBOX One X o de Anaconda

La segunda estrategia para dirigirse a dispositivos específicos consiste en declarar recursos adicionales que solo se instalan en un dispositivo de consola específico dentro de una generación. En este escenario, todos los recursos comunes a ambas consolas se colocan en fragmentos sin especificadores de dispositivo. Los recursos específicos de XBOX One X o de Anaconda se colocan en su propio fragmento.

Especificación de recursos solo para dispositivos XBOX One X o Anaconda

Para agregar a su título recursos específicos de un dispositivo, identifique los recursos aplicables solo a ese dispositivo, aíslelos en fragmentos nuevos en el archivo layout.xml y, a continuación, aplíqueles el especificador de dispositivo Xbox-Durango o Xbox-Anaconda. Esto se muestra en los ejemplos siguientes. Generación XBOX One

<Chunk Id="2002" Devices="Xbox-Scorpio">
    <FileGroup DestinationPath="\Data\Maps\Scorpio\HiResLightMaps"             SourcePath="Y:\Maps\Level1\Scorpio\HiResLightMaps" Include="*.dat"/>
<Chunk>  

Generación XBOX Series X|S

<Chunk Id="2002" Devices="Xbox-Anaconda">
    <FileGroup DestinationPath="\Data\Maps\Anaconda\HiResLightMaps"             SourcePath="Y:\Maps\Level1\Anaconda\HiResLightMaps" Include="*.dat"/>
<Chunk>  

Consulte también

Intelligent Delivery XSystemGetDeviceType

GDK and Game Engines Integration

Steam porting guide

Game Principles

Core Features

Console Features

Diseño de empaquetado para títulos nuevos que se ejecutan en varios dispositivos de la misma generación con recursos especializados por dispositivo

Ajustar contenido específico para cada clase de dispositivo

Obtención del tipo de dispositivo

Declaración de recursos específicos de XBOX One X o de Anaconda

Especificación de recursos solo para dispositivos XBOX One X o Anaconda

Consulte también

​Diseño de empaquetado para títulos nuevos que se ejecutan en varios dispositivos de la misma generación con recursos especializados por dispositivo

​Ajustar contenido específico para cada clase de dispositivo

​Obtención del tipo de dispositivo

​Declaración de recursos específicos de XBOX One X o de Anaconda

​Especificación de recursos solo para dispositivos XBOX One X o Anaconda

​Consulte también

Diseño de empaquetado para títulos nuevos que se ejecutan en varios dispositivos de la misma generación con recursos especializados por dispositivo

Ajustar contenido específico para cada clase de dispositivo

Obtención del tipo de dispositivo

Declaración de recursos específicos de XBOX One X o de Anaconda

Especificación de recursos solo para dispositivos XBOX One X o Anaconda

Consulte también