> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblMultiplayerSessionMember

> XblMultiplayerSessionMember

# XblMultiplayerSessionMember

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

## 語法

```cpp theme={null}
typedef struct XblMultiplayerSessionMember {  
    uint32_t MemberId;  
    const char* TeamId;  
    const char* InitialTeam;  
    XblTournamentArbitrationStatus ArbitrationStatus;  
    uint64_t Xuid;  
    const char* CustomConstantsJson;  
    const char* SecureDeviceBaseAddress64;  
    const XblMultiplayerSessionMemberRole* Roles;  
    size_t RolesCount;  
    const char* CustomPropertiesJson;  
    char Gamertag[XBL_GAMERTAG_CHAR_SIZE];  
    XblMultiplayerSessionMemberStatus Status;  
    bool IsTurnAvailable;  
    bool IsCurrentUser;  
    bool InitializeRequested;  
    const char* MatchmakingResultServerMeasurementsJson;  
    const char* ServerMeasurementsJson;  
    const uint32_t* MembersInGroupIds;  
    size_t MembersInGroupCount;  
    const char* QosMeasurementsJson;  
    XblDeviceToken DeviceToken;  
    XblNetworkAddressTranslationSetting Nat;  
    uint32_t ActiveTitleId;  
    uint32_t InitializationEpisode;  
    time_t JoinTime;  
    XblMultiplayerMeasurementFailure InitializationFailureCause;  
    const char** Groups;  
    size_t GroupsCount;  
    const char** Encounters;  
    size_t EncountersCount;  
    XblMultiplayerSessionReference TournamentTeamSessionReference;  
    void* Internal;  
} XblMultiplayerSessionMember  
```

### 成員

*MemberId*\
類型：uint32\_t

此成員的識別碼。在此成員所屬工作階段的內容中是唯一的。

*TeamId*\
類型：const char\*

此成員在錦標賽中的團隊識別碼。已過時。此成員將在未來的版本中移除

*InitialTeam*\
類型：const char\*

來自 SmartMatch 的初始團隊指派。

*ArbitrationStatus*\
類型：[XblTournamentArbitrationStatus](/zh-TW/reference/live/xsapi-c/multiplayer_c/enums/xbltournamentarbitrationstatus)

成員在錦標賽中的仲裁狀態。已過時。此成員將在未來的版本中移除

*Xuid*\
類型：uint64\_t

成員的 XBOX 使用者識別碼。只有在成員已接受時才會得知。

*CustomConstantsJson*\
類型：const char\*

指定成員自訂常數的 JSON 字串。

*SecureDeviceBaseAddress64*\
類型：const char\*

成員以 base64 編碼的安全裝置位址。(選用)

*Roles*\
類型：const [XblMultiplayerSessionMemberRole\*](/zh-TW/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionmemberrole)

此成員的角色陣列。(選用)

*RolesCount*\
類型：size\_t

Roles 陣列中的項目數。

*CustomPropertiesJson*\
類型：const char\*

指定成員自訂屬性的 JSON 字串。

*Gamertag*\
類型：char\[XBL\_GAMERTAG\_CHAR\_SIZE]

成員的玩家代號。(選用) 只有在成員已接受時才會得知。

*Status*\
類型：[XblMultiplayerSessionMemberStatus](/zh-TW/reference/live/xsapi-c/multiplayer_c/enums/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](/zh-TW/reference/live/xsapi-c/multiplayer_c/structs/xbldevicetoken)

當成員上傳安全裝置位址時會設定此值。這是不區分大小寫的字串，可用於相等比較。

*Nat*\
類型：[XblNetworkAddressTranslationSetting](/zh-TW/reference/live/xsapi-c/multiplayer_c/enums/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](/zh-TW/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayermeasurementfailure)

初始化失敗的原因；如果沒有失敗，則為 XblMultiplayerMeasurementFailure::None。如果此成員未通過，會在離開 "joining" 或 "measuring" 階段時設定。

*Groups*\
類型：const char\*\*

目前使用者的群組名稱陣列，指出該使用者在多人遊戲工作階段期間屬於哪些群組。

*GroupsCount*\
類型：size\_t

Groups 陣列中的項目數。

*Encounters*\
類型：const char\*\*

取得目前使用者的群組名稱清單，指出該使用者在多人遊戲工作階段期間遇到哪些群組。

*EncountersCount*\
類型：size\_t

Groups 陣列中的項目數。

*TournamentTeamSessionReference*\
類型：[XblMultiplayerSessionReference](/zh-TW/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference)

錦標賽團隊工作階段參考。已過時。此成員將在未來的版本中移除

*Internal*\
類型：void\*

僅供內部使用。

## 需求

**標頭：** multiplayer\_c.h

## 另請參閱

[multiplayer\_c](/zh-TW/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerSessionMembers](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionmembers.md)
- [XblMultiplayerSessionMember](/ja-jp/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionmember.md)