Skip to main content
PlayFab Services SDK は、自動再試行の動作やレスポンス圧縮を含め、HTTP リクエストの実行方法を構成する関数を提供します。これらの設定はグローバルであり、SDK によって行われるすべての PlayFab API 呼び出しに適用されます。 HTTP 設定は、PFInitializePFServicesInitialize を呼び出した後、API 呼び出しを行う前に構成してください。

再試行設定

PFHttpRetrySettings 構造体は、スロットリングエラー (HTTP 429) などの一時的な HTTP 失敗を SDK がどのように処理するかを制御します。デフォルトでは、SDK はこれらの失敗をバックオフ付きで自動的に再試行します。 SDK が自動的に再試行するエラーの詳細については、PlayFab エラーの処理を参照してください。

再試行設定の設定

再試行動作をカスタマイズするには PFSetHttpRetrySettings を呼び出します。たとえば、長い待機を許容できる呼び出しの再試行ウィンドウを増やすには:

再試行設定の取得

現在の再試行構成を取得するには PFGetHttpRetrySettings を呼び出します:

自動再試行の無効化

すべての再試行ロジックを自分で処理したい場合は、自動再試行を無効にします:

HTTP 設定

PFHttpSettings 構造体は、すべての SDK リクエストの一般的な HTTP 動作を制御します。

レスポンス圧縮の有効化

レスポンス圧縮を有効にすると帯域幅の使用量を削減でき、大きなペイロードを返す呼び出しに役立ちます。有効にするには PFSetHttpSettings を呼び出します:
圧縮されたレスポンスを解凍するには、HCHttpCallPerformAsync を呼び出す前に HCHttpCallResponseSetGzipCompressed を呼び出す必要があります。

HTTP 設定の取得

現在の HTTP 構成を取得するには PFGetHttpSettings を呼び出します:

典型的な初期化パターン

次の例は、HTTP 構成が全体的な SDK 初期化フローのどこに位置するかを示しています:
最終更新日 2026年8月25日