Notas de versão do Microsoft Game Development Kit (GDK)

​

Notas de versão do Microsoft Game Development Kit (GDK) de abril de 2026

​

Introdução

​

GDKX

• O GDKX de abril de 2026 pode ser instalado lado a lado com GDKXs de novembro de 2019 e posteriores.
• Você pode baixar as versões do GDKX em https://aka.ms/gdkdl.
• As notas de versão de todas as versões do GDKX estão em https://aka.ms/gdkreleasenotes.

​

GDK

• Você pode baixar as versões do GDK e ver suas notas de versão em https://aka.ms/gdk-winget.

​

Sobre este documento

• Novidades
• Notas de versão:
  • GDK de abril de 2026 – Atualização 5
  • GDK de abril de 2026 – Atualização 4
  • GDK de abril de 2026 – Atualização 3
  • GDK de abril de 2026 – Atualização 2
  • GDK de abril de 2026 – Atualização 1
  • GDK de abril de 2026
• Problemas conhecidos
• Documentação

OBSERVAÇÃO: as notas de versão têm um número após suas descrições, como [12345678]. Para usuários do GDKX, esse número representa uma ID interna que a Microsoft usa para acompanhar o trabalho e o histórico relacionados ao item. Esse número pode ser útil para o gerente de conta de desenvolvedor caso você tenha dúvidas sobre uma nota de versão específica.

​

Novidades do Microsoft Game Development Kit de abril de 2026

• O GDKX e o GDK são lançados em dois tipos: Principais (com foco em recursos, duas vezes por ano) e Atualizações (com foco em correções, com a frequência necessária para os parceiros).
• Para ver a seção Novidades completa, consulte a versão online de Novidades.
• Para ver as notas de versão de versões anteriores do GDKX, consulte as publicações de notas de versão nos fóruns do GDK. Para o GDKX e o GDK, você pode ver as notas de versão na documentação online em Notas de versão do GDK.

​

GDK de abril de 2026 – Atualização 5

​

Correções de problemas

​

PlayFab Party

O PlayFab Party foi atualizado para a v1.10.26, que inclui as seguintes correções:

• Corrigida uma possível falha ao destruir um PartyEndpoint.
• Corrigido o tratamento de respostas vazias, malformadas ou incompletas de /MultiplayerServer/GetCognitiveServicesToken. O Party agora relata a solicitação como com falha, em vez de possivelmente falhar.
• Corrigida uma possível falha caso a configuração da conectividade direta fosse concluída depois que um dispositivo remoto saísse de uma rede ponto a ponto.

[63883777]

​

Sistema

Corrigida uma possível falha do título em xgameruntime.dll!OnRuntimeDisconnected quando cadeias de caracteres grandes são passadas para XSpeechSynthesizerCreateStreamFromText. [63860960]

Melhorado o tratamento da pressão de memória ao executar operações de leitura ou gravação de salvamentos de jogo. [63996543]

Melhorados os códigos de erro retornados quando uma operação de leitura ou gravação de salvamento de jogo falha. [63996543]

​

GDK de abril de 2026 – Atualização 4

​

Correções de problemas

​

Social Manager

Corrigido um problema em que a DLL GDK C Thunks não exportava as funções de manipulador de alteração da lista de silenciados e da lista de bloqueados de Privacidade e da contagem de solicitações de amizade Social. Assim, os títulos que as chamavam eram vinculados silenciosamente à biblioteca estática XSAPI em vez da DLL de thunks e acabavam com um runtime incompatível. [63776691]

Corrigida uma falha por estouro de pilha ao preencher o grafo social do Social Manager, porque PeoplehubService::DeserializeUser usava um quadro de pilha de 17 KB contendo três cópias redundantes de cada XblSocialManagerUser. [63776693]

​

MSIXVC1 (Empacotamento)

makepkg2 pack sem a opção /msixvc2 voltou a funcionar sem gerar um erro sobre a opção /usepublisherkey. Esse problema foi introduzido na Atualização 3. [63529609]

​

Wdapp

Corrigido um problema em que usar wdapp register em um jogo com binários ARM64 e x64 não escolhia o binário apropriado em computadores ARM64. [63756866]

​

PIX

Corrigido um problema na linha do tempo do PIX em que as setas de fences nomeados não eram exibidas. [63446892]

​

GDK de abril de 2026 – Atualização 3

​

Notificações

​

Publisher Content

Jogos para PC e console agora podem distribuir Publisher Content, um novo tipo de pacote que permite que os editores de jogos hospedem e atualizem conteúdo em suas próprias CDNs, enquanto a plataforma continua gerenciando a instalação, o download em segundo plano, a integridade e a experiência do usuário. Os desenvolvedores o declaram em seu MicrosoftGame.config (por meio do novo elemento PublisherContent no jogo base e do campo PublisherContentBaseProduct no pacote de conteúdo) e produzem o pacote com os novos parâmetros correspondentes do makepkg. Os jogos podem identificar o tipo de um pacote retornado pelas APIs existentes do GDK usando a nova API XPackageGetPackageKind(), que agora relata XPackageKind::PublisherContent além de Game e Content. [63082917]

​

PlayFab Party

O conjunto de ferramentas da plataforma Windows usado para compilar a biblioteca foi atualizado da v142 para a v143. [63294760]

​

PIX

Uma nova ferramenta de CLI está disponível para converter capturas de tempo programáticas: convertpevt.exe. [62666766]

​

Correções de problemas

​

Clang/LLVM

A biblioteca abrangente do XBOX Game OS, xgameplatform.lib, foi atualizada com as seguintes APIs Win32 para dar suporte à implementação de instrumentação PGO do clang/LLVM: FlushViewOfFile, VirtualUnlock. Os desenvolvedores que usam a PGO do clang/LLVM também precisam fornecer aliases de vinculação para algumas APIs POSIX herdadas usadas pela implementação do clang/LLVM para que a vinculação seja bem-sucedida:

#pragma comment(linker, "/alternatename:fileno=_fileno")
#pragma comment(linker, "/alternatename:getpid=_getpid")
#pragma comment(linker, "/alternatename:strdup=_strdup")

