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

​

2604.0.1

​

Changements cassants

• Retrait de PFInventoryGetMicrosoftStoreAccessTokensAsync, de ses fonctions de résultat et de ses types de requête et de réponse, à la suite du retrait de l’API du service.
• Retrait de PFSegmentsServerGetPlayersInSegmentAsync, de ses fonctions de résultat et de ses types connexes, à la suite du retrait de l’API du service.
• Retrait du membre obsolète entity de PFAuthenticationGetEntityRequest. PFAuthenticationGetEntityAsync émet maintenant un jeton pour l’entité appelante.
• Changement du nom de deux types de requête Account Management afin de distinguer les modèles Client et Server :
  • PFAccountManagementUnlinkAppleRequest devient PFAccountManagementClientUnlinkAppleRequest.
  • PFAccountManagementUnlinkGameCenterAccountRequest devient PFAccountManagementClientUnlinkGameCenterAccountRequest.
• Retrait 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.
• Changement du type sous-jacent de PFGameSaveInitOptions 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 des 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 dans les modèles Authentication, Account Management et d’informations utilisateur connexes.
• Ajout d’issuer à PFAccountManagementGetPlayFabIDsFromNintendoServiceAccountIdsRequest.
• Ajout de données statistiques aux profils d’entité au moyen d’includeStatistics et des nouveaux types PFStatisticColumn, PFStatisticColumnCollection et PFStatisticColumnCollectionDictionaryEntry.
• Ajout d’aggregationTargetEntityKeys à PFStatisticsStatisticUpdate et ajout de l’énumération PFStatisticAggregationMethod.
• Ajout d’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 maintenant une file d’attente de tâches facultative.
• Ajout d’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 à 768 caractères la longueur maximale acceptée pour la description courte d’une sauvegarde.

​

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 suivi 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 crochets de mémoire personnalisés soient respectés.
• Mise à jour des projets GDK pour utiliser la plateforme de projet x64 exigée 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 de blobs hors PlayFab qui étaient signalés comme des réussites. Les échecs HTTP retournent maintenant un HRESULT d’échec au lieu de permettre la finalisation d’un manifeste par rapport à un blob qui n’a pas été écrit.
• Correction de problèmes de perte de données et de synchronisation liés aux URL de manifeste étendu périmées, aux 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 téléversement, de verrouillage et de conflit, notamment les boucles de reverrouillage infinies, les versions de manifeste périmées, les chaînes de versions de base incorrectes, la sélection de la version perdante d’un conflit, la mauvaise gestion des erreurs de service non réessayables et la lenteur inutile des téléversements après la suppression d’un répertoire.
• Correction d’une corruption de mémoire et de conditions de concurrence GDK dans la gestion du contexte Game Save partagé, 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 de zéro signifie maintenant que le total est inconnu.
• Correction de l’annulation et du comportement hors ligne de GRTS, acceptation des chemins avec barres obliques produits par des moteurs comme Unreal Engine, et correction de plusieurs échecs Windows et GDK liés à l’initialisation, à l’arrêt, à l’identité de l’appareil et au chargement des sauvegardes.
• 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 où l’initialisation de PFCore écrasait le rappel de suivi défini par le titre.
• Modifications des fonctions de crochets de mémoire : ajout d’une nouvelle API pour récupérer les crochets de mémoire par défaut et modification des fonctions d’allocation de mémoire existantes pour inclure un identifiant de type de mémoire.
• Correction d’un bogue lié au nettoyage du suivi lorsque plusieurs clients sont en jeu.
• 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 substitutions globales pour les opérateurs new/delete.

​

2410.0.0

• Ajout à la version GitHub d’en-têtes publics, de code source et de bibliothèques à utiliser avec le Microsoft GDK
• La bibliothèque HTTP, libHttpClient, est maintenant 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 de service
• Retrait d’OfferId des réponses d’échange dans l’API Economy. Ajout du nouveau champ MarketplaceAlternateId à la place. Les appelants doivent passer au nouveau champ, mais le service continuera de répondre avec les deux champs pour assurer la rétrocompatibilité.
• Résolution d’un problème où PFFriendsExternalFriendSources ne permettait 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 (et de la décompression) gzip automatique des réponses au moyen 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 dans 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 facultatif de compression gzip compressionLevel à PFEventPipelineConfig
• Retrait 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

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