Intelligent Delivery: especificadores de dispositivo

Os especificadores de dispositivo declaram os consoles da família XBOX One e os consoles XBOX Series aos quais o conteúdo de um bloco de instalação se aplica. Os especificadores de dispositivo permitem que você ofereça as experiências de maior fidelidade possíveis em uma geração de consoles, sem causar downloads desnecessários para usuários que não estão usando o console mais avançado dessa geração. Na família de dispositivos XBOX One, você pode marcar alguns conteúdos, como gráficos HDR, como blocos que só precisam ser baixados em dispositivos XBOX One X. Isso permitirá que os usuários do XBOX One e do XBOX One S tenham downloads mais eficientes, que não incluem ativos HDR sem suporte nesses dispositivos. Alguns conteúdos serão comuns a ambos os consoles. Por exemplo, os ativos de áudio podem ser idênticos para qualquer dispositivo no qual o título esteja sendo executado. Os blocos que contêm esses ativos não terão um especificador de dispositivo. Os especificadores de dispositivo permitem os cenários a seguir.

Ao lançar novos títulos para dispositivos de toda a família de consoles XBOX, você pode declarar qual conteúdo é necessário apenas nos dispositivos mais avançados da família de consoles. O conteúdo sem especificador de dispositivo é instalado em todos os consoles. Para obter mais informações, consulte a seção Design de empacotamento para novos títulos.
Ao adicionar novos blocos com os ativos de maior fidelidade, você pode atualizar um título existente para dar suporte à resolução mais alta em dispositivos XBOX One X ou XBOX Series X. Se você marcar esses novos blocos com o especificador de dispositivo correto, os jogadores que já têm seu título instalado em consoles XBOX One, XBOX One S ou XBOX Series S não serão afetados negativamente. Para obter mais informações, consulte a seção sobre especificação de ativos somente para dispositivos XBOX One X ou Anaconda.

Design de empacotamento para novos títulos executados em vários dispositivos da mesma geração com ativos especializados por dispositivo

Novos títulos lançados simultaneamente para dispositivos XBOX One, XBOX One S e XBOX One X, ou para dispositivos XBOX Series S e XBOX Series X, podem usar o Intelligent Delivery para direcionar conteúdo específico a tipos específicos de dispositivo. Há duas estratégias gerais para direcionar ativos.

Ajustar conteúdo específico para cada classe de dispositivo

Uma estratégia para direcionar ativos a diferentes dispositivos é ajustar conteúdo específico para cada dispositivo dentro da mesma geração. Nesse cenário, seu título empacota ativos específicos de dispositivo em blocos direcionados a um dispositivo específico.

Nomes de arquivos e caminhos não podem ser duplicados em blocos diferentes, mesmo que apenas um dos blocos que contêm as duplicatas seja instalado por vez. Recomendamos que você agrupe seus arquivos em blocos de acordo com o nome da pasta, por exemplo, agrupando todos os ativos de resolução mais alta em uma pasta específica, ou que modifique os nomes dos arquivos de forma que permita ao seu título diferenciá-los, por exemplo, acrescentando “_sco” ou “_ana” ao nome do arquivo.

Os segmentos de exemplo a seguir de um arquivo layout.xml declaram dois blocos direcionados a dispositivos diferentes. No momento da instalação, o sistema determina se deve instalar o bloco 2001 ou o bloco 2002, de acordo com o tipo de dispositivo de hardware. Para a geração 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 e 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>  

Obter o tipo de dispositivo

Em tempo de execução, faça com que seu título use o método XSystemGetDeviceType para determinar em qual dispositivo o título está sendo executado; ele precisa usar o conjunto de ativos apropriado com base nessas informações.

#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;
}

Os valores de XSystemGetDeviceType para consoles de varejo correspondem às marcas de especificador de dispositivo que você usará no seu arquivo layout.xml. Observe que Xbox-Durango é a marca de especificador de dispositivo tanto para o XBOX One quanto para o XBOX One S.

Marca 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

As marcas de especificador de dispositivo são os valores que você usará no arquivo layout.xml.

Declarar ativos específicos do XBOX One X ou do Anaconda

A segunda estratégia para direcionar dispositivos específicos é declarar ativos adicionais que são instalados apenas em um dispositivo de console específico dentro de uma geração. Nesse cenário, todos os ativos comuns a ambos os consoles são colocados em blocos sem especificadores de dispositivo. Os ativos específicos do XBOX One X ou do Anaconda são colocados em seu próprio bloco.

Especificar ativos somente para dispositivos XBOX One X ou Anaconda

Para adicionar ao seu título ativos específicos de um dispositivo, identifique os ativos aplicáveis somente a esse dispositivo, isole-os em novos blocos no seu arquivo layout.xml e, em seguida, aplique a eles o especificador de dispositivo Xbox-Durango ou Xbox-Anaconda. Isso é mostrado nos exemplos a seguir. Geração XBOX One

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

Geração 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>  

Confira também

Intelligent Delivery XSystemGetDeviceType

Porting

Build Paths

Design de empacotamento para novos títulos executados em vários dispositivos da mesma geração com ativos especializados por dispositivo

Ajustar conteúdo específico para cada classe de dispositivo

Obter o tipo de dispositivo

Declarar ativos específicos do XBOX One X ou do Anaconda

Especificar ativos somente para dispositivos XBOX One X ou Anaconda

Confira também

​Design de empacotamento para novos títulos executados em vários dispositivos da mesma geração com ativos especializados por dispositivo

​Ajustar conteúdo específico para cada classe de dispositivo

​Obter o tipo de dispositivo

​Declarar ativos específicos do XBOX One X ou do Anaconda

​Especificar ativos somente para dispositivos XBOX One X ou Anaconda

​Confira também

Design de empacotamento para novos títulos executados em vários dispositivos da mesma geração com ativos especializados por dispositivo

Ajustar conteúdo específico para cada classe de dispositivo

Obter o tipo de dispositivo

Declarar ativos específicos do XBOX One X ou do Anaconda

Especificar ativos somente para dispositivos XBOX One X ou Anaconda

Confira também