[62740693]

​

PIX

O carregamento de caches grandes de PDBs de sombreadores externos está mais confiável e consistente. [63014983]

​

PIX DirectStorage

Corrigido um problema que causava um comportamento de zoom incorreto ao navegar a partir do modo de exibição Element Details ou do modo de exibição Range Details em Timing Captures. [62664029]

Corrigido um problema que tornava difícil de ler, no modo escuro, o marcador em forma de losango que indica o início de um lote do DirectStorage na linha do tempo da Timing Capture. [62664035]

​

XBOX Manager

Corrigida uma falha do XBOX Manager que pode ocorrer ao exibir o vídeo de um console ou de um grupo na guia Remote Control. [62844048]

​

PlayFab Game Saves

Corrigidos problemas menores de relatório de telemetria no Steam Deck em que determinados campos de diagnóstico eram preenchidos incorretamente durante operações de salvamento. [62642608]

Desabilitado o recurso de upload do perdedor de conflito no Steam Deck para corresponder ao comportamento do XBOX/GRTS. [62642612]

Corrigido um problema em que o PlayFab Game Saves tratava incorretamente chaves do Registro ausentes, resultando em um erro de inicialização. [62642607]

​

Social Manager

Corrigido um problema em que a lista de amigos do Social Manager podia permanecer vazia de forma intermitente durante uma sessão inteira (XblSocialManagerDoWork não gerava nenhum evento LocalUserAdded) quando a solicitação inicial da lista de amigos do People Hub nunca era concluída. A solicitação inicial agora é recuperada automaticamente, de modo que o grafo social é preenchido sem exigir a reinicialização do jogo. [63202269]

Corrigido um problema em que o Social Manager retornava um nome de título e um texto de presença avançada incorretos para um amigo que jogava um título cujo nome de exibição contém um hífen, porque a cadeia de caracteres de presença era dividida no primeiro hífen em vez de no separador espaço-hífen-espaço pretendido. [63202289]

​

PlayFab Party

Corrigido o problema de fluxos de voz de manipulação de áudio não produzirem buffers quando o título ainda não havia configurado uma saída de áudio. [63294702]

Corrigida uma possível perda de voz ao fazer a transição entre redes enquanto a manipulação de áudio está ativa. [63294760]

Corrigida a ausência da transcrição final de fala em texto quando um fluxo de captura de manipulação de áudio está ativo. [63294760]

Corrigida uma possível falha no desligamento quando a fila de tarefas do processo era excluída antes de o Party concluir o desligamento. [63294760]

Corrigido um possível uso após liberação em que objetos internos de acompanhamento HTTP podiam ser excluídos antes da conclusão da tarefa assíncrona subjacente. [63294760]

Corrigido um bug em que o PlayFab Party não conseguia se associar à sua porta multijogador UDP em alguns ambientes de PC com registros WMI configurados incorretamente. [63251323]

​

Publisher Content

Corrigido um bug interno em XTaskQueue para evitar uma espera infinita durante a desmontagem. [63190218]

​

MSIXVC2

A criação de MSIXVC2 agora é bem-sucedida mesmo que o layout.xml do Intelligent Delivery tenha vários recursos que usam o mesmo arquivo de imagem. [63117723]

O comando pack do MSIXVC2 ignora normalmente as opções /maxencryptionfragments e /nogameos (que não têm efeito em um MSIXVC2) para facilitar sua inclusão em pipelines de build existentes. [63118134]

O comando pack do MSIXVC2 agora inclui corretamente os arquivos do diretório de origem que são links simbólicos. Anteriormente, ele os tratava incorretamente como arquivos de comprimento 0. [63118309]

​

GDK de abril de 2026 – Atualização 2

​

Notificações

​

Ferramentas de desenvolvedor

O modelo Direct3D 12 Desktop Game (Classic) para Visual Studio 2019 não tem mais configurações ARM64. O suporte para direcionar ARM64 com o Visual Studio 2019 foi preterido. O Visual Studio 2022 ou posterior é necessário. [62468394]

​

Arquivos Markdown disponíveis

Um arquivo .zip com os arquivos Markdown da documentação do GDK foi adicionado ao instalador do GDK. Anteriormente, esse arquivo .zip só estava disponível como um download separado em https://aka.ms/gdkdl. [62398050]

​

Correções de problemas

​

Entrada

Corrigido um problema em que ocorria um possível erro de memória insuficiente ao chamar GameInputCreate na versão NuGet do GameInput no XBOX. [62353092]

​

PIX

Corrigido um problema em que o PIX relatava incorretamente o modo do console como Lockhart ao abrir capturas feitas no Lockhart 40GB. [62490828]

​

Mídia

Corrigido um problema que fazia a Media Foundation Transform (MFT) do decodificador H.264 parar de responder durante a destruição quando o decodificador era criado e destruído sem o envio de amostras de vídeo de entrada. [62525251]

​

Sistema

Corrigido um problema em pacotes MSIXVC2 não assinados (locais) que não eram instalados usando o wdapp. [62386086]

​

GDK de abril de 2026 – Atualização 1

​

Notificações

​

XBOX Game Package Manager

Use a versão mais recente da interface do usuário do XBOX Game Package Manager (XGPM) do GitHub ao criar e carregar pacotes MSIXVC2. Essa versão inclui várias correções. Para baixá-la, acesse releases - Microsoft/PackageUploader.

​

Correções de problemas

​

Sistema

Corrigido um vazamento de memória na API XGameActivationAcceptPendingInvite. [61953160]

Corrigido um problema em que XLaunchUri falhava com URIs com mais de 21 caracteres. [62181431]

Corrigido um problema nos arquivos de cabeçalho do GDK XGameInvite.h e XGameProtocol.h que podia causar um erro de compilador C4768. [62181564]

​

MSIXVC2

Corrigidos vários problemas de confiabilidade e desempenho de componentes na versão prévia do MSIXVC2. [62225080]

​

Ferramentas de desenvolvedor

