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

​

2604.0.1

​

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

• 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

• 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

• 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

• 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

• Adicionado PFAccountManagementServerLinkNintendoServiceAccountSubjectAsync ao Win32

​

2310.0.0

• 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

• Release inicial do SDK com suporte a Win32 e GDK