Notes de publication du SDK C/C++ PlayFab Services

​

2604.0.1

​

Modifications cassantes

• Suppression de PFInventoryGetMicrosoftStoreAccessTokensAsync, de ses fonctions de résultat et de ses types de requête et de réponse, suite au retrait de l’API du service.
• Suppression de PFSegmentsServerGetPlayersInSegmentAsync, de ses fonctions de résultat et de ses types associés, suite au retrait de l’API du service.
• Suppression du membre obsolète entity de PFAuthenticationGetEntityRequest. PFAuthenticationGetEntityAsync émet désormais un jeton pour l’entité appelante.
• Renommage de deux types de requêtes Account Management afin de distinguer les modèles Client et Server :
  • PFAccountManagementUnlinkAppleRequest devient PFAccountManagementClientUnlinkAppleRequest.
  • PFAccountManagementUnlinkGameCenterAccountRequest devient PFAccountManagementClientUnlinkGameCenterAccountRequest.
• Suppression des codes d’erreur retirés E_PF_COPILOT_DISABLED, E_PF_COPILOT_INVALID_REQUEST, E_PF_GET_PLAYERS_IN_SEGMENT_DEPRECATED et E_PF_GET_PLAYERS_IN_SEGMENT_RATE_LIMIT_EXCEEDED.
• Le type sous-jacent de PFGameSaveInitOptions passe de uint32_t à uint64_t.
• Ajout de valeurs à PFMultiplayerServerAzureVmSize. Les valeurs existantes situées après les points d’insertion ont de nouvelles représentations numériques : les applications ne doivent donc pas conserver ni transmettre la valeur numérique de cette énumération d’une version du SDK à l’autre.

​

Mises à jour de l’API

• Ajout du membre facultatif namespaceWide à PFFriendsClientGetFriendsListRequest et PFFriendsServerGetFriendsListRequest. Il inclut les amis du même espace de noms qui ne se sont pas connectés au titre actuel.
• Ajout de la prise en charge de la version d’authentification et des sandbox PlayStation Network via les nouveaux membres authVersion, sandboxId et psnSandboxId des modèles Authentication, Account Management et d’informations utilisateur concernés.
• Ajout de issuer à PFAccountManagementGetPlayFabIDsFromNintendoServiceAccountIdsRequest.
• Ajout des données de statistiques aux profils d’entité via includeStatistics et les nouveaux types PFStatisticColumn, PFStatisticColumnCollection et PFStatisticColumnCollectionDictionaryEntry.
• Ajout de aggregationTargetEntityKeys à PFStatisticsStatisticUpdate et ajout de l’énumération PFStatisticAggregationMethod.
• Ajout de expirationTimestamp à PFInventoryRedemptionSuccess, de region à PFMultiplayerServerRequestPartyServiceResponse, ainsi que de tailles de machines virtuelles Azure supplémentaires.
• Ajout de codes d’erreur du service pour de nouvelles conditions liées à PlayStation Network, Nintendo, Economy, Experiments, Statistics, Segments, l’appartenance d’entités, les adresses IP et Game Save.
• PFEntityRegisterTokenRefreshedEventHandler accepte désormais une file d’attente de tâches facultative.
• Ajout de E_PF_GAMESAVE_OPERATION_IN_PROGRESS pour les opérations Game Save rejetées parce qu’une autre opération mutuellement exclusive est en cours.
• Ajout de PF_GAMESAVE_MAX_SHORT_SAVE_DESCRIPTION_LENGTH, qui définit la longueur maximale acceptée de la description courte d’une sauvegarde à 768 caractères.

​

Mises à jour de l’exécution et des plateformes

• Correction du blocage de PFUninitializeAsync lorsqu’une opération HTTP interne ou un vidage du pipeline d’événements est en cours.
• Ajout de la version du SDK au journal de trace lors de l’initialisation.
• Mise à jour de PlayFab::Wrappers::Exception::what() pour inclure le HRESULT dans son message.
• Exportation des symboles PF_API avec une visibilité par défaut sur iOS et macOS, et correction d’un plantage au lancement sur macOS lors de l’utilisation de l’Apple Unified SDK.
• Correction des substitutions de l’operator delete dimensionné sur les chaînes d’outils basées sur Clang, afin que les hooks de mémoire personnalisés soient respectés.
• Mise à jour des projets GDK pour utiliser la plateforme de projet x64 requise par la disposition du GDK 2510, et ajout de la prise en charge du reciblage des projets vers l’ensemble d’outils v145 de Visual Studio 2026.
• Épinglage de la dépendance Android com.google.android.gms:play-services-games-v2 à la version 21.0.0 pour conserver la compatibilité avec minSdkVersion 21.

​

Mises à jour de Game Save