Corrigido um problema em que o MicrosoftGame.config Editor falhava silenciosamente ao salvar ou criar novos arquivos, embora relatasse sucesso. [62226865]

​

GDK de abril de 2026

​

Notificações

​

Preterição do layout do GDK

As versões do GDK de outubro de 2025 e abril de 2026 incluem tanto o layout simplificado quanto o layout herdado. A partir do GDK de outubro de 2026, a instalação instala por padrão somente o layout simplificado. O layout herdado ainda pode ser selecionado como uma instalação opcional, mas ele foi preterido e não é mais o caminho de desenvolvimento recomendado. O layout herdado deixará de ter suporte e será removido do instalador a partir da versão do GDK de abril de 2027.

​

Preterições de API

A API XGameActivation substituiu as APIs XGameProtocol e XGameInvite, fornecendo uma única superfície de API para todos os cenários de ativação de jogos. Como resultado, XGameProtocol e XGameInvite agora estão preteridas. As implementações existentes continuarão funcionando, mas recomendamos migrar para XGameActivation para novos desenvolvimentos e para compatibilidade futura. As APIs a seguir foram preteridas.

• XGameProtocolRegisterForActivation
• XGameProtocolUnregisterForActivation
• XGameInviteRegisterForEvent
• XGameInviteUnregisterForEvent
• XGameInviteRegisterForPendingEvent
• XGameInviteUnregisterForPendingEvent
• XGameInviteAcceptPendingInvite

Para obter mais informações, consulte XGameActivation. [61232139]

​

Ferramentas de desenvolvedor

O suporte principal ao Visual Studio 2019 expirou. O suporte estendido continua até abril de 2029. Para obter mais informações sobre o ciclo de vida e a manutenção do produto Visual Studio 2019, consulte Visual Studio 2019 Product Lifecycle and Servicing. O Visual Studio 2019 e o compilador do conjunto de ferramentas v142 estão fora do suporte principal desde abril de 2024 e recebem apenas manutenção de segurança. O suporte à integração com o Visual Studio 2019 e ao uso do conjunto de ferramentas de plataforma v142 por meio do Visual Studio 2022/Visual Studio 2026 será removido em uma versão futura do GDK. Esse processo incluirá a remoção da biblioteca Microsoft.Xbox.Services.142.GDK.C.lib. Para o Visual Studio 2022 e o Visual Studio 2026, recomendamos migrar para Microsoft.Xbox.Services.143.GDK.C.lib, que foi adicionada no GDK de abril de 2026. [61594513]

O Address Sanitizer (ASAN) para XBOX não tem mais suporte no Visual Studio 2019. [60868415]

Agora é possível copiar capturas de tela para a área de transferência a partir da guia Media Capture do XBOX Manager. [41667882]

Ferramentas de linha de comando do PC, como wdcapture, wdcapturesession e xblpcsandbox, agora dão suporte ao envio direto de comentários sobre bugs pelo aplicativo Hub de Feedback. [60250549]

O Package Uploader agora dá suporte a credenciais federadas. [60771527]

​

Microsoft Azure PlayFab

O PlayFab Multiplayer foi atualizado para a v1.9.0. Para obter detalhes, consulte PlayFab Multiplayer C++ SDK Release Notes - PlayFab | Microsoft Learn. [61288995]

​

Microsoft Azure PlayFab Party

O PlayFab Party foi atualizado para a v1.10.18. Para obter detalhes, consulte PlayFab Party Release Notes - PlayFab | Microsoft Learn. [61288995]

​

Correções de problemas

Corrigido um problema que fazia a configuração de idioma em um prompt de comando que não está em inglês mudar para inglês depois de executar ferramentas de linha de comando do GDK para XBOX, como xbapp.exe ou xbconnect.exe. [59688191]

Corrigido um problema em que o XBOX Game Package Manager não preenchia a interface do usuário com o último branch selecionado. [60771527]

​

Problemas conhecidos

​

makepkg2: /priorpackage não gera um relatório de comparação para pacotes MSIXVC2

Problema:
No makepkg2, usar o sinalizador /priorpackage ao empacotar pacotes MSIXVC2 não gera um relatório de comparação. A geração de relatórios de comparação não tem suporte para pacotes MSIXVC2 nesta versão. Aplica-se a:

• GDK de abril de 2026

Solução alternativa:
Nenhuma no momento. Status:
Esse problema será corrigido em uma futura atualização do GDK. [61771743]

​

makepkg2: layout.xml exige DisplayName em todos os recursos

Problema:
No makepkg2, o analisador de layout.xml exige o atributo DisplayName em todos os recursos, incluindo recursos ocultos, nos quais um nome de exibição não faz sentido. Aplica-se a:

• GDK de abril de 2026

Solução alternativa:
Adicione um atributo DisplayName de espaço reservado a todos os recursos ocultos em layout.xml. Status:
Esse problema será corrigido em uma futura atualização do GDK. [61767246]

​

makepkg2: o sinalizador /contentid falha quando ContentId não está presente em MicrosoftGame.config

Problema:
No makepkg2, usar o sinalizador /contentid quando nenhum ContentId está especificado em MicrosoftGame.config resulta no erro a seguir. /contentid specified on the command line does not match the ContentId derived from the MicrosoftGame.config file. Esse comportamento é diferente do makepkg, que aceitava o valor de /contentid diretamente nesse cenário. Aplica-se a:

• GDK de abril de 2026

Solução alternativa:
Use /contentidoverride em vez de /contentid. Status:
Esse problema será corrigido em uma futura atualização do GDK. [61767256]

​

Pacotes MSIXVC2 não podem ser carregados no Microsoft Partner Center por meio de sua interface do usuário da Web

Problema:
O upload de um pacote .msixvc para o Partner Center falha se ele tiver sido criado com as novas ferramentas makepkg2. Aplica-se a:

• Interface do usuário da Web do Partner Center

Solução alternativa:
Use uma das ferramentas a seguir para carregar pacotes MSIXVC2 no Partner Center.

