Elemento de MicrosoftGame.config - ShellVisuals
Define la presencia del título en el shell. Por ejemplo, imágenes y nombres. Se usa durante el registro para mostrar el título en el shell.Elemento primario
El elemento primario de este elemento es el elemento Game.Requisito
Este elemento es opcional y no es obligatorio establecerlo.Plataforma
Este elemento se aplica a PC y consola.Comportamiento
- Los atributos son:
- DefaultDisplayName
- PublisherDisplayName
- StoreLogo
- Square150x150Logo
- Square44x44Logo
- Square480x480Logo
- Description
- ForegroundText
- BackgroundColor
- SplashScreenImage
- El valor predeterminado del atributo ForegroundText es ‘light’. El valor predeterminado del atributo BackgroundColor es ‘transparent’. Todos los demás atributos no tienen valores predeterminados.
- Los valores permitidos para:
- El atributo DefaultDisplayName es una cadena de hasta 256 caracteres.
- El atributo PublisherDisplayName es una cadena de hasta 256 caracteres.
- El atributo StoreLogo es una ruta de archivo válida a un archivo .PNG en la raíz del paquete.
- El atributo Square150x150Logo es una ruta de archivo válida a un archivo .PNG en la raíz del paquete.
- El atributo Square44x44Logo es una ruta de archivo válida a un archivo .PNG en la raíz del paquete.
- Square480x480Logo es una ruta de archivo válida a un archivo .PNG en la raíz del paquete.
- Description es una cadena
- El atributo ForegroundText es light y dark.
- El atributo BackgroundColor es un valor de color que usa un nombre común o el formato de código hexadecimal (#RRGGBB).
- El atributo SplashScreenImage es una ruta de archivo válida a un archivo .PNG en la raíz del paquete.
Comentarios
- Los atributos StoreLogo, Square150x150Logo, Square44x44Logo, Square480x480Logo y SplashScreenImage son todos obligatorios para el empaquetado.
- El atributo SplashScreenImage no es obligatorio para los títulos de PC, pero se recomienda como procedimiento recomendado.
- Todos los demás atributos son opcionales.
- Consulte la sección ST_Color en el esquema de MicrosoftGame.config para ver una lista completa de los nombres comunes de los valores de color.
Logotipos dentro de ShellVisuals y Executable
La relación entre el elemento OverrideLogo dentro de Executable está asociada al elemento Logo en ShellVisuals. Si OverrideLogo está definido, tendrá prioridad, para ese ejecutable, sobre lo que se defina en Logo. Logo dentro de ShellVisuals está pensado para definirse en la capa del paquete. Para un paquete de un solo ejecutable, solo se necesita el elemento Logo. El tamaño del logotipo debe ser de 150x150 píxeles para el atributo Square150x150Logo. El atributo OverrideLogo invalidará el archivo .png designado por Square150x150Logo en ShellVisuals para ese ejecutable específico. Además del atributo OverrideLogo, también hay un atributo para OverrideSquare480x480Logo y Square44x44Logo, que se pueden especificar para invalidar los archivos .png designados por Square480x480Logo y Square44x44Logo, respectivamente, en ShellVisuals para ese ejecutable específico. El siguiente ejemplo detalla la configuración de elementos y atributos específicamente para las invalidaciones de Logo/DisplayName.OverrideDisplayName y OverrideSplashScreenImage funcionan de manera similar a OverrideLogo.
Requisitos de imagen
Square150x150Logo, Square44x44Logo y StoreLogo son obligatorios para un paquete que no sea DLC, tanto en PC como en consola. SplashScreenImage es obligatorio para consola pero ahora, a partir del GDK de febrero de 2021, es opcional para PC. Para los paquetes de DLC, solo StoreLogo es obligatorio.Resolución y formato de imagen
El formato de logotipo requerido es .png, y tiene requisitos en cuanto al formato de píxel (RGB de 24 bpp o ARGB/PARGB de 32 bpp). Estos se aplican mediante SubmissionValidator. Cada imagen tiene una resolución de imagen requerida. Son las siguientes:- Square150x150Logo: 150x150
- Square44x44Logo: 44x44
- Square480x480Logo: 480x480
- StoreLogo: 100x100
- SplashScreenImage: 1920x1080
SplashScreenImage
SplashScreenImage es la imagen que se usa cuando se inicia el título. El atributo OverrideSplashScreenImage, del elemento Executable, se usa para invalidar la imagen de la pantalla de presentación que se muestra al iniciar el título. Esta invalidación ahora permite imágenes de pantalla de presentación específicas de cada ejecutable durante el desarrollo.Aunque el atributo SplashScreenImage no es específico de una plataforma, actualmente es obligatorio para el desarrollo en consola XBOX y opcional para el desarrollo en PC.