Skip to main content

XblMultiplayerSessionMember

代表多人遊戲工作階段中成員的唯讀參考。

語法

成員

MemberId
類型:uint32_t
此成員的識別碼。在此成員所屬工作階段的內容中是唯一的。 TeamId
類型:const char*
此成員在錦標賽中的團隊識別碼。已過時。此成員將在未來的版本中移除 InitialTeam
類型:const char*
來自 SmartMatch 的初始團隊指派。 ArbitrationStatus
類型:XblTournamentArbitrationStatus
成員在錦標賽中的仲裁狀態。已過時。此成員將在未來的版本中移除 Xuid
類型:uint64_t
成員的 XBOX 使用者識別碼。只有在成員已接受時才會得知。 CustomConstantsJson
類型:const char*
指定成員自訂常數的 JSON 字串。 SecureDeviceBaseAddress64
類型:const char*
成員以 base64 編碼的安全裝置位址。(選用) Roles
類型:const XblMultiplayerSessionMemberRole*
此成員的角色陣列。(選用) RolesCount
類型:size_t
Roles 陣列中的項目數。 CustomPropertiesJson
類型:const char*
指定成員自訂屬性的 JSON 字串。 Gamertag
類型:char[XBL_GAMERTAG_CHAR_SIZE]
成員的玩家代號。(選用) 只有在成員已接受時才會得知。 Status
類型:XblMultiplayerSessionMemberStatus
此成員的狀態。 IsTurnAvailable
類型:bool
只有在此成員已準備好輪到其回合時才為 true。 IsCurrentUser
類型:bool
指出此 MultiplayerSessionMember 是否為目前的使用者。 InitializeRequested
類型:bool
指出要為此使用者執行 QoS 初始化。預設為 false。如果工作階段沒有 “memberInitialization” 區段,則會忽略。 MatchmakingResultServerMeasurementsJson
類型:const char*
當配對將使用者新增至工作階段時,可以提供一些關於使用者如何及為何被配對到工作階段的內容。這是來自配對工作階段之使用者 serverMeasurements 的複本。 ServerMeasurementsJson
類型:const char*
依遊戲伺服器連接字串的 QoS 測量。與所有欄位一樣,“serverMeasurements” 必須整體更新,因此應在測量完成時設定一次。如果為空白,表示沒有任何測量在 “serverMeasurementTimeout” 內完成。 MembersInGroupIds
類型:const uint32_t*
我的群組中的 memberId 集合。如果已設定 “initializationGroup” 清單,且成員本身的索引尚不存在,則一律會新增該索引。在受控初始化期間,如果清單中的任何成員失敗,此成員也會失敗。 MembersInGroupCount
類型:size_t
MembersInGroupIds 陣列中的項目數。 QosMeasurementsJson
類型:const char*
依安全裝置位址的 QoS 測量。與所有欄位一樣,“measurements” 必須整體更新。應在測量完成時設定一次,而非以累加方式設定。如果已設定 “measurements” 物件,則不能包含成員本身位址的項目。 DeviceToken
類型:XblDeviceToken
當成員上傳安全裝置位址時會設定此值。這是不區分大小寫的字串,可用於相等比較。 Nat
類型:XblNetworkAddressTranslationSetting
這是成員上傳安全裝置位址時裝置的 NAT 設定。 ActiveTitleId
類型:uint32_t
如果成員為作用中,這是成員作用中所在遊戲的識別碼。 InitializationEpisode
類型:uint32_t
只有在遊戲自行手動管理 QoS 時,讀取此值才有用。如果已設定 “memberInitialization” 區段,且成員是以 “initialize”:true 新增,則此值會設定為成員將參與的初始化 episode,否則為 0。使用者會分批加入工作階段。初始化 episode 編號表示需要對其執行 QoS 的一組使用者。初始化 episode 1 是特殊值,用於在建立時新增至新工作階段的成員。 JoinTime
類型:time_t
使用者加入工作階段的時間。如果 “reserved” 為 true,這是建立保留的時間。 InitializationFailureCause
類型:XblMultiplayerMeasurementFailure
初始化失敗的原因;如果沒有失敗,則為 XblMultiplayerMeasurementFailure::None。如果此成員未通過,會在離開 “joining” 或 “measuring” 階段時設定。 Groups
類型:const char**
目前使用者的群組名稱陣列,指出該使用者在多人遊戲工作階段期間屬於哪些群組。 GroupsCount
類型:size_t
Groups 陣列中的項目數。 Encounters
類型:const char**
取得目前使用者的群組名稱清單,指出該使用者在多人遊戲工作階段期間遇到哪些群組。 EncountersCount
類型:size_t
Groups 陣列中的項目數。 TournamentTeamSessionReference
類型:XblMultiplayerSessionReference
錦標賽團隊工作階段參考。已過時。此成員將在未來的版本中移除 Internal
類型:void*
僅供內部使用。

需求

標頭: multiplayer_c.h

另請參閱

multiplayer_c
Last modified on October 6, 2026