• Comando upload do makepkg2: makepkg2 upload /d <content_directory> /branch "<BranchName>" /msixvc2
• XBOX Game Package Manager: baixe a versão mais recente em https://github.com/microsoft/PackageUploader.

Status:
O Partner Center será atualizado nos próximos meses para adicionar suporte a uploads de pacotes MSIXVC2 pela Web.

​

XboxPcTray.exe pode bloquear a desinstalação ou a atualização de pacotes MSIXVC2

Problema:
Às vezes, o XboxPcTray.exe mantém um identificador para a pasta Content do jogo, o que pode impedir a conclusão de operações de desinstalação ou atualização. Aplica-se a:

• GDK de abril de 2026

Solução alternativa:
Feche o aplicativo XBOX PC Tray antes de tentar desinstalar ou atualizar. Para fechá-lo, clique com o botão direito do mouse no ícone XboxPcTray na bandeja do sistema e selecione Quit. Você também pode encerrar o processo XboxPcTray.exe no Gerenciador de Tarefas. Status:
Esse problema será corrigido em uma futura atualização do GDK. [61618609]

​

Pacotes MSIXVC2 não podem ser carregados por meio do Package Uploader

Problema:
O upload de um pacote .msixvc para o Partner Center por meio da ferramenta de linha de comando Package Uploader falha com um erro 400 (Bad Request) se o pacote tiver sido criado com a ferramenta makepkg2 usando o sinalizador /msixvc2. Embora os pacotes MSIXVC e MSIXVC2 compartilhem a mesma extensão de arquivo .msixvc, os pacotes MSIXVC2 usam um formato interno diferente, ao qual o Package Uploader não dá suporte atualmente. Aplica-se a:

• CLI do Package Uploader (PackageUploader.exe)

Solução alternativa:
Use uma das ferramentas a seguir para carregar pacotes MSIXVC2.

• Comando upload do makepkg2: makepkg2 upload /d <content_directory> /branch "<BranchName>" /msixvc2>
• XBOX Game Package Manager: baixe a versão mais recente em https://github.com/microsoft/PackageUploader.

Status:
Esse problema será resolvido em uma versão futura do Package Uploader.

​

Pacotes MSIXVC2 no Partner Center aparecem com 1 byte de tamanho em sua interface do usuário

Problema:
O Partner Center mostra um tamanho incorreto para pacotes MSIXVC2 carregados. Ele mostra 1 byte, independentemente do tamanho do pacote. Aplica-se a:

• Partner Center

Solução alternativa:
Nenhuma no momento. Status:
Esse problema será corrigido em uma futura atualização das ferramentas do GDK.

​

Integração do MSBuild com Build With/Out Install (BWOI) para o Visual Studio 2026

Problema:
A integração do MSBuild com Build With/Out Install (BWOI) para o Visual Studio 2026 é um pouco diferente das versões anteriores. Nas versões atuais do Visual Studio 2026, a implementação do BWOI precisa ser “bloqueada” em um VCTargetsPath específico. Como resultado, todos os projetos são compilados com v145 ou clang-cl, mesmo que os valores de PlatformToolset estejam definidos como v142 ou v143. Esses conjuntos de ferramentas mais antigos geralmente compilam corretamente em cenários padrão do Visual Studio. Aplica-se a:

• GDK de abril de 2026

Solução alternativa:
Para obter detalhes sobre uma solução alternativa, consulte BWOIExample. Status:
A equipe do GDK e a equipe do Visual Studio estão trabalhando para resolver esse problema em uma versão futura do Visual Studio. [61855642]

​

Documentação

A documentação offline da versão de abril de 2026 do GDKX é instalada no seu PC de desenvolvimento pelo programa de instalação do GDKX. Depois de executar a instalação, o arquivo de Ajuda do GDKX (gdk.chm) estará em C:\Program Files (x86)\Microsoft GDK\Documentation.

• A documentação online do GDKX e do GDK está em Documentação do Game Development Kit (GDK).

​

Notas de versão do Microsoft Game Development Kit (GDK) de outubro de 2025

​

Introdução

​

Sobre este documento

• Novidades
• Notas de versão:
  • GDK de outubro de 2025 – Atualização 4
  • GDK de outubro de 2025 – Atualização 3
  • GDK de outubro de 2025 – Atualização 2
  • GDK de outubro de 2025 – Atualização 1
  • GDK de outubro de 2025
• Problemas conhecidos
• Documentação

​

Novidades do Microsoft Game Development Kit de outubro de 2025

• O GDK é lançado em dois tipos: Principais (com foco em recursos, duas vezes por ano) e Atualizações (com foco em correções, com a frequência necessária).
• Para ver a seção Novidades completa, consulte a versão online de Novidades.

​

GDK de outubro de 2025 – Atualização 4

​

Correções de problemas

​

PlayFab Game Saves

Corrigido um problema em que aplicar a exclusão de uma pasta na nuvem podia excluir arquivos locais que nunca haviam sido sincronizados. Também foi aumentada a granularidade dos relatórios de progresso de upload para que os títulos possam animar uma barra de progresso determinada durante a compactação. [63666969]

Corrigido um problema em que transferências de armazenamento em nuvem com falha eram relatadas como bem-sucedidas, o que podia finalizar um salvamento com dados ausentes e impedir permanentemente que os salvamentos desse jogador fossem sincronizados em todos os dispositivos. [63475452]

Corrigidos problemas que podiam causar perda de dados de salvamento durante a sincronização, corrupção de memória quando salvamentos de jogo compartilhavam um contexto do GDK e tratamento incorreto de manifestos que falhavam na validação. [63647898]

Corrigido um problema em que o retorno de chamada de progresso da sincronização de salvamentos de jogo relatava um tamanho total igual a zero, impedindo que os títulos exibissem uma barra de progresso determinada. [63529869]

​

GDK de outubro de 2025 – Atualização 3

​

Notificações

​

Registro de associações de tipo de arquivo

Jogos para PC agora podem registrar associações de tipo de arquivo em MicrosoftGame.Config. Quando um usuário abre um arquivo com uma extensão registrada, o jogo é iniciado ou trazido para o primeiro plano. Esse comportamento é habilitado por meio das APIs XGameActivation* (por exemplo, XGameActivationRegisterForEvent()).

