Intelligent Delivery : spécificateurs d'appareil

Les spécificateurs d’appareil déclarent les consoles de la famille XBOX One et les consoles XBOX Series auxquelles s’applique le contenu d’un bloc d’installation. Les spécificateurs d’appareil vous permettent d’offrir les expériences de la plus haute fidélité possible sur une génération de consoles, sans provoquer de téléchargements inutiles pour les utilisateurs qui n’utilisent pas la console haut de gamme de cette génération. Dans la famille d’appareils XBOX One, vous pourriez marquer certains contenus, comme les graphiques HDR, en tant que blocs qui doivent être téléchargés uniquement sur les appareils XBOX One X. Cela permettra aux utilisateurs de XBOX One et de XBOX One S de bénéficier de téléchargements plus efficaces qui n’incluent pas les ressources HDR non prises en charge par ces appareils. Certains contenus seront communs aux deux consoles. Par exemple, les ressources audio peuvent être identiques pour tout appareil sur lequel le titre s’exécute. Les blocs contenant ces ressources n’auront pas de spécificateur d’appareil. Les spécificateurs d’appareil permettent les scénarios suivants.

Lorsque vous publiez de nouveaux titres pour des appareils de toute la famille de consoles XBOX, vous pouvez déclarer quel contenu est nécessaire uniquement sur les appareils haut de gamme de la famille de consoles. Le contenu sans spécificateur d’appareil est installé sur toutes les consoles. Pour plus d’information, consultez la section Conception de l’empaquetage pour les nouveaux titres.
En ajoutant de nouveaux blocs contenant les ressources de plus haute fidélité, vous pouvez mettre à jour un titre existant pour prendre en charge la résolution supérieure sur les appareils XBOX One X ou XBOX Series X. Si vous marquez ces nouveaux blocs avec le bon spécificateur d’appareil, les joueurs qui ont déjà installé votre titre sur des consoles XBOX One, XBOX One S ou XBOX Series S ne sont pas défavorisés. Pour plus d’information, consultez la section sur la spécification de ressources uniquement pour les appareils XBOX One X ou Anaconda.

Conception de l’empaquetage pour les nouveaux titres qui s’exécutent sur plusieurs appareils de la même génération avec des ressources spécialisées par appareil

Les nouveaux titres publiés simultanément pour les appareils XBOX One, XBOX One S et XBOX One X, ou sur les appareils XBOX Series S et XBOX Series X, peuvent utiliser Intelligent Delivery pour cibler des types d’appareils précis avec un contenu précis. Il existe deux stratégies générales pour cibler les ressources.

Adapter un contenu précis à chaque classe d’appareil

Une stratégie pour cibler des ressources pour différents appareils consiste à adapter un contenu précis à chaque appareil d’une même génération. Dans ce scénario, votre titre empaquette les ressources propres à chaque appareil dans des blocs qui ciblent un appareil précis.

Les noms et chemins de fichiers ne peuvent pas être dupliqués entre différents blocs, même si un seul des blocs contenant les doublons est installé à la fois. Nous vous recommandons soit de regrouper vos fichiers en blocs selon le nom du dossier, par exemple en regroupant toutes les ressources à plus haute résolution dans un dossier précis, soit de modifier les noms de fichiers de façon à permettre à votre titre de les distinguer, par exemple en ajoutant « _sco » ou « _ana » au nom du fichier.

Les segments d’exemple suivants d’un fichier layout.xml déclarent deux blocs qui ciblent des appareils différents. Au moment de l’installation, le système détermine s’il faut installer le bloc 2001 ou le bloc 2002, selon le type d’appareil matériel. Pour la génération 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>  

Pour les appareils Lockhart et 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>  

Obtenir le type d’appareil

Au moment de l’exécution, faites en sorte que votre titre utilise la méthode XSystemGetDeviceType pour déterminer l’appareil sur lequel il s’exécute; il doit ensuite utiliser l’ensemble de ressources approprié en fonction de cette information.

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

Les valeurs de XSystemGetDeviceType pour les consoles commerciales correspondent aux balises de spécificateur d’appareil que vous utiliserez dans votre fichier layout.xml. Notez que Xbox-Durango est la balise de spécificateur d’appareil à la fois pour la XBOX One et la XBOX One S.

Balise de spécificateur d’appareil	XSystemDeviceType
`Xbox-Durango`	XBOX One XBOX One S
`Xbox-Scorpio`	XBOX One X
`Xbox-Lockhart`	XBOX Series S
`Xbox-Anaconda`	XBOX Series X

Les balises de spécificateur d’appareil sont les valeurs que vous utiliserez dans le fichier layout.xml.

Déclarer des ressources propres à la XBOX One X ou à Anaconda

La deuxième stratégie pour cibler des appareils précis consiste à déclarer des ressources supplémentaires qui s’installent uniquement sur un appareil de console précis au sein d’une génération. Dans ce scénario, toutes les ressources communes aux deux consoles sont placées dans des blocs sans spécificateur d’appareil. Les ressources propres à la XBOX One X ou à Anaconda sont placées dans leur propre bloc.

Spécifier des ressources uniquement pour les appareils XBOX One X ou Anaconda

Pour ajouter à votre titre des ressources propres à un appareil, repérez les ressources applicables uniquement à cet appareil, isolez-les dans de nouveaux blocs dans votre fichier layout.xml, puis appliquez-leur le spécificateur d’appareil Xbox-Durango ou Xbox-Anaconda. C’est ce que montrent les exemples suivants. Génération XBOX One

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

Génération 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>  

Voir aussi

Intelligent Delivery XSystemGetDeviceType

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

Conception de l’empaquetage pour les nouveaux titres qui s’exécutent sur plusieurs appareils de la même génération avec des ressources spécialisées par appareil

Adapter un contenu précis à chaque classe d’appareil

Obtenir le type d’appareil

Déclarer des ressources propres à la XBOX One X ou à Anaconda

Spécifier des ressources uniquement pour les appareils XBOX One X ou Anaconda

Voir aussi

​Conception de l’empaquetage pour les nouveaux titres qui s’exécutent sur plusieurs appareils de la même génération avec des ressources spécialisées par appareil

​Adapter un contenu précis à chaque classe d’appareil

​Obtenir le type d’appareil

​Déclarer des ressources propres à la XBOX One X ou à Anaconda

​Spécifier des ressources uniquement pour les appareils XBOX One X ou Anaconda

​Voir aussi

Conception de l’empaquetage pour les nouveaux titres qui s’exécutent sur plusieurs appareils de la même génération avec des ressources spécialisées par appareil

Adapter un contenu précis à chaque classe d’appareil

Obtenir le type d’appareil

Déclarer des ressources propres à la XBOX One X ou à Anaconda

Spécifier des ressources uniquement pour les appareils XBOX One X ou Anaconda

Voir aussi