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

​

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.
• Renomeados dois tipos de solicitação de Account Management para distinguir os modelos de Client e Server:
  • 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.
• Alterado o tipo subjacente de PFGameSaveInitOptions 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 dessa 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 à versão de autenticação e à área restrita 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 adicionais de VM do Azure.
• Adicionados códigos de erro de serviço para novas condições de PlayStation Network, Nintendo, Economy, Experiments, Statistics, Segments, associação de entidade, endereço IP e Game Save.
• PFEntityRegisterTokenRefreshedEventHandler agora aceita uma fila de tarefas opcional.
• Adicionado E_PF_GAMESAVE_OPERATION_IN_PROGRESS para operações de Game Save rejeitadas porque outra operação mutuamente exclusiva está em andamento.
• Adicionado PF_GAMESAVE_MAX_SHORT_SAVE_DESCRIPTION_LENGTH, que define o comprimento 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.
• Atualizado PlayFab::Wrappers::Exception::what() para incluir o HRESULT em sua mensagem.
• Exportados os símbolos PF_API com visibilidade padrão no iOS e no macOS, e corrigida uma falha na inicialização no macOS ao usar o Apple Unified SDK.
• Corrigidas as substituições de operator delete dimensionado em cadeias de ferramentas baseadas em Clang para que os ganchos de memória personalizados sejam respeitados.
• Atualizados os projetos do GDK para usar a plataforma de projeto x64 exigida pelo layout do GDK 2510 e adicionado suporte para redirecionar projetos para o conjunto de ferramentas v145 do Visual Studio 2026.
• Fixada a dependência com.google.android.gms:play-services-games-v2 do Android na versão 21.0.0 para manter a compatibilidade com minSdkVersion 21.

​

Atualizações do Game Save

• Corrigidas falhas de transferência de blobs fora do PlayFab sendo relatadas como sucesso. As falhas de 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, localstate.json ausente e criação de arquivos marcadores para novos salvamentos.
• Corrigidas falhas de upload, bloqueio e conflito, incluindo loops infinitos de novo bloqueio, versões de manifesto desatualizadas, cadeias de versão base incorretas, seleção do perdedor do conflito, erros de serviço não repetíveis tratados incorretamente e uploads desnecessariamente lentos após a exclusão de diretórios.
• Corrigidos corrompimento de memória e condições de corrida do GDK no gerenciamento compartilhado de contexto do Game Save, e adicionada uma 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 transições de estado, enquanto PFGameSaveFilesUiProgressGetProgress pode ser sondado para obter o progresso em nível de bytes. Um total igual a zero agora significa que o total é desconhecido.
• Corrigidos o cancelamento e o comportamento offline do GRTS, aceitos caminhos com barras normais 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 dispositivos Steam Deck.

​

2504.0.0

• Migrada a análise de JSON de rapidjson para 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 gancho de memória, com a adição de uma nova API para recuperar os ganchos 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 para os operadores new/delete.

​

2410.0.0

• Adicionados cabeçalhos públicos, código-fonte e bibliotecas para uso com o Microsoft GDK à versão do GitHub
• 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 Economy API. Em vez disso, 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 com versões anteriores.
• 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 de impressão ao tentar registrar rastreamentos do XCurl
• Corrigidos vários avisos de análise de código estática

​

2403.0.0

• Lançamento de novas projeções do SDK com suporte para Linux, Android, iOS e macOS. As novas APIs expostas com esta versão são:
  • Para Android:
    • LoginWithFacebook
    • ClientLinkGoogleAccount
    • ClientLinkGooglePlayGamesServicesAccount
    • ClientUnlinkGoogleAccount
    • ClientUnlinkGooglePlayGamesServicesAccount
    • ClientAndroidDevicePushNotificationRegistration
    • RedeemGooglePlayInventoryItems
  • Para iOS:
    • LoginWithFacebook
    • ClientLinkApple
    • ClientUnlinkApple
    • ClientLinkGameCenterAccount
    • ClientUnlinkGameCenterAccount
    • ClientRegisterForIOSPushNotification
    • RedeemAppleAppStoreInventoryItems
• Adicionado suporte a Event Buffering em 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 opcional de gzip a PFEventPipelineConfig
• Removidas as chamadas de gerenciamento de TelemetryKey de PFEvents
• Adicionadas as chamadas de Client ausentes do PFCloudScript herdado:
  • ClientExecuteCloudScript
  • ExecuteEntityCloudScript
• Adicionadas as chamadas de Client ausentes de PFAccountManagement:
  • 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 jogos (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

• Versão inicial do SDK com suporte para Win32 e GDK