​

Entrada

Controles com detecção de movimento que usam comunicação simples entre processos (SIPC) agora compartilham o pipeline de fusão de sensores do PC. O dimensionamento do acelerômetro e do giroscópio, a captura do viés do giroscópio na inicialização e a correção de desvio baseada em repouso estão no mesmo nível do PC. Como resultado, IGameInputReading::GetMotionState retorna uma orientação relativa à gravidade com um desvio limitado.

​

PlayFab Game Saves

A capacidade de preservar e reverter para o salvamento de jogo descartado ao escolher entre Keep Local ou Keep Cloud no Steam Deck foi desabilitada para corresponder ao comportamento do XBOX/Gaming Runtime Services (GRTS).

​

Correções de problemas

​

Rede

Corrigido um problema em que a biblioteca podia falhar após perder uma conexão WebSocket enquanto estava pausada em um depurador.

​

Serviços XBOX

Corrigido um problema em que chamadas HTTP baseadas em WinHTTP podiam apresentar instabilidade devido a uma condição de uso após liberação em libHttpClient.

​

Entrada

Corrigido um problema em que ocorria um possível erro de memória insuficiente ao chamar GameInputCreate na versão NuGet do GameInput no XBOX.

Corrigido um problema em que a entrada podia ser perdida após retomar um jogo suspenso.

​

Mídia

Corrigido um problema que fazia a Media Foundation Transform (MFT) do decodificador H.264 parar de responder durante a destruição quando o decodificador era criado e destruído sem o envio de amostras de vídeo de entrada.

​

PlayFab Game Saves

Corrigido um problema em que PFGameSaves tratava incorretamente chaves do Registro ausentes, resultando em um erro de inicialização.

Corrigidos problemas menores de relatório de telemetria no Steam Deck em que determinados campos de diagnóstico eram preenchidos incorretamente durante operações de salvamento.

​

GDK de outubro de 2025 – Atualização 2

​

Notificações

​

Atualizações do Microsoft Azure PlayFab Party para a v2.2.7

• Alterado o comportamento de PartyStatusChangeResult de PartyNetwork::CreateEndpoint para retornar PartyServiceError para erros transitórios que ocorrem antes de o token expirar e para retornar UserNotAuthorized somente quando o token realmente tiver expirado.
• Adicionado suporte à seleção de dispositivo de áudio para ambientes do Gaming Runtime Services (GRTS) sem XUser ou em processo.
• Corrigida uma possível falha durante cenários de transição entre várias redes.

​

Atualizações do PlayFab Party para a v1.10.16

• O comportamento de PartyStatusChangeResult de PartyNetwork::CreateEndpoint foi alterado para retornar PartyServiceError para erros transitórios que ocorrem antes de o token expirar e para retornar UserNotAuthorized somente quando o token realmente tiver expirado.
• Foi adicionado suporte à seleção de dispositivo de áudio para ambientes do Gaming Runtime Services (GRTS) sem XUser ou em processo.
• Foi corrigida uma possível falha durante cenários de transição entre várias redes.

​

Serviços XBOX

Adicionado suporte para habilitar a saída de rastreamento para o depurador no xgamingruntime em processo, correspondendo à funcionalidade existente do Gaming Runtime Services (GRTS). Para habilitar mensagens de rastreamento HTTP/WebSocket na janela Saída do Visual Studio, defina a chave do Registro HKEY_LOCAL_MACHINE\Software\Microsoft\GamingServices\Auth\TraceToDebugger (REG_DWORD) como 1. Essa configuração é útil para depurar problemas de rede, configuração de proxy e problemas de autenticação. O recurso é opcional e não tem impacto quando desabilitado.

​

Rede

O XCurl foi atualizado para permitir várias chamadas a xcurl_global_init_mem() ou curl_global_init_mem() entre chamadas a curl_global_cleanup(). Esse novo comportamento corresponde ao comportamento da LibCurl para curl_global_init_mem(), alinhando a API XCurl às expectativas da LibCurl. Além disso, curl_global_init(), curl_global_init_mem(), xcurl_global_init_mem() e curl_global_cleanup() passaram a ser thread-safe.

​

Correção da simulação de marcas do Intelligent Delivery no packageutil compare

Um erro de lógica no packageutil compare fazia com que as simulações do Intelligent Delivery excluíssem marcas obrigatórias não OnDemand sempre que qualquer simulação baseada em marcas era executada. Isso produzia previsões imprecisas de tamanho e atualização para títulos que usam empacotamento OnDemand ou baseado em Feature. A correção garante que:

• Marcas não OnDemand sejam sempre incluídas nas simulações de pacotes que não são baseados em Feature.
• Pacotes baseados em Feature tenham suporte total, incluindo marcas segmentadas e simulações de recurso completo e de recurso único.

Essa correção restaura a precisão dos relatórios de tamanho e permite que os parceiros avaliem corretamente as configurações de ID. Binário afetado: PackageUtil.exe

​

Correções de problemas

​

Ferramentas do GDK

Corrigido um problema que fazia com que os Prompts de Comando do GDK incluídos no instalador do GDK Tools não incluíssem corretamente o diretório bin do GDK, onde as ferramentas estão localizadas.

Corrigido um problema que fazia a ferramenta XblTestAccountGui não conseguir entrar, com a seguinte mensagem de erro. Live auth error: Login Error: The remote server returned an error: (400) Bad Request.

Corrigido um problema que fazia instalações silenciosas do GDK que usavam a opção de linha de comando /features ignorarem a instalação dos componentes do layout herdado.

​

Microsoft Azure PlayFab Game Saves

Corrigido um problema de FAIL_FAST na retomada quando um jogo usa o PlayFab Game Saves.

