PartyRegionUpdateMode

組態模式，代表 Party 程式庫如何在 PartyRegionUpdateConfiguration 結構中執行自動區域探索和連線品質測量。

語法

enum class PartyRegionUpdateMode    
{  
    Immediate = 0,  
    Deferred = 1,  
}  

常數

常數	描述
Immediate	盡快自動開始擷取可用區域清單並測量與其之間的連線品質。第一次叫用 PartyManager::Initialize() 時，Party 程式庫會自動探索可用區域並測量與其之間的連線品質。 Party 程式庫也會定期重新整理清單和品質測量，直到呼叫 PartyManager::Cleanup() 為止。如果已連線或正在連線到現有的 Party 網路，則會延遲重新整理，直到與所有 Party 網路中斷連線為止。可以使用所屬 PartyRegionUpdateConfiguration 結構中的 refreshIntervalInSeconds 欄位設定定期重新整理間隔。每當測量作業完成時，應用程式都會自動收到表示可用區域或失敗 PartyStateChangeResult 的 PartyRegionsChangedStateChange。如果未設定 PartyOption::RegionUpdateConfiguration，此模式就是預設值。
Deferred	延後擷取可用區域清單並測量與其之間的連線品質，直到建立新的 Party 網路或使用特定文字轉語音或語音轉文字功能為止。除非應用程式以零個項目的區域清單陣列呼叫 PartyManager::CreateNewNetwork()，或在未連線到現有網路的情況下呼叫 PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles()、PartyLocalChatControl::SetTextToSpeechProfile()，或以包含 PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState 的選項旗標呼叫 PartyLocalChatControl::SetTranscriptionOptions()，否則 Party 程式庫不會自動探索可用區域或測量與其之間的連線品質。一旦開始延後的區域探索和品質測量，就會在觸發作業的 PartyCreateNewNetworkCompletedStateChange、PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange、PartySetTextToSpeechProfileCompletedStateChange 或 PartySetTranscriptionOptionsCompletedStateChange 完成狀態變更之前，提供表示可用區域或失敗 PartyStateChangeResult 的 PartyRegionsChangedStateChange。在後續以上述參數呼叫上述函式時，如果自上次成功執行測量以來已經過重新整理間隔，就會再次擷取並測量區域清單。如果已連線或正在連線到現有的 Party 網路，則會延遲重新整理，直到與所有 Party 網路中斷連線為止。可以使用所屬 PartyRegionUpdateConfiguration 結構中的 refreshIntervalInSeconds 欄位設定重新整理間隔。聊天控制項在內部會使用本機裝置的區域延遲估計值，以最佳化文字轉語音合成、語音轉文字轉譯和翻譯的服務使用量。使用 PartyRegionUpdateMode::Deferred 可能會導致這些功能的延遲較高。

需求

標頭： Party.h

另請參閱

Party 成員
PartyOption::RegionUpdateConfiguration
PartyRegionUpdateConfiguration
PartyRegionsChangedStateChange
PartyCreateNewNetworkCompletedStateChange
PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange
PartySetTextToSpeechProfileCompletedStateChange
PartySetTranscriptionOptionsCompletedStateChange
PartyManager::Initialize
PartyManager::CreateNewNetwork
PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles
PartyLocalChatControl::SetTextToSpeechProfile
PartyLocalChatControl::SetTranscriptionOptions

XBOX Services

PlayFab

語法

常數

需求

另請參閱

​語法

​常數

​需求

​另請參閱

語法

常數

需求

另請參閱