É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 faire apparaître 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’a pas à être défini.Plateforme
Cet élément s’applique au 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’. Tous les autres attributs n’ont pas de valeur par défaut.
- Valeurs autorisées :
- L’attribut DefaultDisplayName est une chaîne d’au plus 256 caractères.
- L’attribut PublisherDisplayName est une chaîne d’au plus 256 caractères.
- L’attribut StoreLogo est un chemin d’accès valide vers un fichier .PNG sous la racine du package.
- L’attribut Square150x150Logo est un chemin d’accès valide vers un fichier .PNG sous la racine du package.
- L’attribut Square44x44Logo est un chemin d’accès valide vers un fichier .PNG sous la racine du package.
- Square480x480Logo est un chemin d’accès valide vers un fichier .PNG 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 utilisant un nom courant ou le format de code hexadécimal (#RRGGBB).
- L’attribut SplashScreenImage est un chemin d’accès valide vers un fichier .PNG 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é à titre de pratique exemplaire.
- 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 des 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 a priorité, pour cet exécutable, sur ce qui est défini dans Logo. 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 exécutable précis. En plus de l’attribut OverrideLogo, il existe aussi 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 exécutable précis. L’exemple suivant présente en détail la configuration des éléments et des attributs, spécifiquement pour les remplacements de Logo/DisplayName.OverrideDisplayName et OverrideSplashScreenImage fonctionnent de façon similaire à OverrideLogo.
Exigences relatives aux images
Square150x150Logo, Square44x44Logo et StoreLogo sont requis pour un package non 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, et des exigences s’appliquent au format de pixel (RVB 24 bpp ou ARGB/PARGB 32 bpp). Elles 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, sert à remplacer l’image de l’écran de démarrage qui s’affiche au 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 propre à une plateforme, il est actuellement requis pour le développement sur console XBOX et facultatif pour le développement sur PC.