Corrigido um problema ao usar o PlayFab Game Saves em processo em que o retorno de chamada de contenção de dispositivo podia ser invocado incorretamente quando não ocorria nenhum conflito real de dispositivo. Anteriormente, o SDK do PlayFab tratava a ausência de um manifesto pendente como prova de que outro dispositivo havia assumido o controle. No entanto, isso também podia acontecer em cenários normais (por exemplo, quando nenhuma sincronização estava em andamento ou quando o dispositivo local concluía seu próprio upload). Agora, o SDK verifica corretamente se o manifesto finalizado foi realmente criado por um dispositivo diferente antes de disparar o retorno de chamada de contenção, evitando notificações falso-positivas para o jogo.

Corrigido um problema em que a inicialização do PlayFab Game Saves falhava no Gaming Runtime Services (GRTS) se o diretório da pasta de salvamento especificada ainda não existisse ou se o caminho fornecido não tivesse uma barra invertida à direita. Agora, o SDK do PlayFab cria automaticamente o diretório, se necessário, e garante a formatação adequada do caminho antes da inicialização.

Corrigido um problema de sincronização em que a versão em processo do PlayFab Game Saves podia reutilizar incorretamente um manifesto pendente desatualizado depois que a versão do manifesto finalizado na nuvem já o havia ultrapassado. Agora, o manifesto pendente só é reutilizado quando pertence ao dispositivo atual e tem uma versão maior que a versão finalizada na nuvem. Essa alteração evita possíveis inconsistências de dados durante cenários de sincronização entre vários dispositivos.

Corrigido um problema em que os carimbos de data/hora de modificação de arquivos estavam incorretos ao sincronizar salvamentos de jogo entre dispositivos que usam provedores de armazenamento diferentes (em processo versus Gaming Runtime Services (GRTS)). Agora, os carimbos de data/hora dos arquivos são preservados e convertidos corretamente para UTC ao criar arquivos compactados, garantindo um comportamento consistente dos carimbos de data/hora em todas as plataformas.

Corrigido um problema em que a descrição de um Game Save retornava dados malformados/corrompidos no Steam Deck. Agora, as descrições de salvamento são decodificadas corretamente em Base64 quando são recuperadas do manifesto, garantindo que você obtenha o texto de descrição legível originalmente definido.

Corrigido um problema ao usar o PlayFab Game Saves em processo em que cancelar uma operação de sincronização na caixa de diálogo de progresso podia causar uma falha de asserção e um comportamento instável. O mecanismo de cancelamento foi reformulado para usar uma abordagem com um sinalizador atômico thread-safe. Essa alteração permite que os usuários cancelem com segurança operações de upload ou download em andamento na interface do usuário de progresso sem disparar condições de corrida ou falhas de asserção. Agora, o SDK verifica corretamente se há solicitações de cancelamento durante as principais etapas da operação de sincronização e é encerrado de forma limpa com um código de erro de cancelamento pelo usuário.

Corrigido um problema ao usar o PlayFab Game Saves em processo em que o download de um grande número de arquivos pequenos (por exemplo, 1.000 ou mais arquivos de texto pequenos) falhava. O acompanhamento de progresso usava incorretamente os tamanhos de arquivo não compactados para relatar o progresso da transferência, o que causava incompatibilidades ao lidar com muitos arquivos pequenos compactados. Agora, o relatório de progresso acompanha corretamente os tamanhos em bytes compactados para refletir com precisão o progresso real da transferência pela rede.

Corrigida uma falha ao usar o PlayFab Game Saves em processo que ocorria ao chamar a API PFGameSaveFilesSetSaveDescriptionAsync enquanto desconectado da nuvem. Agora, essa API retorna um código de erro apropriado em vez de falhar.

Corrigido um problema em PFUninitializeAsync() em que ele parava de responder ao usar PFGameSaveFiles em processo quando um retorno de chamada de falha de sincronização estava aguardando resposta durante o desligamento. Agora, o SDK cancela automaticamente os retornos de chamada de interface do usuário pendentes ao cancelar a inicialização, garantindo um desligamento limpo mesmo que o jogo não responda a syncFailedCallback.

Corrigido um problema em que um jogo podia falhar quando o dispositivo ativo era alterado usando o PlayFab Game Saves.

Corrigido um problema em que os retornos de chamada de conflito exibiam carimbos de data/hora incorretos ao usar o PlayFab Game Saves em processo.

Corrigido um problema em que PFGameSaveFilesSetSaveDescriptionAsync retornava E_FAIL e as chamadas subsequentes paravam de responder quando chamado offline no Steam Deck.

Corrigido um problema em que cancelar um upload com falha no Steam Deck fazia com que todos os uploads subsequentes falhassem permanentemente com E_PF_GAME_SAVE_MANIFEST_UPDATES_NOT_ALLOWED.

Corrigido um problema em que PFGameSaveFilesUploadWithUiAsync podia travar indefinidamente se um upload anterior fosse cancelado durante um erro de serviço. Agora, o retorno de chamada de interface do usuário de falha de sincronização é exibido corretamente na nova tentativa, permitindo que o usuário cancele ou repita a operação.

​

Rede

Corrigido um problema em que, 24 horas após a primeira tentativa de lobby ou de matchmaking, se a biblioteca não tivesse sido limpa, ela podia falhar ao criar lobbies subsequentes, ingressar em lobbies subsequentes, assinar convites de lobby ou criar tíquetes de matchmaking subsequentes.

​

Serviços XBOX

Corrigido um problema que fazia com que os retornos de chamada de convite de jogo não fossem disparados no Steam Deck nos dois casos específicos a seguir.

• Quando nenhuma Multiplayer Activity Connection String era fornecida com o convite
• Quando o manipulador de convites era adicionado pelo título depois que o XUser já havia sido adicionado

Corrigido um problema em que o runtime de jogos em processo não usava as configurações de proxy do WinHTTP, causando erros E_XAL_NETWORK quando um proxy (por exemplo, o Fiddler) era configurado via netsh winhttp set proxy.

​

GDK de outubro de 2025 – Atualização 1

• O GDKX e o GDK são lançados em dois tipos: Principais (com foco em recursos, duas vezes por ano) e Atualizações (com foco em correções, com a frequência necessária para os parceiros).
• Para ver a seção Novidades completa, consulte a versão online de Novidades.
• Para ver as notas de versão de versões anteriores, consulte as publicações de notas de versão nos fóruns do GDK ou veja as notas de versão na documentação online em Notas de versão do GDK.

