Skip to main content

Referência adicional do MicrosoftGame.config

Resumo

Este artigo descreve detalhes adicionais e material de referência para o arquivo MicrosoftGame.config. Ele inclui as seções a seguir.

Detalhes do configVersion do Game

A partir do Microsoft Game Development Kit (GDK) de março de 2022, o configVersion do Game foi atualizado de 0 para 1 para novos arquivos MicrosoftGame.config gerados usando as ferramentas do Microsoft Game Development Kit (GDK). A partir do GDK de outubro de 2023, todos os títulos devem usar configVersion=“1”. O Submission Validator relatará uma FALHA (FAILURE) para qualquer título enviado usando o GDK de outubro de 2023 com configVersion=“0”. As alterações entre o configVersion 0 e 1 do Game são as seguintes.
  • Os elementos MSAAppId e TitleId são obrigatórios se qualquer um deles for especificado no MicrosoftGame.config (ou seja, se o TitleId for especificado, o MSAAppId também deverá ser especificado).
  • Os elementos MSAAppId e TitleId são obrigatórios se o elemento NoCodePCRoot for especificado ou se o elemento AdvancedUserModel for definido com o valor false.
  • Os elementos ModFolder, EnableWritesToPackageRoot, DisableFilesystemWriteVirtualization e DisableRegistryWriteVirtualization foram preteridos com o configVersion 1.
Quais requisitos, definidos no esquema, serão executados em relação a um título é definido por este valor no MicrosoftGame.config:
O configVersion do Game permite os valores 0 e 1. Esses novos requisitos não afetarão os títulos existentes que forem atualizados para o Microsoft Game Development Kit (GDK) de março de 2022, pois o configVersion do Game deles permanecerá definido como 0.

Detalhes dos elementos

Esta seção detalha o nome do elemento, se ele é obrigatório, a finalidade, o nó pai e observações adicionais para os elementos definíveis no MicrosoftGame.config. Retornar ao início deste artigo.

Códigos de erro

Os códigos de erro a seguir podem ser encontrados ao trabalhar com arquivos MicrosoftGame.config. Para obter uma lista completa, consulte Códigos de erro.

Arquivo MicrosoftGame.config de exemplo

O MicrosoftGame.config a seguir é uma configuração de exemplo que mostra como os elementos são usados para XBOX Series X|S (com comentários sobre as diferenças para XBOX One). Para obter um exemplo de MicrosoftGame.config para PC, consulte Introdução ao empacotamento para PC.
Retornar ao início deste artigo.

Esquema XSD do MicrosoftGame.config

O esquema mais recente do arquivo MicrosoftGame.config está na pasta <raiz de instalação>/bin da instalação do Microsoft Game Development Kit (GDK), como GameConfigSchema.xsd. Confira o seguinte exemplo do GameConfigSchema.xsd:
Retornar ao início deste artigo.

Referência de elementos anteriores

  • PrimaryServiceConfig era um elemento usado no AppxManifest.xml do ERA do XBOX One para definir chamadas de SCID. Agora isso é definido no código e configurado no DevCenter.
  • VisualElements era um elemento usado no AppxManifest.xml do ERA do XBOX One para definir os logotipos da Store e outros aspectos visuais do título. Agora isso é definido em ShellVisuals.
  • GpuAvailability era um elemento usado no AppxManifest.xml do ERA do XBOX One para definir a disponibilidade de GPU. Agora isso é feito automaticamente, pois todos os títulos do Microsoft Game Development Kit (GDK) recebem automaticamente configurações variáveis (o máximo de GPU possível).
  • ConnectedStorageQuota era um elemento usado no AppxManifest.xml do ERA do XBOX One para definir o tamanho do armazenamento conectado. Agora isso é determinado por uma configuração do lado do servidor.
  • LicenseOverrides era um elemento usado no debug_licensing_overrides.xml do ERA do XBOX One para definir substituições de ContentID, ProductID e EKBID. Agora isso é gerenciado diretamente no MicrosoftGame.config com os elementos ContentIDOverride, StoreId e EKBIDOverride.
  • Os elementos NetworkManifest eram definidos em uma versão anterior do MicrosoftGame.config. Agora isso é feito por meio das APIs de Rede existentes, com exceção dos elementos DebugNetworkPortList.
  • XboxOneTitleMemoryMaxMB e XboxOneXTitleMemoryMaxMB eram elementos usados em uma versão anterior do MicrosoftGame.config. O XboxOneTitleMemoryMaxMB não é mais configurável, e os elementos do XBOX One X e do XBOX Series S|X para configuração de memória do título agora são XboxOneXTitleMemory, XboxLockhartTitleMemory e XboxAnacondaTitleMemory.
  • packageWriteRedirectionCompatibilityShim era anteriormente um valor de ExtendedAttribute para habilitar essa funcionalidade antes do GDK de maio de 2020. A partir do GDK de maio de 2020, isso passou a ser controlado como um elemento próprio, EnableWritesToPackageRoot.
Retornar ao início deste artigo.

Configuração de funcionalidades restritas

No Microsoft Game Development Kit (GDK), as funcionalidades restritas são configuradas por meio de elementos do MicrosoftGame.config. Um mapeamento das funcionalidades comumente usadas é o seguinte.
  • A funcionalidade runFullTrust é configurada para ser habilitada por padrão.
  • A funcionalidade customInstallActions é configurada pelo elemento CustomInstallActions.
As funcionalidades restritas exigem o envio de um email ao seu Gerente de Conta para garantir que as permissões para elas sejam habilitadas (isso é necessário além de atualizar corretamente o seu MicrosoftGame.config). Para obter mais informações sobre essas funcionalidades e como configurar o seu MicrosoftGame.config para usá-las no seu jogo para PC, consulte Introdução ao empacotamento de títulos para PC.

MicrosoftGame.config como parte da criação de pacotes DLC

Para obter mais informações sobre como gerar um MicrosoftGame.config para um pacote DLC, consulte Pacotes de conteúdo baixável (DLC). Retornar ao início deste artigo.

Confira também

Referência de elementos do MicrosoftGame.config
MicrosoftGame.Config
Visão geral do MicrosoftGame.Config
Localização do MicrosoftGame.Config
Visão geral do empacotamento
PC Bootstrapper
Last modified on October 6, 2026