> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Descreve alterações significativas, notificações, correções de bugs e problemas conhecidos do Microsoft Game Development Kit (GDK).

> [tab] GDK 2610
>
> ## Notas de versão do Microsoft Game Development Kit (GDK) de outubro de 2026
>
> ## Introdução
>
> Bem-vindo ao Microsoft Game Development Kit with XBOX Extensions (GDKX) de outubro de 2026 e à versão pública do GDK. Você pode usar o GDKX para desenvolver jogos que podem ser certificados e aprovados para lançamento em PCs com Windows 11, PCs com Windows 10, XBOX One e consoles XBOX Series X|S *usando uma base de código compartilhada*. Com o GDK, você pode desenvolver jogos que podem ser certificados e aprovados para lançamento em PCs com Windows 11 e PCs com Windows 10.
>
> ## GDKX
>
> > * O GDKX de outubro 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](https://aka.ms/gdkdl).
> > * As notas de versão de todas as versões do GDKX estão em [https://aka.ms/gdkreleasenotes](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](https://aka.ms/gdk-winget).
>
> ### Sobre este documento
>
> Organizamos este documento nas seções a seguir.
>
> * [Novidades](#whats-new-in-the-october-2026-microsoft-game-development-kit)
>
> * **Notas de versão:**
>   * [GDK de outubro de 2026](#october-2026-gdk)
>
> * [Documentação](#documentation)
>
> > **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 outubro 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](https://docs.xbox.com/pt-BR/announcements/gdk/whats-new.md).
> > * Para ver as notas de versão de versões anteriores do GDKX, consulte as [publicações de notas de versão](https://aka.ms/gdkreleasenotes) nos fóruns do GDK. Para o GDKX e o GDK, consulte as [notas de versão de abril de 2026](https://docs.xbox.com/pt-BR/announcements/gdk/2604/release-notes-2604.md) e as [notas de versão de outubro de 2025](https://docs.xbox.com/pt-BR/announcements/gdk/2510/release-notes-2510.md).
>
> ***
>
> ## GDK de outubro de 2026
>
> ### Notificações
>
> #### Publisher Content
>
> > Jogos para PC e console agora podem distribuir Publisher-hosted 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.
> >
> > Para obter mais informações, consulte [Pacotes de Publisher Content](https://learn.microsoft.com/gaming/gdk/docs/features/common/packaging/packaging-publisher-content?view=gdk-2610).
>
> #### 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.
>
> #### Instalação do GDK
>
> > Na instalação do GDK, a seleção padrão da pergunta **Install legacy layout directories** mudou de **Yes** para **No**.
> >
> > Se você precisar dos layouts herdados por motivos de compatibilidade, altere a seleção para **Yes** ou use a opção `/includelegacylayout` ao instalar no modo silencioso.
> >
> > Os layouts herdados deixarão de ter suporte e serão removidos do instalador a partir da versão do GDK de abril de 2027. \[64072906]
>
> A captura de tela a seguir mostra a tela de instalação atualizada.
>
> ![Captura de tela da instalação do GDK mostrando Install legacy layout directories com a opção No, only install the cross-platform layout (recommended) selecionada.](https://mintcdn.com/microsoft-4404708b/fbwYDMD_yyzYxIh2/images/source-sync-3b3849316d8d8497a86d34bf84bb2f0d1f5caf17.png?fit=max\&auto=format\&n=fbwYDMD_yyzYxIh2\&q=85\&s=05662ed3a8358aba17b55f140e692b6f)
>
> ### Correções de problemas
>
> #### XblPCSandbox
>
> > Corrigido um problema que fazia o `xblpcsandbox.exe` falhar com o código de erro `0x80070520` (`ERROR_NO_SUCH_LOGON_SESSION`) ao elevar a partir de uma conta de usuário normal. \[63442452]
>
> #### Visual Studio
>
> > **Visual Studio Dynamic Debugging e Run-from-PC (RfPC)**
> >
> > Corrigido um problema em que o Dynamic Debugging não tinha suporte quando Run-from-PC era selecionado como o modo de implantação. Essa alteração também atualiza o depurador remoto para o Visual Studio 2026, com 100% de compatibilidade com versões anteriores para o Visual Studio 2022.
> >
> > Ao usar o Visual Studio 2022 com o Dynamic Debugging, **Debug > Options > Load Symbols In External Process** deve estar desmarcado; caso contrário, a sessão de depuração travará. \[63663764]
>
> > Removida a página de propriedades preterida **VS Extension Libraries** dos projetos do GDK. \[64151635]
>
> #### Ferramentas de desenvolvedor
>
> > Corrigido um problema que fazia `XrfsSvc.exe /paths:del=PATH` excluir a lista inteira de caminhos em vez do caminho especificado. \[63925713]
>
> #### Gaming Services
>
> > Corrigido um problema que fazia uma variável não resolvida `%GAMING_SERVICES_VERSION%` aparecer em `Microsoft GDK\<edition>\Windows\Redist\InstallGamingServicesBundle.ps1`. A versão correta do Gaming Services agora aparece nesse arquivo. \[63999992]
>
> ***
>
> ## Documentação
>
> > A documentação offline da versão de outubro 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)](https://aka.ms/gdkonline).

> [tab] GDK 2604
>
> ## Notas de versão do Microsoft Game Development Kit (GDK) de abril de 2026
>
> ## Introdução
>
> Bem-vindo ao Microsoft Game Development Kit with XBOX Extensions (GDKX) de abril de 2026 e à versão pública do GDK. Você pode usar o GDKX para desenvolver jogos que podem ser certificados e aprovados para lançamento em PCs com Windows 11, PCs com Windows 10, XBOX One e consoles XBOX Series X|S *usando uma base de código compartilhada*. Com o GDK, você pode desenvolver jogos que podem ser certificados e aprovados para lançamento em PCs com Windows 11 e PCs com Windows 10.
>
> ## 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](https://aka.ms/gdkdl).
> > * As notas de versão de todas as versões do GDKX estão em [https://aka.ms/gdkreleasenotes](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](https://aka.ms/gdk-winget).
>
> ### Sobre este documento
>
> Organizamos este documento nas seções a seguir.
>
> * [Novidades](#whats-new-in-the-april-2026-microsoft-game-development-kit)
>
> * **Notas de versão:**
>   * [GDK de abril de 2026 – Atualização 5](#april-2026-gdk-update-5)
>   * [GDK de abril de 2026 – Atualização 4](#april-2026-gdk-update-4)
>   * [GDK de abril de 2026 – Atualização 3](#april-2026-gdk-update-3)
>   * [GDK de abril de 2026 – Atualização 2](#april-2026-gdk-update-2)
>   * [GDK de abril de 2026 – Atualização 1](#april-2026-gdk-update-1)
>   * [GDK de abril de 2026](#april-2026-gdk)
>
> * [Problemas conhecidos](#known-issues)
>
> * [Documentação](#documentation)
>
> > **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](https://docs.xbox.com/pt-BR/announcements/gdk/whats-new.md).
> > * Para ver as notas de versão de versões anteriores do GDKX, consulte as [publicações de notas de versão](https://aka.ms/gdkreleasenotes) 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](https://docs.xbox.com/pt-BR/announcements/gdk/release-notes.md).
>
> ***
>
> ## 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:
> >
> > ```cpp theme={null}
> > #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](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](https://github.com/microsoft/PackageUploader/releases).
>
> ### 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](https://docs.xbox.com/pt-BR/reference/system/xgameactivation/xgameactivation_members.md?view=gdk-2604).
> >
> > \[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](https://learn.microsoft.com/visualstudio/releases/2019/servicing-vs2019).
> >
> > 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](https://docs.xbox.com/pt-BR/gaming/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes#190). \[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](https://docs.xbox.com/pt-BR/gaming/playfab/multiplayer/networking/release-notes#11018). \[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](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](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](https://github.com/microsoft/Xbox-GDK-Samples/tree/main/Samples/Tools/BWOIExample/readme_en-us.md).
> >
> > **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)](https://aka.ms/gdkonline).
>
> ***

> [tab] GDK 2510
>
> ## Notas de versão do Microsoft Game Development Kit (GDK) de outubro de 2025
>
> ## Introdução
>
> Bem-vindo à versão de outubro de 2025 do Microsoft Game Development Kit. Você pode usar o GDK para desenvolver jogos que podem ser certificados e aprovados para lançamento em PCs com Windows 11 e PCs com Windows 10.
>
> ### Sobre este documento
>
> Organizamos este documento nas seções a seguir.
>
> * [Novidades](#whats-new-in-the-october-2025-microsoft-game-development-kit)
> * **Notas de versão:**
>   * [GDK de outubro de 2025 – Atualização 4](#october-2025-gdk-update-4)
>   * [GDK de outubro de 2025 – Atualização 3](#october-2025-gdk-update-3)
>   * [GDK de outubro de 2025 – Atualização 2](#october-2025-gdk-update-2)
>   * [GDK de outubro de 2025 – Atualização 1](#october-2025-gdk-update-1)
>   * [GDK de outubro de 2025](#october-2025-gdk)
> * [Problemas conhecidos](#known-issues)
> * [Documentação](#documentation)
>
> ### 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](https://docs.xbox.com/pt-BR/announcements/gdk/whats-new.md).
>
> ***
>
> ## 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](https://docs.xbox.com/pt-BR/announcements/gdk/whats-new.md).
> > * Para ver as notas de versão de versões anteriores, consulte as [publicações de notas de versão](https://aka.ms/gdkreleasenotes) nos fóruns do GDK ou veja as notas de versão na documentação online em [Notas de versão do GDK](https://docs.xbox.com/pt-BR/announcements/gdk/release-notes.md).
>
> ### 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](https://docs.xbox.com/pt-BR/reference/system/xgameactivation/xgameactivation_members.md?view=gdk-2604).
> >
> > \[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](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/system/dstorage/enums/dstorage_staging_buffer_size).
> >
> > \[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](https://docs.xbox.com/pt-BR/reference/system/dstorage/dstorage_members.md). \[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](https://aka.ms/get-takcli). \[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](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](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]
>
> ***

## Documentação de referência da API

* [Dstorage (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/dstorage/dstorage_members.md)


## Related topics

- [Novidades do Microsoft Game Development Kit (GDK)](https://docs.xbox.com/pt-BR/announcements/gdk/whats-new.md)
- [Extraindo o conteúdo de instalação do Microsoft Game Development Kit (GDK)](https://docs.xbox.com/pt-BR/build/console-features/build-without-install/extract-setup-payload.md)
- [Usar o Clang com o Microsoft Game Development Kit (GDK)](https://docs.xbox.com/pt-BR/tools/tools-pc/visualstudio/gr-vs-clang.md)
- [Notas de suporte do Visual Studio 2019](https://docs.xbox.com/pt-BR/tools/tools-pc/visualstudio/gr-vs-2019-support-notes.md)
- [Notas de suporte do GDK para o Visual Studio 2019](https://docs.xbox.com/pt-BR/tools/tools-console/visualstudio/vs-2019-support-notes.md)