PlayFab Services C/C++ SDK リリース ノート

このリリース ノートは PlayFabCSdk を対象としています。その他の PlayFab Services SDK のリリース ノートについては、「その他の Services SDK リリース ノート」を参照してください。

​

2604.0.1

日付: 2026年9月4日

​

破壊的変更

• サービス API の廃止に伴い、PFInventoryGetMicrosoftStoreAccessTokensAsync、その結果関数、および要求と応答の型を削除しました。
• サービス API の廃止に伴い、PFSegmentsServerGetPlayersInSegmentAsync、その結果関数、およびそのサポート型を削除しました。
• PFAuthenticationGetEntityRequest から古い entity メンバーを削除しました。PFAuthenticationGetEntityAsync は、呼び出し元のエンティティに対してトークンを発行するようになりました。
• Client モデルと Server モデルを区別するために、Account Management の 2 つの要求型の名前を変更しました。
  • PFAccountManagementUnlinkAppleRequest は PFAccountManagementClientUnlinkAppleRequest になりました。
  • PFAccountManagementUnlinkGameCenterAccountRequest は PFAccountManagementClientUnlinkGameCenterAccountRequest になりました。
• 廃止された E_PF_COPILOT_DISABLED、E_PF_COPILOT_INVALID_REQUEST、E_PF_GET_PLAYERS_IN_SEGMENT_DEPRECATED、E_PF_GET_PLAYERS_IN_SEGMENT_RATE_LIMIT_EXCEEDED の各エラー コードを削除しました。
• PFGameSaveInitOptions の基になる型を uint32_t から uint64_t に変更しました。
• PFMultiplayerServerAzureVmSize に値を追加しました。挿入位置より後にある既存の値は新しい数値表現になるため、アプリケーションでは、この列挙型の数値を SDK バージョンをまたいで永続化または送信しないでください。

​

API の更新

• PFFriendsClientGetFriendsListRequest と PFFriendsServerGetFriendsListRequest に、オプションの namespaceWide メンバーを追加しました。これにより、現在のタイトルにサインインしたことのない、同じ名前空間のフレンドも含まれるようになります。
• 関連する Authentication、Account Management、およびユーザー情報のモデルに新しい authVersion、sandboxId、psnSandboxId メンバーを追加し、PlayStation Network の認証バージョンとサンドボックスをサポートしました。
• PFAccountManagementGetPlayFabIDsFromNintendoServiceAccountIdsRequest に issuer を追加しました。
• includeStatistics と、新しい PFStatisticColumn、PFStatisticColumnCollection、PFStatisticColumnCollectionDictionaryEntry 型を通じて、エンティティ プロファイルに統計データを追加しました。
• PFStatisticsStatisticUpdate に aggregationTargetEntityKeys を追加し、PFStatisticAggregationMethod 列挙型を追加しました。
• PFInventoryRedemptionSuccess に expirationTimestamp を、PFMultiplayerServerRequestPartyServiceResponse に region を追加し、さらに Azure VM サイズを追加しました。
• PlayStation Network、Nintendo、Economy、Experiments、Statistics、Segments、エンティティ メンバーシップ、IP アドレス、および Game Save の新しい状態に関するサービス エラー コードを追加しました。
• PFEntityRegisterTokenRefreshedEventHandler で、オプションのタスク キューを受け付けるようになりました。
• 相互に排他的な別の操作が進行中であるために拒否された Game Save 操作を示す E_PF_GAMESAVE_OPERATION_IN_PROGRESS を追加しました。
• 受け付けられる短いセーブ説明の最大長を 768 文字と定義する PF_GAMESAVE_MAX_SHORT_SAVE_DESCRIPTION_LENGTH を追加しました。

​

ランタイムとプラットフォームの更新

• 内部の HTTP 操作またはイベント パイプラインのフラッシュの進行中に PFUninitializeAsync がハングする問題を修正しました。
• 初期化時にトレース ログに SDK バージョンを出力するようにしました。
• PlayFab::Wrappers::Exception::what() を更新し、メッセージに HRESULT を含めるようにしました。
• iOS と macOS で PF_API シンボルを既定の可視性でエクスポートするようにし、Apple Unified SDK の使用時に macOS で起動時にクラッシュする問題を修正しました。
• Clang ベースのツールチェーンでサイズ付き operator delete のオーバーライドを修正し、カスタム メモリ フックが適用されるようにしました。
• GDK 2510 レイアウトで必要な x64 プロジェクト プラットフォームを使用するように GDK プロジェクトを更新し、Visual Studio 2026 の v145 ツールセットへのプロジェクトの再ターゲットのサポートを追加しました。
• minSdkVersion 21 との互換性を維持するために、Android の com.google.android.gms:play-services-games-v2 依存関係をバージョン 21.0.0 に固定しました。

​

Game Save の更新