​

Notificações

​

Preterições de API

A API XGameActivation substituiu as APIs XGameProtocol e XGameInvite, fornecendo uma única superfície de API para todos os cenários de ativação de jogos. Como resultado, XGameProtocol e XGameInvite agora estão preteridas. As implementações existentes continuarão funcionando, mas recomendamos migrar para XGameActivation para novos desenvolvimentos e para compatibilidade futura. As APIs a seguir foram preteridas.

• XGameProtocolRegisterForActivation
• XGameProtocolUnregisterForActivation
• XGameInviteRegisterForEvent
• XGameInviteUnregisterForEvent
• XGameInviteRegisterForPendingEvent
• XGameInviteUnregisterForPendingEvent
• XGameInviteAcceptPendingInvite

Para obter mais informações, consulte XGameActivation. [61232139]

​

Funcionalidade multiplataforma

XUserSignOutAsync e XUserSignOutResult foram adicionados para dar suporte à saída do jogador no Steam Deck. XUserIsSignOutPresent pode ser usado para determinar se o dispositivo atual dá suporte à saída via API. [59457172]

​

Serviços XBOX

Três novas APIs, XGameInviteRegisterForPendingEvent, XGameInviteUnregisterForPendingEvent e XGameInviteAcceptPendingInvite, foram adicionadas para restaurar a consistência dos retornos de chamada de XGameInvite, que antes se comportavam de forma inconsistente entre cenários em processo e fora de processo. O novo manipulador de convites pendentes é chamado somente em fluxos em processo. Depois que o título trata a aceitação do convite, XGameInviteAcceptPendingInvite é chamado. Isso dispara o retorno de chamada de convite aceito. No Windows e no console XBOX (onde o Gaming Runtime Services (GRTS) está disponível), a interface do usuário do shell era responsável pelo fluxo de aceitação de convites. O título só era notificado quando o convite era aceito. Em cenários em processo, como no Steam Deck, os títulos tratam a aceitação de convites. O retorno de chamada de XGameInvite é disparado quando um convite é recebido, para que os títulos possam gerenciar o fluxo de aceitação. [59693389]

​

Gráficos

Para a família XBOX One, foi adicionado um novo sinalizador D3D12XBOX_PIPELINE_STATE_FLAG_VS_EXPORT_VIEWPORT_INDEX_REUSE para evitar problemas de eliminação de duplicação ao usar reutilização de índice e sombreadores de vértice que exportam SV_ViewportArrayIndex. [59989696]

​

Sistema

Agora é possível reduzir o tamanho do StagingBuffer ao inicializar o DirectStorage no XBOX, liberando memória do título. Agora há valores de enumeração disponíveis para uma economia de buffer de até 16 MB em relação ao tamanho de preparo padrão de 32 MB. No entanto, o desempenho de arquivos diminui ligeiramente ao usar um buffer menor. Para obter mais informações, consulte DirectStorage. [60006847]

Uma nova interface, IDStorageFactoryX2, já está disponível. Ela expõe uma nova API, CreateQueue1, para criar filas do DirectStorage. Essa API recebe uma nova estrutura de definição de fila, permitindo controlar se ocorrem envios automáticos na fila do DirectStorage recém-criada. Para obter mais informações, consulte DirectStorage. [60039148]

O GDK de outubro de 2025 introduziu os retornos de chamada de XGameUi. Eles permitem que os desenvolvedores implementem sua própria experiência do usuário na plataforma Steam Deck. Vários desses retornos de chamada, especialmente os de componentes de interface do usuário sem nenhuma interação do usuário, não tinham APIs SetResponse associadas. Essas APIs são responsáveis por concluir as chamadas assíncronas de interface do usuário. Elas foram introduzidas para permitir que os desenvolvedores concluam todas as chamadas de XGameUi no Steam Deck. [60149696]

​

Microsoft Azure PlayFab Game Saves

O acompanhamento do progresso de upload agora relata contagens de bytes compactados. Essa alteração mantém os retornos de chamada de progresso e a telemetria alinhados com os dados realmente transmitidos e evita porcentagens de “concluído” prematuras quando salvamentos grandes têm baixa compactação. [60147964]

Os sinalizadores PFGameSaveFilesAddUserOptions::RollbackToLastKnownGood e RollbackToLastConflict, antes inativos, foram habilitados. Agora eles atendem às solicitações de reversão durante PFGameSaveFilesAddUserWithUiAsync. Os títulos obtêm a seleção esperada em vez de sempre sincronizar com o salvamento mais recente. [60147982]

A inicialização agora é limpa corretamente após falhas E_INVALIDARG (como um caminho de salvamento do Steam Deck ausente). Essa alteração garante que as chamadas subsequentes não relatem mais “already initialized”. [60148008]

Foi adicionado registro em log para melhorar o diagnóstico ao executar fora de processo. [60148021]

​

PIX

Ao converter capturas de tempo programáticas, as configurações de GPU Only Events na interface do usuário eram ignoradas. Agora, essas configurações são aplicadas à captura convertida. [60294683]

​

Correções de problemas

​

Microsoft Azure PlayFab Party

Corrigido um problema em que o chat de voz do PlayFab Party não podia ser estabelecido quando nenhum XUser estava conectado, incluindo em jogos da Steam executados no Windows sem um usuário da rede XBOX e no Steam Deck. [59804895]

​

Serviços XBOX

Corrigido um problema em que o URI recebido pelo jogo dos retornos de chamada de XGameInvite no Steam Deck não correspondia ao URI recebido no Windows. O URI do Steam Deck incluía apenas a cadeia de conexão, mas não tinha as informações do remetente nem o XUID do usuário convidado. [59990660]

​

Sistema

Corrigido um problema do XGameRuntime em processo em que XGameGetXboxTitleId falhava com E_GAMERUNTIME_SERVICE_NOT_AVAILABLE. Essa falha tinha um efeito cascata que fazia outras APIs do XBOX falharem, incluindo XblMultiplayerActivitySendInvitesAsync. [60043213]

