> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HTTP 構成

> PFSetHttpRetrySettings と関連 API を使用して、PlayFab Services C SDK の HTTP 再試行、タイムアウト、およびレスポンス圧縮設定を構成します。

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

HTTP 設定は、[**PFInitialize**](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfcore/functions/pfinitialize.md) と [**PFServicesInitialize**](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfservices/functions/pfservicesinitialize.md) を呼び出した後、API 呼び出しを行う前に構成してください。

## 再試行設定

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

| フィールド | 型 | デフォルト | 説明 |
| - | - | - | - |
| `allowRetry` | `bool` | `true` | SDK が特定のエラーを自動的に再試行するかどうかを制御します。一部のエラーは再試行されず、常に直接返されます。 |
| `minimumRetryDelayInSeconds` | `uint32_t` | 2 | 失敗したリクエストを再試行するまで待機する最小秒数。2 秒未満に設定することはできません。 |
| `timeoutWindowInSeconds` | `uint32_t` | 20 | SDK がエラーを呼び出し元に返す前に再試行を試みる最大秒数。 |

SDK が自動的に再試行するエラーの詳細については、[PlayFab エラーの処理](https://docs.xbox.com/ja-jp/services/playfab/sdks/c/errors.md)を参照してください。

### 再試行設定の設定

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

```cpp theme={null}
PFHttpRetrySettings retrySettings{};
retrySettings.allowRetry = true;
retrySettings.minimumRetryDelayInSeconds = 4;
retrySettings.timeoutWindowInSeconds = 60;

HRESULT hr = PFSetHttpRetrySettings(&retrySettings);
if (FAILED(hr))
{
    // Handle error
}
```

### 再試行設定の取得

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

```cpp theme={null}
PFHttpRetrySettings currentSettings{};
HRESULT hr = PFGetHttpRetrySettings(&currentSettings);
if (SUCCEEDED(hr))
{
    printf("Retry enabled: %s\n", currentSettings.allowRetry ? "true" : "false");
    printf("Min delay: %u seconds\n", currentSettings.minimumRetryDelayInSeconds);
    printf("Timeout window: %u seconds\n", currentSettings.timeoutWindowInSeconds);
}
```

### 自動再試行の無効化

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

```cpp theme={null}
PFHttpRetrySettings retrySettings{};
retrySettings.allowRetry = false;
retrySettings.minimumRetryDelayInSeconds = 2;
retrySettings.timeoutWindowInSeconds = 20;

HRESULT hr = PFSetHttpRetrySettings(&retrySettings);
```

## HTTP 設定

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

| フィールド | 型 | デフォルト | 説明 |
| - | - | - | - |
| `requestResponseCompression` | `bool` | `false` | 有効になると、SDK は `Accept-Encoding` ヘッダーを `application/gzip` に設定することにより、API レスポンスを gzip 圧縮するようリクエストします。 |

### レスポンス圧縮の有効化

レスポンス圧縮を有効にすると帯域幅の使用量を削減でき、大きなペイロードを返す呼び出しに役立ちます。有効にするには **PFSetHttpSettings** を呼び出します:

```cpp theme={null}
PFHttpSettings httpSettings{};
httpSettings.requestResponseCompression = true;

HRESULT hr = PFSetHttpSettings(&httpSettings);
if (FAILED(hr))
{
    // Handle error
}
```

> [!NOTE]
>
> 圧縮されたレスポンスを解凍するには、**HCHttpCallPerformAsync** を呼び出す前に **HCHttpCallResponseSetGzipCompressed** を呼び出す必要があります。

### HTTP 設定の取得

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

```cpp theme={null}
PFHttpSettings currentSettings{};
HRESULT hr = PFGetHttpSettings(&currentSettings);
if (SUCCEEDED(hr))
{
    printf("Response compression: %s\n", currentSettings.requestResponseCompression ? "enabled" : "disabled");
}
```

## 典型的な初期化パターン

次の例は、HTTP 構成が全体的な SDK 初期化フローのどこに位置するかを示しています:

```cpp theme={null}
// 1. Initialize the SDK
HRESULT hr = PFInitialize(nullptr);
hr = PFServicesInitialize(nullptr);

// 2. Configure HTTP settings before making any API calls
PFHttpRetrySettings retrySettings{};
retrySettings.allowRetry = true;
retrySettings.minimumRetryDelayInSeconds = 2;
retrySettings.timeoutWindowInSeconds = 30;
PFSetHttpRetrySettings(&retrySettings);

PFHttpSettings httpSettings{};
httpSettings.requestResponseCompression = true;
PFSetHttpSettings(&httpSettings);

// 3. Create service config and begin making API calls
// ...
```


## Related topics

- [構成](https://docs.xbox.com/ja-jp/services/xbox-services/fundamentals/identity/privileges/config/index.md)
- [PSN イベント ストリームの構成](https://docs.xbox.com/ja-jp/services/playfab/api-references/rest/addons/addon/configure-psn-event-streams.md)
- [HCHttpDisableAssertsForSSLValidationInDevSandboxes](https://docs.xbox.com/ja-jp/reference/live/httpclient/httpclient/functions/hchttpdisableassertsforsslvalidationindevsandboxes.md)
- [Content Test Application (CTA) ストリーム構成](https://docs.xbox.com/ja-jp/build/core-features/common/game-streaming/game-streaming-content-test-application-stream-config.md)
- [カタログ構成の取得](https://docs.xbox.com/ja-jp/services/playfab/api-references/rest/economy/catalog/get-catalog-config.md)