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

​

2604.0.1

​

Modifications avec rupture

• 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ête 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.
• Modification du type sous-jacent de PFGameSaveInitOptions de uint32_t en 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 du bac à sable PlayStation Network grâce aux nouveaux membres authVersion, sandboxId et psnSandboxId sur les modèles Authentication, Account Management et d’informations utilisateur associés.
• Ajout de issuer à PFAccountManagementGetPlayFabIDsFromNintendoServiceAccountIdsRequest.
• Ajout de données de statistiques aux profils d’entité grâce à includeStatistics et aux 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 de service pour de nouvelles conditions liées à PlayStation Network, Nintendo, Economy, Experiments, Statistics, Segments, à l’appartenance d’entité, aux 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 du runtime 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() afin d’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 surcharges 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 afin de conserver la compatibilité avec minSdkVersion 21.

​

Mises à jour de Game Save

• Correction des échecs de transfert d’objets blob hors PlayFab qui étaient 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 objet 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 de la sauvegarde perdante en cas de conflit, des erreurs de service non renouvelables mal gérées et des chargements inutilement lents après la suppression d’un répertoire.
• Correction d’une corruption de mémoire et de conditions de concurrence GDK dans la gestion partagée du contexte Game Save, et ajout d’une validation qui empêche 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 la progression : PFGameSaveFilesUiProgressCallback signale les transitions d’état, tandis que PFGameSaveFilesUiProgressGetProgress peut être interrogé pour obtenir 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 sous 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 une sécurité et une maintenabilité améliorées.
• Résolution d’un problème où 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 pour récupérer les hooks de mémoire par défaut et modification des fonctions d’allocation de mémoire existantes afin d’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 de l’allocation de mémoire personnalisée pour la bibliothèque JSON nlohmann et de surcharges globales pour les opérateurs new/delete.

​

2410.0.0

• Ajout à la version GitHub des en-têtes publics, du code source et des bibliothèques à utiliser 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 d’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 de service
• Suppression d’OfferId des réponses d’échange dans l’API Economy. Ajout à la place du nouveau champ MarketplaceAlternateId. Les appelants doivent passer au nouveau champ, tandis que le service continuera de répondre avec les deux champs pour assurer la rétrocompatibilité.
• Résolution d’un problème où PFFriendsExternalFriendSources n’autorisait pas les sélections multiples

​

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 la 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 avec prise en charge de 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 (Event Buffering) 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 hérités manquants de PFCloudScript :
  • ClientExecuteCloudScript
  • ExecuteEntityCloudScript
• Ajout des appels Client manquants 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
• 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

• Publication initiale du SDK avec prise en charge de Win32 et GDK