跳轉到主要內容
Party 程式庫用來控制其如何執行自動區域探索和連線品質測量更新的設定。

語法

成員

mode   PartyRegionUpdateMode 控制何時執行區域探索和連線品質測量更新的模式。 尚未設定 PartyOption::RegionUpdateConfiguration 時,預設值為 PartyRegionUpdateMode::Immediate。 refreshIntervalInSeconds   uint32_t 區域品質測量完成後,必須經過多少秒才能開始新的區域探索和連線品質測量程序。 每當提供 PartyRegionsChangedStateChange 時,都會使用此重新整理間隔,以判斷在 mode 欄位所定義的更新模式下,下一次區域品質測量何時符合開始的資格。

符合重新整理資格並不保證重新整理會在該確切時間開始。如果 mode 欄位設定為 PartyRegionUpdateMode::Deferred,則在呼叫其中一個適用方法來觸發區域更新之前,不會進行下一次重新整理。程式庫也會等到本機裝置不再位於任何 Party 網路中,並套用少量的隨機延遲,以盡量避免多部無意間同步的裝置對 PlayFab 服務造成負載。

尚未設定 PartyOption::RegionUpdateConfiguration 時,預設值為 28800 (8 小時)。

值為零會讓 Party 程式庫在未來永遠不會自動重新整理測量。否則,允許的最小值為 30 秒。

備註

此結構可與 PartyOption::RegionUpdateConfiguration 搭配使用,分別透過 PartyManager::SetOption() 或 PartyManager::GetOption() 覆寫或查詢 Party 程式庫目前的設定。它會設定產生 PartyRegionsChangedStateChange 狀態變更之區域探索和連線品質測量程序的行為。

需求

標頭: Party.h

另請參閱

Party 成員
PartyOption::RegionUpdateConfiguration
PartyRegionUpdateMode
PartyRegionsChangedStateChange
PartyManager::SetOption
PartyManager::GetOption
最後修改於 2026年10月8日