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

再試行設定

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

再試行設定の設定

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

再試行設定の取得

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

自動再試行の無効化

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

HTTP 設定

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

レスポンス圧縮の有効化

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

HTTP 設定の取得

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

典型的な初期化パターン

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