• Correction des échecs de transfert de blobs hors PlayFab signalés comme des réussites. Les échecs HTTP renvoient désormais un HRESULT d’échec au lieu de permettre la finalisation d’un manifeste sur un blob qui n’a pas été écrit.
• Correction de problèmes de perte de données et de synchronisation liés à des URL de manifeste étendu obsolètes, à des ensembles de fichiers distants incomplets, à la suppression de dossiers pendant le téléchargement, à l’absence de localstate.json et à la création de fichiers marqueurs pour les nouvelles sauvegardes.
• Correction d’échecs de chargement, de verrouillage et de conflit, notamment des boucles de reverrouillage infinies, des versions de manifeste obsolètes, des chaînes de versions de base incorrectes, la sélection du perdant d’un conflit, des erreurs de service non réessayables mal gérées et des chargements inutilement lents après la suppression d’un répertoire.
• Correction de corruptions de mémoire et de conditions de concurrence sur GDK dans la gestion du contexte Game Save partagé, et ajout d’une validation empêchant les chemins de manifeste étendu de sortir du dossier de sauvegarde.
• Rétablissement de l’accès en écriture du titre au dossier de sauvegarde lorsque la synchronisation passe à l’état Uploading. Les fichiers d’origine sont en lecture seule uniquement pendant PreparingForUpload.
• Clarification du comportement de progression : PFGameSaveFilesUiProgressCallback signale les transitions d’état, tandis que PFGameSaveFilesUiProgressGetProgress peut être interrogé pour connaître la progression au niveau des octets. Un total égal à zéro signifie désormais que le total est inconnu.
• Correction de l’annulation et du comportement hors connexion de GRTS, acceptation des chemins avec barres obliques produits par des moteurs tels qu’Unreal Engine, et correction de plusieurs échecs d’initialisation, d’arrêt, d’identité d’appareil et de chargement de sauvegardes sur Windows et GDK.
• Correction de la télémétrie Game Save qui identifiait incorrectement les appareils Steam Deck.

​

2504.0.0

• Migration de l’analyse JSON de rapidjson vers nlohmann::json pour améliorer la sécurité et la maintenabilité.
• Résolution d’un problème qui faisait que l’initialisation de PFCore écrasait le rappel de trace défini par le titre.
• Modifications des fonctions de hook de mémoire : ajout d’une nouvelle API permettant de récupérer les hooks de mémoire par défaut et modification des fonctions d’allocation de mémoire existantes pour inclure un ID de type de mémoire.
• Correction d’un bogue lié au nettoyage du traçage lorsque plusieurs clients sont impliqués.
• Activation de l’API PFAccountManagementSetDisplayNameAsync dans PlayFab.C.
• Introduction d’une allocation de mémoire personnalisée pour la bibliothèque JSON nlohmann et de substitutions globales des opérateurs new/delete.

​

2410.0.0

• Ajout à la version GitHub des en-têtes publics, des sources et des bibliothèques destinés à être utilisés avec le Microsoft GDK
• La bibliothèque http, libHttpClient, est désormais une dépendance de bibliothèque dynamique sur toutes les plateformes. Cette bibliothèque doit être incluse dans le package livré du jeu pour que PlayFab Services fonctionne.
• Ajout des API en préversion publique pour Leaderboards et Statistics
• Ajout du paramètre facultatif authenticationToken à PFAuthenticationLoginWithFacebookRequest
• Ajout de la prise en charge de nouveaux codes d’erreur du service
• Suppression d’OfferId des réponses d’échange dans l’API Economy. Le nouveau champ MarketplaceAlternateId a été ajouté à la place. Les appelants doivent passer au nouveau champ, tandis que le service continuera à renvoyer les deux champs à des fins de rétrocompatibilité.
• Résolution d’un problème qui empêchait PFFriendsExternalFriendSources d’autoriser plusieurs sélections

​

2406.0.0

• Ajout de la prise en charge de la compression gzip facultative à PFEventPipelineConfig pour Linux et Android
• Ajout de la prise en charge de la compression gzip automatique des réponses (et de leur décompression) à l’aide de PFHttpSettings
• Activation de la troncature de l’affichage lors de la tentative de journalisation des traces XCurl
• Correction de divers avertissements d’analyse statique du code

​

2403.0.0

• Publication de nouvelles projections du SDK prenant en charge Linux, Android, iOS et macOS. Les nouvelles API exposées avec cette version sont les suivantes :
  • Pour Android :
    • LoginWithFacebook
    • ClientLinkGoogleAccount
    • ClientLinkGooglePlayGamesServicesAccount
    • ClientUnlinkGoogleAccount
    • ClientUnlinkGooglePlayGamesServicesAccount
    • ClientAndroidDevicePushNotificationRegistration
    • RedeemGooglePlayInventoryItems
  • Pour iOS :
    • LoginWithFacebook
    • ClientLinkApple
    • ClientUnlinkApple
    • ClientLinkGameCenterAccount
    • ClientUnlinkGameCenterAccount
    • ClientRegisterForIOSPushNotification
    • RedeemAppleAppStoreInventoryItems
• Ajout de la prise en charge de la mise en mémoire tampon des événements dans les pipelines d’événements.

​

2310.0.1

• Ajout de PFAccountManagementServerLinkNintendoServiceAccountSubjectAsync à Win32

​

2310.0.0

• Ajout de la prise en charge de Nintendo Switch (consultez Request access for secured SDKs and samples - PlayFab | Microsoft Learn pour demander l’accès)
• Ajout du paramètre gzip facultatif compressionLevel à PFEventPipelineConfig
• Suppression des appels de gestion de TelemetryKey de PFEvents
• Ajout des appels Client PFCloudScript hérités manquants :
  • ClientExecuteCloudScript
  • ExecuteEntityCloudScript
• Ajout des appels Client PFAccountManagement manquants :
  • 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
• Ajout de nombreux appels destinés aux serveurs de jeu (uniquement pour 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

• Version initiale du SDK, prenant en charge Win32 et GDK