HTTP 設定

PlayFab Services SDK 提供可設定 HTTP 要求發出方式的函式，包括自動重試行為和回應壓縮。這些設定是全域的，並套用至 SDK 發出的所有 PlayFab API 呼叫。請在呼叫 PFInitialize 和 PFServicesInitialize 之後、進行任何 API 呼叫之前設定 HTTP 設定。

重試設定

PFHttpRetrySettings 結構會控制 SDK 如何處理暫時性的 HTTP 失敗，例如節流錯誤 (HTTP 429)。根據預設，SDK 會採用退避機制自動重試這些失敗。

欄位	類型	預設值	描述
`allowRetry`	`bool`	`true`	控制 SDK 是否自動重試特定錯誤。某些錯誤永遠不會重試，一律會直接傳回。
`minimumRetryDelayInSeconds`	`uint32_t`	2	重試失敗要求之前等候的最少秒數。不能設定為低於 2 秒。
`timeoutWindowInSeconds`	`uint32_t`	20	SDK 在將錯誤傳回給呼叫端之前嘗試重試的最長秒數。

如需 SDK 會自動重試哪些錯誤的詳細資訊，請參閱處理 PlayFab 錯誤。

設定重試設定

呼叫 PFSetHttpRetrySettings 以自訂重試行為。例如，若要為可容忍較長等候時間的呼叫增加重試時間範圍：

PFHttpRetrySettings retrySettings{};
retrySettings.allowRetry = true;
retrySettings.minimumRetryDelayInSeconds = 4;
retrySettings.timeoutWindowInSeconds = 60;

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

取得重試設定

呼叫 PFGetHttpRetrySettings 以擷取目前的重試設定：

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);
}

停用自動重試

如果您想要自行處理所有重試邏輯，請停用自動重試：

PFHttpRetrySettings retrySettings{};
retrySettings.allowRetry = false;
retrySettings.minimumRetryDelayInSeconds = 2;
retrySettings.timeoutWindowInSeconds = 20;

HRESULT hr = PFSetHttpRetrySettings(&retrySettings);

PFHttpSettings 結構會控制所有 SDK 要求的一般 HTTP 行為。

欄位	類型	預設值	描述
`requestResponseCompression`	`bool`	`false`	啟用時，SDK 會將 `Accept-Encoding` 標頭設定為 `application/gzip`，要求以 gzip 壓縮 API 回應。

啟用回應壓縮

啟用回應壓縮可以降低頻寬使用量，對於傳回大型承載的呼叫很有用。呼叫 PFSetHttpSettings 以啟用它：

PFHttpSettings httpSettings{};
httpSettings.requestResponseCompression = true;

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

若要解壓縮已壓縮的回應，必須在呼叫 HCHttpCallPerformAsync 之前呼叫 HCHttpCallResponseSetGzipCompressed。

取得 HTTP 設定

呼叫 PFGetHttpSettings 以擷取目前的 HTTP 設定：

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

典型的初始化模式

下列範例示範 HTTP 設定在整體 SDK 初始化流程中的位置：

// 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
// ...

​重試設定

​設定重試設定

​取得重試設定

​停用自動重試

​HTTP 設定

​啟用回應壓縮

​取得 HTTP 設定

​典型的初始化模式

重試設定

設定重試設定

取得重試設定

停用自動重試

HTTP 設定

啟用回應壓縮

取得 HTTP 設定

典型的初始化模式