Skip to main content

Elemento do MicrosoftGame.config - ShellVisuals

Define a presença do título no Shell. Por exemplo, Imagens e Nomes. Usado durante o registro para exibir o título no Shell.

Pai

O pai deste elemento é o elemento Game.

Requisito

Este elemento é opcional e não é obrigatório defini-lo.

Plataforma

Este elemento se aplica a PC e console.

Comportamento

  • Os atributos são:
    • DefaultDisplayName
    • PublisherDisplayName
    • StoreLogo
    • Square150x150Logo
    • Square44x44Logo
    • Square480x480Logo
    • Description
    • ForegroundText
    • BackgroundColor
    • SplashScreenImage
  • O valor padrão do atributo ForegroundText é ‘light’. O valor padrão do atributo BackgroundColor é ‘transparent’. Todos os outros atributos não têm valores padrão.
  • Valores permitidos para:
    • O atributo DefaultDisplayName é uma cadeia de caracteres com até 256 caracteres.
    • O atributo PublisherDisplayName é uma cadeia de caracteres com até 256 caracteres.
    • O atributo StoreLogo é um caminho de arquivo válido para um arquivo .PNG na raiz do pacote.
    • O atributo Square150x150Logo é um caminho de arquivo válido para um arquivo .PNG na raiz do pacote.
    • O atributo Square44x44Logo é um caminho de arquivo válido para um arquivo .PNG na raiz do pacote.
    • Square480x480Logo é um caminho de arquivo válido para um arquivo .PNG na raiz do pacote.
    • Description é uma cadeia de caracteres
    • O atributo ForegroundText é light e dark.
    • O atributo BackgroundColor é um valor de cor usando o formato de nome comum ou código hexadecimal (#RRGGBB).
    • O atributo SplashScreenImage é um caminho de arquivo válido para um arquivo .PNG na raiz do pacote.

Comentários

  • Os atributos StoreLogo, Square150x150Logo, Square44x44Logo, Square480x480Logo e SplashScreenImage são todos obrigatórios para o empacotamento.
  • O atributo SplashScreenImage não é obrigatório para títulos de PC, mas é recomendado como prática recomendada.
  • Todos os outros atributos são opcionais.
  • Confira a seção ST_Color no Esquema do MicrosoftGame.config para obter uma lista completa de nomes comuns para valores de cor.

Logotipos em ShellVisuals e Executable

O elemento OverrideLogo em Executable está associado ao elemento Logo em ShellVisuals. Se OverrideLogo estiver definido, ele terá prioridade, para aquele executável, sobre o que está definido em Logo. O Logo em ShellVisuals deve ser definido em uma camada de pacote. Para um pacote de executável único, somente o elemento Logo é necessário. O tamanho do Logo deve ser de 150x150 pixels para o atributo Square150x150Logo. O atributo OverrideLogo substituirá o arquivo .png designado por Square150x150Logo em ShellVisuals para aquele Executable específico. Além do atributo OverrideLogo, também há atributos para OverrideSquare480x480Logo e Square44x44Logo, que podem ser especificados para substituir os arquivos .png designados por Square480x480Logo e Square44x44Logo, respectivamente, em ShellVisuals para aquele Executable específico. O exemplo a seguir detalha a configuração de elementos e atributos especificamente para substituições de Logo/DisplayName.
OverrideDisplayName e OverrideSplashScreenImage funcionam de forma semelhante a OverrideLogo.

Requisitos de imagem

Square150x150Logo, Square44x44Logo e StoreLogo são obrigatórios para um pacote que não seja de DLC tanto no PC quanto no console. SplashScreenImage é obrigatório para console, mas agora, a partir do GDK de fevereiro de 2021, é opcional para PC. Para pacotes de DLC, somente StoreLogo é obrigatório.

Resolução e formato da imagem

O formato de logotipo exigido é .png e há requisitos quanto ao formato de pixel (RGB de 24 bpp ou ARGB/PARGB de 32 bpp). Esses requisitos são impostos pelo SubmissionValidator. Cada imagem tem uma resolução de imagem obrigatória. São elas:
  • Square150x150Logo: 150x150
  • Square44x44Logo: 44x44
  • Square480x480Logo: 480x480
  • StoreLogo: 100x100
  • SplashScreenImage: 1920x1080

SplashScreenImage

SplashScreenImage é a imagem usada quando o seu título está sendo iniciado. O atributo OverrideSplashScreenImage, do elemento Executable, é usado para substituir a imagem da tela inicial exibida ao iniciar o seu título. Essa substituição agora permite imagens de tela inicial específicas por executável durante o desenvolvimento.
Embora o atributo SplashScreenImage não seja específico de plataforma, atualmente ele é obrigatório para o desenvolvimento em console XBOX e opcional para o desenvolvimento em PC.

BackgroundColor

BackgroundColor é um atributo do elemento ShellVisuals. Ele usa um código de cor HTML para definir o plano de fundo do título no PC. Isso aparecerá como uma borda ao redor do logotipo na Barra de Tarefas e no Menu Iniciar.

Confira também

Referência do MicrosoftGame.config - Sumário
Last modified on October 6, 2026