PartyRegionsChangedStateChange

RegionsChanged 類型狀態變更的特定資訊。

語法

struct PartyRegionsChangedStateChange : PartyStateChange {  
    PartyStateChangeResult result;  
    PartyError errorDetail;  
}  

result PartyStateChangeResult 表示查詢支援區域清單及每個區域延遲的背景作業是否成功，或提供其失敗的原因。當結果為 PartyStateChangeResult::Succeeded 時，PartyManager::GetRegions() 所提供的區域清單會填入作業的結果。失敗時，PartyManager::GetRegions() 所提供的區域清單會是空的。

如果結果為 PartyStateChangeResult::FailedToBindToLocalUdpSocket，表示程式庫無法繫結至 PartyOption::LocalUdpSocketBindAddress 選項中指定的本機 UDP 通訊端。遊戲必須清除其程式庫執行個體，將 PartyOption::LocalUdpSocketBindAddress 選項更新為有效且可用的繫結位址，然後重新初始化程式庫。 errorDetail PartyError 診斷值，提供有關任何潛在錯誤狀況的更多疑難排解資訊。可透過 PartyManager::GetErrorMessage() 擷取此錯誤詳細資料的人類可讀形式。

擷取可用區域清單並測量與其連線品質的作業會在背景自動進行。此作業會在呼叫 PartyManager::Initialize() 時首次起始，除非使用 PartyOption::RegionUpdateConfiguration 選項將更新模式設定為 PartyRegionUpdateMode::Deferred，在此情況下可能完全不會進行區域更新。只有在應用程式以零項目的區域陣列呼叫 PartyManager::CreateNewNetwork()，或未連線至現有網路但以包含 PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState 的選項旗標呼叫 PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles()、PartyLocalChatControl::SetTextToSpeechProfile() 或 PartyLocalChatControl::SetTranscriptionOptions() 時，才會進行延遲的區域更新。PartyOption::RegionUpdateConfiguration 選項也可用來設定重新整理區域的間隔。

擷取可用區域清單並測量與其連線品質所需的時間，取決於許多環境或動態因素，以及是否使用了 PartyOption::RegionQualityMeasurementConfiguration 選項來修改低階測量設定。PartyRegionQualityMeasurementConfiguration 結構中的 totalMeasurementTimeoutInMilliseconds 欄位用來設定最壞情況下的最長逾時，超過此時間後就會將所有測量視為完成並產生此狀態變更。

標頭： Party.h