跳轉到主要內容

XblMultiplayerSessionProperties

與此工作階段相關聯的一組屬性。任何玩家都可以修改這些屬性。

語法

成員

Keywords
類型:const char**
與工作階段相關聯的關鍵字集合 (選用,可能為空白)。 KeywordCount
類型:size_t
關鍵字的數目。 JoinRestriction
類型:XblMultiplayerSessionRestriction
限制誰可以加入 “open” 工作階段。(對保留沒有影響,這表示對 “private” 和 “visible” 工作階段沒有影響。) 預設為 “none”。如果為 “local”,則只有權杖的 DeviceId 與已在工作階段中且 “active”: true 的其他人相符的使用者。如果為 “followed”,則只有本機使用者 (如上所定義) 以及受到工作階段現有 (非保留) 成員追蹤的使用者,才能在沒有保留的情況下加入。 ReadRestriction
類型:XblMultiplayerSessionRestriction
限制誰可以讀取 “open” 工作階段。(對保留沒有影響,這表示對 “private” 和 “visible” 工作階段沒有影響。) 預設為 “none”。如果為 “local”,則只有權杖的 DeviceId 與已在工作階段中且 “active”: true 的其他人相符的使用者。如果為 “followed”,則只有本機使用者 (如上所定義) 以及受到工作階段現有 (非保留) 成員追蹤的使用者,才能在沒有保留的情況下讀取。讀取限制適用於可見性為 “open” 或 “visible” 的工作階段,並決定誰可以在沒有邀請的情況下讀取工作階段。讀取限制的可存取程度必須至少與加入限制相同,亦即若未同時設定 ‘readRestriction’,就無法將 ‘joinRestriction’ 設定為 “followed”。” TurnCollection
類型:uint32_t*
工作階段 MemberId 的集合,指出輪到誰。 TurnCollectionCount
類型:size_t
TurnCollection 陣列中的項目數。 MatchmakingTargetSessionConstantsJson
類型:const char*
代表目標工作階段常數的 JSON 字串。 SessionCustomPropertiesJson
類型:const char*
指定工作階段自訂屬性的 JSON 字串。這些屬性可隨時變更。變更時,請呼叫 multiplayer_service::write_session 將變更寫入服務。 MatchmakingServerConnectionString
類型:const char*
強制使用特定的連接字串。這適用於加入進行中工作階段的案例。 ServerConnectionStringCandidates
類型:const char**
工作階段可用來連線至遊戲伺服器之連接字串的排序清單。一般而言,遊戲應使用清單中的第一個,但較複雜的遊戲可以使用自訂機制來選擇其他字串之一 (例如根據負載)。 ServerConnectionStringCandidatesCount
類型:size_t
ServerConnectionStringCandidates 陣列中的項目數。 SessionOwnerMemberIds
類型:uint32_t*
工作階段擁有者的工作階段 MemberId。 SessionOwnerMemberIdsCount
類型:size_t
SessionOwnerMemberIds 陣列中的項目數。 HostDeviceToken
類型:XblDeviceToken
主機的裝置權杖。必須至少與一個成員的 “deviceToken” 相符,否則會刪除此欄位。如果已設定 “peerToHostRequirements” 且已設定 “host”,測量階段會假設指定的主機是正確的主機,並且只測量到該主機的計量。 Closed
類型:bool
控制工作階段是否可加入,與可見性、加入限制以及工作階段中的可用空間無關。不會影響保留。預設為 false。 Locked
類型:bool
如果為 true,則允許鎖定工作階段的成員,如此一來,如果使用者離開,他們可以回到工作階段,但其他使用者無法佔用該位置。預設為 false。 AllocateCloudCompute
類型:bool
由用戶端設定為 true 時,會觸發 MPSD 嘗試進行 XBOX Live Compute 配置。預設為 false。 MatchmakingResubmit
類型:bool
如果找到的配對未成功且需要重新提交,則為 true。設定為 false 表示配對成功,且配對服務可以釋放工作階段。

需求

標頭: multiplayer_c.h

另請參閱

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