Élément MicrosoftGame.config - ShellVisuals
Définit la présence du titre dans le Shell, par exemple les images et les noms. Utilisé lors de l’inscription pour afficher le titre dans le Shell.Parent
Le parent de cet élément est l’élément Game.Exigence
Cet élément est facultatif et n’est pas obligatoire.Plateforme
Cet élément concerne le PC et la console.Comportement
- Les attributs sont :
- DefaultDisplayName
- PublisherDisplayName
- StoreLogo
- Square150x150Logo
- Square44x44Logo
- Square480x480Logo
- Description
- ForegroundText
- BackgroundColor
- SplashScreenImage
- La valeur par défaut de l’attribut ForegroundText est ‘light’. La valeur par défaut de l’attribut BackgroundColor est ‘transparent’. Les autres attributs n’ont pas de valeur par défaut.
- Valeurs autorisées :
- L’attribut DefaultDisplayName est une chaîne de 256 caractères maximum.
- L’attribut PublisherDisplayName est une chaîne de 256 caractères maximum.
- L’attribut StoreLogo est un chemin d’accès valide vers un fichier .PNG situé sous la racine du package.
- L’attribut Square150x150Logo est un chemin d’accès valide vers un fichier .PNG situé sous la racine du package.
- L’attribut Square44x44Logo est un chemin d’accès valide vers un fichier .PNG situé sous la racine du package.
- Square480x480Logo est un chemin d’accès valide vers un fichier .PNG situé sous la racine du package.
- Description est une chaîne
- L’attribut ForegroundText est light ou dark.
- L’attribut BackgroundColor est une valeur de couleur au format nom courant ou code hexadécimal (#RRGGBB).
- L’attribut SplashScreenImage est un chemin d’accès valide vers un fichier .PNG situé sous la racine du package.
Remarques
- Les attributs StoreLogo, Square150x150Logo, Square44x44Logo, Square480x480Logo et SplashScreenImage sont tous requis pour l’empaquetage.
- L’attribut SplashScreenImage n’est pas requis pour les titres PC, mais il est recommandé comme bonne pratique.
- Tous les autres attributs sont facultatifs.
- Consultez la section ST_Color du schéma MicrosoftGame.config pour obtenir la liste complète des noms courants de valeurs de couleur.
Logos dans ShellVisuals et Executable
L’élément OverrideLogo dans Executable est associé à l’élément Logo dans ShellVisuals. Si OverrideLogo est défini, il est prioritaire, pour cet exécutable, sur ce qui est défini dans Logo. L’élément Logo dans ShellVisuals est destiné à être défini au niveau du package. Pour un package à exécutable unique, seul l’élément Logo est nécessaire. La taille du logo doit être de 150x150 pixels pour l’attribut Square150x150Logo. L’attribut OverrideLogo remplace le fichier .png désigné par Square150x150Logo dans ShellVisuals pour cet Executable spécifique. En plus de l’attribut OverrideLogo, il existe également des attributs OverrideSquare480x480Logo et Square44x44Logo, qui peuvent être spécifiés pour remplacer respectivement les fichiers .png désignés par Square480x480Logo et Square44x44Logo dans ShellVisuals pour cet Executable spécifique. L’exemple suivant détaille la configuration des éléments et attributs spécifiquement pour les remplacements de Logo/DisplayName.OverrideDisplayName et OverrideSplashScreenImage fonctionnent de la même manière qu’OverrideLogo.
Exigences relatives aux images
Square150x150Logo, Square44x44Logo et StoreLogo sont requis pour un package autre que DLC, sur PC comme sur console. SplashScreenImage est requis pour la console, mais il est désormais facultatif pour le PC depuis le GDK de février 2021. Pour les packages DLC, seul StoreLogo est requis.Résolution et format des images
Le format de logo requis est .png, avec des exigences relatives au format de pixel (RVB 24 bpp ou ARGB/PARGB 32 bpp). Celles-ci sont appliquées par SubmissionValidator. Chaque image a une résolution requise. Les voici :- Square150x150Logo : 150x150
- Square44x44Logo : 44x44
- Square480x480Logo : 480x480
- StoreLogo : 100x100
- SplashScreenImage : 1920x1080
SplashScreenImage
SplashScreenImage est l’image utilisée lors du lancement de votre titre. L’attribut OverrideSplashScreenImage, de l’élément Executable, permet de remplacer l’image de l’écran de démarrage qui s’affiche lors du lancement de votre titre. Ce remplacement permet désormais d’utiliser des images d’écran de démarrage propres à chaque exécutable pendant le développement.Bien que l’attribut SplashScreenImage ne soit pas spécifique à une plateforme, il est actuellement requis pour le développement sur console XBOX et facultatif pour le développement sur PC.