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

# Notas de versão do SDK PlayFab Services para C/C++

> Índice das notas de versão do SDK PlayFab Services para C/C++ (PlayFabCSdk), acompanhando versões do SDK, novas APIs, preterições e correções de bugs entre os releases.

Estas notas de versão são do **PlayFabCSdk**. Para ver as notas de versão de outros SDKs do PlayFab Services, consulte [Notas de versão de outros SDKs de serviços](/pt-BR/services/playfab/release-notes).

<Note>
  Para notas de versão sobre lançamentos de serviço e atualizações de produto, veja a seção de [notas de versão](https://github.com/PlayFab/PlayFab/releases) no [repositório público do PlayFab no GitHub](https://github.com/PlayFab/PlayFab)
</Note>

## 2604.0.1

Data: 4 de setembro de 2026

### Alterações significativas

* Removidos `PFInventoryGetMicrosoftStoreAccessTokensAsync`, suas funções de resultado e seus tipos de solicitação e resposta após a desativação da API do serviço.
* Removidos `PFSegmentsServerGetPlayersInSegmentAsync`, suas funções de resultado e seus tipos de suporte após a desativação da API do serviço.
* Removido o membro obsoleto `entity` de `PFAuthenticationGetEntityRequest`. `PFAuthenticationGetEntityAsync` agora emite um token para a entidade chamadora.
* Dois tipos de solicitação de Account Management foram renomeados para distinguir os modelos de cliente e de servidor:
  * `PFAccountManagementUnlinkAppleRequest` agora é `PFAccountManagementClientUnlinkAppleRequest`.
  * `PFAccountManagementUnlinkGameCenterAccountRequest` agora é `PFAccountManagementClientUnlinkGameCenterAccountRequest`.
* Removidos os códigos de erro desativados `E_PF_COPILOT_DISABLED`, `E_PF_COPILOT_INVALID_REQUEST`, `E_PF_GET_PLAYERS_IN_SEGMENT_DEPRECATED` e `E_PF_GET_PLAYERS_IN_SEGMENT_RATE_LIMIT_EXCEEDED`.
* O tipo subjacente de `PFGameSaveInitOptions` foi alterado de `uint32_t` para `uint64_t`.
* Adicionados valores a `PFMultiplayerServerAzureVmSize`. Os valores existentes após os pontos de inserção têm novas representações numéricas, portanto os aplicativos não devem persistir nem transmitir o valor numérico desta enumeração entre versões do SDK.

### Atualizações de API

* Adicionado o membro opcional `namespaceWide` a `PFFriendsClientGetFriendsListRequest` e `PFFriendsServerGetFriendsListRequest`. Ele inclui amigos do mesmo namespace que não entraram no título atual.
* Adicionado suporte a versão de autenticação e sandbox da PlayStation Network por meio dos novos membros `authVersion`, `sandboxId` e `psnSandboxId` nos modelos relacionados de Authentication, Account Management e informações do usuário.
* Adicionado `issuer` a `PFAccountManagementGetPlayFabIDsFromNintendoServiceAccountIdsRequest`.
* Adicionados dados de estatísticas aos perfis de entidade por meio de `includeStatistics` e dos novos tipos `PFStatisticColumn`, `PFStatisticColumnCollection` e `PFStatisticColumnCollectionDictionaryEntry`.
* Adicionado `aggregationTargetEntityKeys` a `PFStatisticsStatisticUpdate` e adicionada a enumeração `PFStatisticAggregationMethod`.
* Adicionados `expirationTimestamp` a `PFInventoryRedemptionSuccess`, `region` a `PFMultiplayerServerRequestPartyServiceResponse` e tamanhos de VM do Azure adicionais.
* Adicionados códigos de erro de serviço para novas condições da PlayStation Network, Nintendo, Economy, Experiments, Statistics, Segments, associação de entidades, endereço IP e Game Save.
* `PFEntityRegisterTokenRefreshedEventHandler` agora aceita uma fila de tarefas opcional.
* Adicionado `E_PF_GAMESAVE_OPERATION_IN_PROGRESS` para operações do Game Save rejeitadas porque outra operação mutuamente exclusiva está em andamento.
* Adicionado `PF_GAMESAVE_MAX_SHORT_SAVE_DESCRIPTION_LENGTH`, que define o tamanho máximo aceito da descrição curta do salvamento como 768 caracteres.

### Atualizações de runtime e plataforma

* Corrigido o travamento de `PFUninitializeAsync` enquanto uma operação HTTP interna ou uma liberação do pipeline de eventos está em andamento.
* Adicionada a versão do SDK ao log de rastreamento durante a inicialização.
* `PlayFab::Wrappers::Exception::what()` foi atualizado para incluir o `HRESULT` em sua mensagem.
* Os símbolos `PF_API` passaram a ser exportados com visibilidade padrão no iOS e no macOS, e foi corrigida uma falha na inicialização no macOS ao usar o Apple Unified SDK.
* Corrigidas as substituições de `operator delete` com tamanho em toolchains baseadas no Clang, para que os hooks de memória personalizados sejam respeitados.
* Os projetos do GDK foram atualizados para usar a plataforma de projeto `x64` exigida pelo layout do GDK 2510, e foi adicionado suporte para redirecionar projetos para o conjunto de ferramentas `v145` do Visual Studio 2026.
* A dependência `com.google.android.gms:play-services-games-v2` do Android foi fixada na versão 21.0.0 para manter a compatibilidade com `minSdkVersion 21`.

### Atualizações do Game Save

* Corrigido o problema em que falhas de transferência de blob fora do PlayFab eram relatadas como êxito. As falhas HTTP agora retornam um `HRESULT` de falha, em vez de permitir que um manifesto seja finalizado com base em um blob que não foi gravado.
* Corrigidos problemas de perda de dados e de sincronização envolvendo URLs de manifesto estendido desatualizadas, conjuntos de arquivos remotos incompletos, exclusão de pastas durante o download, ausência de `localstate.json` e criação de arquivos marcadores para novos salvamentos.
* Corrigidas falhas de upload, bloqueio e conflito, incluindo loops infinitos de rebloqueio, versões de manifesto desatualizadas, cadeias de versão base incorretas, seleção do perdedor em conflitos, erros de serviço não repetíveis tratados incorretamente e uploads desnecessariamente lentos após a exclusão de diretórios.
* Corrigidos corrupção de memória e condições de corrida do GDK no gerenciamento compartilhado de contexto do Game Save, e adicionada validação que impede que caminhos de manifesto estendido escapem da pasta de salvamento.
* Restaurado o acesso de gravação do título à pasta de salvamento quando a sincronização entra no estado `Uploading`. Os arquivos originais ficam somente leitura durante `PreparingForUpload`.
* Esclarecido o comportamento do progresso: `PFGameSaveFilesUiProgressCallback` relata as transições de estado, enquanto `PFGameSaveFilesUiProgressGetProgress` pode ser consultado periodicamente para obter o progresso em bytes. Um total de zero agora significa que o total é desconhecido.
* Corrigidos o cancelamento e o comportamento offline do GRTS, aceitos caminhos com barra normal produzidos por mecanismos como o Unreal Engine, e corrigidas várias falhas de inicialização, desligamento, identidade do dispositivo e carregamento de salvamentos no Windows e no GDK.
* Corrigida a telemetria do Game Save que identificava incorretamente os dispositivos Steam Deck.

## 2504.0.0

Data: 22 de abril de 2025

* A análise de JSON foi migrada do rapidjson para o nlohmann::json para melhorar a segurança e a facilidade de manutenção.
* Resolvido um problema em que a inicialização do PFCore substituía o retorno de chamada de rastreamento definido pelo título.
* Alterações nas funções de hook de memória, com a adição de uma nova API para recuperar os hooks de memória padrão e a modificação das funções de alocação de memória existentes para incluir uma ID de tipo de memória.
* Corrigido um bug relacionado à limpeza do rastreamento quando há vários clientes envolvidos.
* Habilitada a API PFAccountManagementSetDisplayNameAsync no PlayFab.C.
* Introduzida a alocação de memória personalizada para a biblioteca JSON nlohmann e substituições globais dos operadores new/delete.

## 2410.0.0

Data: 4 de outubro de 2024

* Adicionados ao release do GitHub cabeçalhos públicos, código-fonte e bibliotecas para uso com o Microsoft GDK
* A biblioteca http, libHttpClient, agora é uma dependência de biblioteca dinâmica em todas as plataformas. Essa biblioteca deve ser incluída no pacote distribuído do jogo para que o PlayFab Services funcione.
* Adicionadas APIs em versão prévia pública para Leaderboards e Statistics
* Adicionado o parâmetro opcional authenticationToken a PFAuthenticationLoginWithFacebookRequest
* Adicionado suporte a novos códigos de erro de serviço
* Removido OfferId das respostas de resgate na API Economy. Em vez dele, foi adicionado o novo campo MarketplaceAlternateId. Os chamadores devem migrar para o novo campo, enquanto o serviço continuará respondendo com ambos os campos para manter a compatibilidade retroativa.
* Resolvido um problema em que PFFriendsExternalFriendSources não permitia várias seleções

## 2406.0.0

Data: 2 de julho de 2024

* Adicionado suporte à compactação gzip opcional em **PFEventPipelineConfig** para Linux e Android
* Adicionado suporte à compactação (e descompactação) gzip automática de respostas usando **PFHttpSettings**
* Habilitado o truncamento da impressão ao tentar registrar rastreamentos do XCurl
* Corrigidos vários avisos de análise estática de código

## 2403.0.0

Data: 28 de fevereiro de 2024

* Lançamento de novas projeções do SDK com suporte a Linux, Android, iOS e macOS. As novas APIs expostas com este release são:
  * **Para Android**:
    * LoginWithFacebook
    * ClientLinkGoogleAccount
    * ClientLinkGooglePlayGamesServicesAccount
    * ClientUnlinkGoogleAccount
    * ClientUnlinkGooglePlayGamesServicesAccount
    * ClientAndroidDevicePushNotificationRegistration
    * RedeemGooglePlayInventoryItems
  * **Para iOS**:
    * LoginWithFacebook
    * ClientLinkApple
    * ClientUnlinkApple
    * ClientLinkGameCenterAccount
    * ClientUnlinkGameCenterAccount
    * ClientRegisterForIOSPushNotification
    * RedeemAppleAppStoreInventoryItems
* Adicionado suporte ao buffer de eventos nos pipelines de eventos.

## 2310.0.1

Data: 28 de setembro de 2023

* Adicionado PFAccountManagementServerLinkNintendoServiceAccountSubjectAsync ao Win32

## 2310.0.0

Data: 28 de setembro de 2023

* Adicionado suporte ao Nintendo Switch (consulte Request access for secured SDKs and samples - PlayFab | Microsoft Learn para solicitar acesso)
* Adicionado o compressionLevel gzip opcional a **PFEventPipelineConfig**
* Removidas as chamadas de gerenciamento de TelemetryKey de **PFEvents**
* Adicionadas as chamadas de cliente herdadas de **PFCloudScript** que estavam ausentes:
  * ClientExecuteCloudScript
  * ExecuteEntityCloudScript
* Adicionadas as chamadas de cliente de **PFAccountManagement** que estavam ausentes:
  * ClientAddOrUpdateContactEmail
  * ClientAddUsernamePassword
  * ClientGetPlayFabIDsFromFacebookIDs
  * ClientGetPlayFabIDsFromFacebookInstantGamesIds
  * ClientGetPlayFabIDsFromGameCenterIDs
  * ClientGetPlayFabIDsFromGoogleIDs
  * ClientGetPlayFabIDsFromGooglePlayGamesPlayerIDs
  * ClientGetPlayFabIDsFromKongregateIDs
  * ClientGetPlayFabIDsFromNintendoServiceAccountIds
  * ClientGetPlayFabIDsFromNintendoSwitchDeviceIds
  * ClientGetPlayFabIDsFromPSNAccountIDs
  * ClientGetPlayFabIDsFromTwitchIDs
  * ClientLinkAndroidDeviceID
  * ClientLinkApple
  * ClientLinkFacebookAccount
  * ClientLinkFacebookInstantGamesId
  * ClientLinkGameCenterAccount
  * ClientLinkGoogleAccount
  * ClientLinkGooglePlayGamesServicesAccount
  * ClientLinkIOSDeviceID
  * ClientLinkKongregate
  * ClientLinkNintendoServiceAccount
  * ClientLinkNintendoSwitchDeviceId
  * ClientLinkPSNAccount
  * ClientLinkTwitch
  * ClientRemoveContactEmail
  * ClientSendAccountRecoveryEmail
  * ClientUnlinkAndroidDeviceID
  * ClientUnlinkApple
  * ClientUnlinkFacebookAccount
  * ClientUnlinkFacebookInstantGamesId
  * ClientUnlinkGameCenterAccount
  * ClientUnlinkGoogleAccount
  * ClientUnlinkGooglePlayGamesServicesAccount
  * ClientUnlinkIOSDeviceID
  * ClientUnlinkKongregate
  * ClientUnlinkNintendoServiceAccount
  * ClientUnlinkNintendoSwitchDeviceId
  * ClientUnlinkPSNAccount
  * ClientUnlinkTwitch
  * ClientUpdateUserTitleDisplayName
* Adicionadas muitas chamadas destinadas ao uso por servidores de jogo (somente para Win32)
  * **PFAuthentication**
    * ServerLoginWithServerCustomId
    * ServerLoginWithSteamId
    * ServerLoginWithXbox
    * ServerLoginWithXboxId
    * AuthenticateGameServerWithCustomId
    * Delete
    * GetEntity
    * ValidateEntityToken
  * **PFAccountManagement**
    * ServerBanUsers
    * ServerDeletePlayer
    * ServerGetPlayerCombinedInfo
    * ServerGetPlayerProfile
    * ServerGetPlayFabIDsFromFacebookIDs
    * ServerGetPlayFabIDsFromFacebookInstantGamesIds
    * ServerGetPlayFabIDsFromNintendoServiceAccountIds
    * ServerGetPlayFabIDsFromNintendoSwitchDeviceIds
    * ServerGetPlayFabIDsFromPSNAccountIDs
    * ServerGetPlayFabIDsFromSteamIDs
    * ServerGetPlayFabIDsFromTwitchIDs
    * ServerGetPlayFabIDsFromXboxLiveIDs
    * ServerGetServerCustomIDsFromPlayFabIDs
    * ServerGetUserAccountInfo
    * ServerGetUserBans
    * ServerLinkNintendoServiceAccount
    * ServerLinkNintendoSwitchDeviceId
    * ServerLinkPSNAccount
    * ServerLinkServerCustomId
    * ServerLinkSteamId
    * ServerLinkXboxAccount
    * ServerRevokeAllBansForUser
    * ServerRevokeBans
    * ServerSendCustomAccountRecoveryEmail
    * ServerSendEmailFromTemplate
    * ServerUnlinkNintendoServiceAccount
    * ServerUnlinkNintendoSwitchDeviceId
    * ServerUnlinkPSNAccount
    * ServerUnlinkServerCustomId
    * ServerUnlinkSteamId
    * ServerUnlinkXboxAccount
    * ServerUpdateAvatarUrl
    * ServerUpdateBans
    * GetTitlePlayersFromXboxLiveIDs
  * **PFCloudScript**
    * ServerExecuteCloudScript
  * **PFFriends**
    * ServerAddFriend
    * ServerGetFriendsList
    * ServerRemoveFriend
    * ServerSetFriendTags
  * **PFInventory**
    * GetTransactionHistory
  * **PFLocalization**
    * GetLanguageList
  * **PFPlatformSpecific**
    * ServerAwardSteamAchievement
  * **PFPlayerDataManagement**
    * ServerGetUserData
    * ServerGetUserInternalData
    * ServerGetUserPublisherData
    * ServerGetUserPublisherInternalData
    * ServerGetUserPublisherReadOnlyData
    * ServerGetUserReadOnlyData
    * ServerUpdateUserData
    * ServerUpdateUserInternalData
    * ServerUpdateUserPublisherData
    * ServerUpdateUserPublisherInternalData
    * ServerUpdateUserPublisherReadOnlyData
    * ServerUpdateUserReadOnlyData
  * **PFPushNotifications**
    * ServerSendPushNotification
    * ServerSendPushNotificationFromTemplate
  * **PFSegments**
    * ServerAddPlayerTag
    * ServerGetAllSegments
    * ServerGetPlayerSegments
    * ServerGetPlayersInSegment
    * ServerGetPlayerTags
    * ServerRemovePlayerTag
  * **PFTitleDataManagement**
    * ServerGetPublisherData
    * ServerGetTime
    * ServerGetTitleData
    * ServerGetTitleInternalData
    * ServerGetTitleNews
    * ServerSetPublisherData
    * ServerSetTitleData
    * ServerSetTitleInternalData

## 2306.0.0

Data: 26 de julho de 2023

* Release inicial do SDK com suporte a Win32 e GDK


## Related topics

- [Notas de versão](/pt-BR/tools/tools-pc/xbox-pc-remote-tools/release-notes/index.md)
- [Notas de versão do SDK PlayFab Services 2023](/pt-BR/services/playfab/release-notes/2023.md)
- [Notas de versão do SDK PlayFab Services 2024](/pt-BR/services/playfab/release-notes/2024.md)
- [Notas de versão do SDK PlayFab Services 2025](/pt-BR/services/playfab/release-notes/2025.md)
- [Notas de versão do SDK PlayFab Services 2026](/pt-BR/services/playfab/release-notes/index.md)