• PlayFab 以外の BLOB 転送の失敗が成功として報告される問題を修正しました。HTTP の失敗時には、書き込まれていない BLOB に対してマニフェストが確定されることを許可するのではなく、失敗を示す HRESULT が返されるようになりました。
• 古い拡張マニフェスト URL、不完全なリモート ファイル セット、ダウンロード中のフォルダーの削除、localstate.json の欠落、新しいセーブでのマーカー ファイルの作成に関連する、データ損失と同期の問題を修正しました。
• 無限の再ロック ループ、古いマニフェスト バージョン、誤ったベース バージョン チェーン、競合で負ける側の選択、再試行不可能なサービス エラーの誤った処理、ディレクトリ削除後のアップロードの不必要な低速化など、アップロード、ロック、および競合の失敗を修正しました。
• 共有 Game Save コンテキスト管理における GDK のメモリ破損と競合状態を修正し、拡張マニフェストのパスがセーブ フォルダーの外に出ることを防ぐ検証を追加しました。
• 同期が Uploading 状態に入ったときに、セーブ フォルダーへのタイトルの書き込みアクセスを復元するようにしました。元のファイルは PreparingForUpload の間のみ読み取り専用になります。
• 進行状況の動作を明確にしました。PFGameSaveFilesUiProgressCallback は状態遷移を報告し、PFGameSaveFilesUiProgressGetProgress はバイト単位の進行状況をポーリングするために使用できます。合計が 0 の場合は、合計が不明であることを意味するようになりました。
• GRTS のキャンセルとオフラインの動作を修正し、Unreal Engine などのエンジンが生成するスラッシュ区切りのパスを受け付けるようにし、Windows と GDK における初期化、シャットダウン、デバイス ID、およびセーブ読み込みのいくつかの失敗を修正しました。
• Game Save のテレメトリが Steam Deck デバイスを誤って識別する問題を修正しました。

​

2504.0.0

日付: 2025年4月22日

• セキュリティと保守性を向上させるために、JSON 解析を rapidjson から nlohmann::json に移行しました。
• PFCore を初期化すると、タイトルによって設定されたトレース コールバックが上書きされる問題に対処しました。
• メモリ フック関数を変更し、既定のメモリ フックを取得する新しい API を追加するとともに、既存のメモリ割り当て関数にメモリ型 ID を含めるように変更しました。
• 複数のクライアントが関係する場合のトレースのクリーンアップに関連するバグを修正しました。
• PlayFab.C で PFAccountManagementSetDisplayNameAsync API を有効にしました。
• nlohmann JSON ライブラリ用のカスタム メモリ割り当てと、new/delete 演算子のグローバル オーバーライドを導入しました。

​

2410.0.0

日付: 2024年10月4日

• Microsoft GDK で使用するためのパブリック ヘッダー、ソース、およびライブラリを GitHub リリースに追加しました
• HTTP ライブラリである libHttpClient は、すべてのプラットフォームで動的ライブラリの依存関係になりました。 PlayFab Services が機能するためには、このライブラリをゲームの出荷パッケージに含める必要があります。
• Leaderboards と Statistics のパブリック プレビュー API を追加しました
• PFAuthenticationLoginWithFacebookRequest にオプションのパラメーター authenticationToken を追加しました
• 新しいサービス エラー コードのサポートを追加しました
• Economy API の引き換え応答から OfferId を削除しました。代わりに新しいフィールド MarketplaceAlternateId を追加しました。 呼び出し元は新しいフィールドに移行する必要がありますが、サービスは下位互換性のために引き続き両方のフィールドで応答します。
• PFFriendsExternalFriendSources で複数の選択ができない問題を解決しました

​

2406.0.0

日付: 2024年7月2日

• Linux と Android 向けに、PFEventPipelineConfig にオプションの gzip 圧縮のサポートを追加しました
• PFHttpSettings を使用した応答の自動 gzip 圧縮 (および展開) のサポートを追加しました
• XCurl トレースをログに記録しようとする際の出力の切り詰めを有効にしました
• さまざまな静的コード分析の警告を修正しました

​

2403.0.0

日付: 2024年2月28日

• Linux、Android、iOS、macOS をサポートする新しい SDK プロジェクションをリリースしました。このリリースで公開される新しい API は次のとおりです。
  • Android 向け:
    • LoginWithFacebook
    • ClientLinkGoogleAccount
    • ClientLinkGooglePlayGamesServicesAccount
    • ClientUnlinkGoogleAccount
    • ClientUnlinkGooglePlayGamesServicesAccount
    • ClientAndroidDevicePushNotificationRegistration
    • RedeemGooglePlayInventoryItems
  • iOS 向け:
    • LoginWithFacebook
    • ClientLinkApple
    • ClientUnlinkApple
    • ClientLinkGameCenterAccount
    • ClientUnlinkGameCenterAccount
    • ClientRegisterForIOSPushNotification
    • RedeemAppleAppStoreInventoryItems
• イベント パイプラインでのイベント バッファリングのサポートを追加しました。

​

2310.0.1

日付: 2023年9月28日

• Win32 に PFAccountManagementServerLinkNintendoServiceAccountSubjectAsync を追加しました

​

2310.0.0

日付: 2023年9月28日

• Nintendo Switch のサポートを追加しました (アクセスを要求するには、「Request access for secured SDKs and samples - PlayFab | Microsoft Learn」を参照してください)
• PFEventPipelineConfig にオプションの gzip compressionLevel を追加しました
• PFEvents から TelemetryKey 管理の呼び出しを削除しました
• 不足していた従来の PFCloudScript Client の呼び出しを追加しました:
  • ClientExecuteCloudScript
  • ExecuteEntityCloudScript
• 不足していた PFAccountManagement Client の呼び出しを追加しました:
  • 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
• ゲーム サーバーで使用することを目的とした多数の呼び出しを追加しました (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

日付: 2023年7月26日

• Win32 と GDK をサポートする SDK の初回リリース