跳轉到主要內容

XblMultiplayerSessionConstants

代表多人遊戲工作階段的常數。

語法

成員

MaxMembersInSession
類型:uint32_t
工作階段中的成員數上限。 Visibility
類型:XblMultiplayerSessionVisibility
工作階段的可見性。 InitiatorXuids
類型:uint64_t*
XBOX 使用者識別碼的集合,指出誰起始了工作階段。(選用) InitiatorXuidsCount
類型:size_t
InitiatorXuids 陣列中的項目數。 CustomJson
類型:const char*
工作階段的任何自訂常數,以 JSON 字串指定。建立工作階段後,就無法變更這些常數。(選用) SessionCloudComputePackageConstantsJson
類型:const char*
工作階段的 Cloud Compute 套件常數,以 JSON 字串指定。建立工作階段後,就無法變更這些常數。(選用) MemberReservedTimeout
類型:uint64_t
具有保留的成員加入工作階段的最長時間,以毫秒為單位。如果成員未在此時間內加入,就會移除保留。 MemberInactiveTimeout
類型:uint64_t
非作用中成員變成作用中的最長時間,以毫秒為單位。如果非作用中成員未在此時間內變成作用中,就會從工作階段中移除該成員。 MemberReadyTimeout
類型:uint64_t
標記為就緒的成員變成作用中的最長時間,以毫秒為單位。當殼層啟動遊戲以開始多人遊戲時,成員會標記為就緒。如果標記為就緒的成員未在此時間內變成作用中,該成員就會變成非作用中。 SessionEmptyTimeout
類型:uint64_t
工作階段可保持空白的最長時間,以毫秒為單位。如果在此時間內沒有成員加入工作階段,就會刪除工作階段。 ArbitrationTimeout
類型:uint64_t
自開始時間起算的差異值 (以毫秒為單位),代表結果確定的時間。如果此時沒有任何一方 (用戶端或伺服器) 回報,我們會宣告對戰結果不完整。已過時。此成員將在未來的版本中移除。 ForfeitTimeout
類型:uint64_t
自開始時間起算的差異值 (以毫秒為單位),代表若工作階段沒有作用中使用者時取消對戰的時間。已過時。此成員將在未來的版本中移除。 EnableMetricsLatency
類型:bool
如果為 true,表示遊戲希望測量延遲以協助判斷連線能力。需要 capabilities.connectivity 為 true。 EnableMetricsBandwidthDown
類型:bool
如果為 true,表示遊戲希望測量下游 (主機到對等) 頻寬以協助判斷連線能力。需要 capabilities.connectivity 為 true。 EnableMetricsBandwidthUp
類型:bool
如果為 true,表示遊戲希望測量上游 (對等到主機) 頻寬以協助判斷連線能力。需要 capabilities.connectivity 為 true。 EnableMetricsCustom
類型:bool
如果為 true,表示遊戲希望使用自訂測量以協助判斷連線能力。需要 capabilities.connectivity 為 true。 MemberInitialization
類型:XblMultiplayerMemberInitialization*
如果已設定,工作階段會預期用戶端系統或遊戲在建立工作階段後執行初始化。工作階段會自動追蹤逾時與初始化階段,如果已設定任何計量,也包括初始服務品質 (QoS) 測量。 PeerToPeerRequirements
類型:XblMultiplayerPeerToPeerRequirements
工作階段成員之間連線的 QoS 需求。 PeerToHostRequirements
類型:XblMultiplayerPeerToHostRequirements
主機候選項目與工作階段成員之間連線的 QoS 需求。 MeasurementServerAddressesJson
類型:const char*
應評估的一組潛在伺服器連接字串。 ClientMatchmakingCapable
類型:bool
指出是否可以寫入配對狀態欄位。 SessionCapabilities
類型:XblMultiplayerSessionCapabilities
工作階段的功能。

備註

工作階段常數只會在建立工作階段時,由建立者或工作階段範本設定。

需求

標頭: multiplayer_c.h

另請參閱

multiplayer_c
最後修改於 2026年10月6日