Corrigido um problema em que a configuração Break On Suspend Timeout no Visual Studio não entrava em vigor depois que um título chamava XLaunchNewGame. [60063672]

​

Gráficos

Corrigido um problema em que o sinalizador D3D12XBOX_RESOURCE_FLAG_FORCE_TEXTURE_COMPATIBILITY não era respeitado para buffers de apresentação que usam compactação de cor delta (DCC). [60237976]

​

Ferramentas do GDK

Corrigido um problema que fazia com que a versão errada do dxc.exe fosse executada em um prompt de comando do GDK para XBOX One ou em um prompt de comando do GDK para Scarlett. A versão do Windows era executada em vez da versão do XBOX. [60265047]

​

PIX

Corrigido um problema em que Mesh Shader Output exibia um erro no caso em que ExecuteIndirect era usado com comandos Simple DispatchMesh. [60270639]

​

GDK de outubro de 2025

​

Notificações

​

Preterição do layout do GDK

As versões do GDK de outubro de 2025 e abril de 2026 incluem tanto o layout simplificado quanto o layout herdado. A partir do GDK de outubro de 2026, a instalação instala por padrão somente o layout simplificado. O layout herdado ainda pode ser selecionado como uma instalação opcional, mas ele foi preterido e não é mais o caminho de desenvolvimento recomendado. O layout herdado deixará de ter suporte e será removido do instalador a partir da versão do GDK de abril de 2027.

​

Ferramentas do GDK

O sinalizador /updatesubval foi adicionado ao MakePkg para verificar se há uma versão mais recente da SubmissionValidator.dll. Se esse sinalizador for usado e houver uma versão mais recente da SubmissionValidator.dll disponível, o MakePkg baixará e colocará o arquivo .dll no caminho do MakePkg. [56987338]

A Touch Adaptation Kit Command Line Tool (TAK CLI) (tak.exe) foi removida da instalação do GDK. Para obter instruções sobre como baixar essa ferramenta, acesse TAK CLI no GitHub. [57605599]

​

Correções de problemas

​

Gráficos

Corrigido um problema no driver do Direct3D 12 em consoles XBOX Series X|S que fazia com que exibições não compactadas em blocos (Shader Resource View (SRV) e Unordered Access View (UAV)) de recursos compactados em blocos fossem criadas com os tamanhos errados. [57051436]

​

Problemas conhecidos

​

Arquivos .zip de Markdown offline

Problema:
Os arquivos .zip de Markdown offline não estão disponíveis no momento. Aplica-se a:

• GDK de outubro de 2025
• GDK de outubro de 2025 – Atualização 1

Diretrizes:
Você ainda pode baixar a documentação offline como um arquivo de Ajuda HTML Compilada (.chm) em https://aka.ms/gdkdl. [60279334]

​

Fluxo de XUserResolveIssueWithUiAsync

Problema:
A API XUserResolveIssueWithUiAsync destina-se a resolver problemas de conta de usuário, como problemas de token ou de consentimento, e não a alterar a identidade conectada. No entanto, é possível que um usuário que entrou originalmente com a Conta A conclua esse fluxo e entre com a Conta B, resultando em um XUID diferente. Impacto:
Quando a conta muda durante esse fluxo, a API detecta a incompatibilidade e faz a operação falhar automaticamente. Aplica-se a:

• GDK de outubro de 2025
• GDK de outubro de 2025 – Atualização 1

Diretrizes:
Se a operação falhar devido a uma alteração de conta, remova o usuário e adicione-o novamente para garantir a entrada correta. [59960311]

​

Download de dados de salvamento compactados

Problema:
O PlayFab Game Saves pode encontrar problemas ao baixar dados de salvamento compactados maiores que seu tamanho não compactado. Isso ocorre com mais frequência quando um jogo usa sua própria compactação de arquivos além do PlayFab Game Saves. Aplica-se a:

• GDK de outubro de 2025
• GDK de outubro de 2025 – Atualização 1

Diretrizes:
Considere desabilitar a compactação de arquivos adicional, se possível. Status:
Isso será corrigido em uma futura atualização do GDK. [60348127]

​

Erro de conta de teste da ferramenta XblTestAccountGui

Problema:
A ferramenta XblTestAccountGui pode não conseguir conectar contas de teste. Nesse caso, a seguinte mensagem de erro é exibida. Live auth error: Login Error: The remote server returned an error: (400) Bad Request. Aplica-se a:

• GDK de outubro de 2025
• GDK de outubro de 2025 – Atualização 1

Status:
Esse problema foi corrigido na versão mais recente das ferramentas de desenvolvedor do XBOX Live no GitHub. Elas estão disponíveis em https://aka.ms/xbltools. Essa correção será incluída em uma versão futura do GDK. [60428977]

​

XGameInviteRegisterForPendingEvent deve ser chamado antes de adicionar XUsers

Problema:
No Steam Deck, XGameInviteRegisterForPendingEvent deve ser chamado antes de adicionar XUsers; caso contrário, eles não serão registrados corretamente para notificações de convite. Esse requisito de sequência não foi intencional. Aplica-se a:
GDK de outubro de 2025 – Atualização 1 Status:
Esse problema será corrigido em uma versão futura do GDK. [60470935]

​

XGameInviteRegisterForPendingEvent exige que connectionString esteja definido

Problema:
No Steam Deck, XGameInviteRegisterForPendingEvent não invoca os retornos de chamada do título para convites que não têm o connectionString da XBOX Multiplayer Activity (MPA). Embora seja um campo opcional ao enviar o convite, o XGameRuntime descarta os conteúdos de convite que não o incluem.

Aplica-se a:
GDK de outubro de 2025 – Atualização 1 Solução alternativa:
Forneça uma cadeia de conexão não vazia ao enviar o convite. Ignore-a no lado do destinatário se ela não for necessária. Status:
Esse problema será corrigido em uma versão futura do GDK. [60470935]