> ## 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

このメンバーの ID。このメンバーが属するセッションのコンテキスト内で一意です。

*TeamId*\
型: const char\*

トーナメントにおけるこのメンバーのチームの ID。非推奨。将来のリリースで削除されます。

*InitialTeam*\
型: const char\*

SmartMatch からの初期チーム割り当て。

*ArbitrationStatus*\
型: [XblTournamentArbitrationStatus](/reference/live/xsapi-c/multiplayer_c/enums/xbltournamentarbitrationstatus)

トーナメントにおけるメンバーのアービトレーション状態。非推奨。将来のリリースで削除されます。

*Xuid*\
型: uint64\_t

メンバーの XBOX ユーザー ID。メンバーが承諾した場合にのみ判明します。

*CustomConstantsJson*\
型: const char\*

メンバーのカスタム定数を指定する JSON 文字列。

*SecureDeviceBaseAddress64*\
型: const char\*

メンバーの Base64 エンコードされたセキュア デバイス アドレス。(オプション)

*Roles*\
型: const [XblMultiplayerSessionMemberRole\*](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionmemberrole)

このメンバーのロールの配列。(オプション)

*RolesCount*\
型: size\_t

Roles 配列内のエントリ数。

*CustomPropertiesJson*\
型: const char\*

メンバーのカスタム プロパティを指定する JSON 文字列。

*Gamertag*\
型: char\[XBL\_GAMERTAG\_CHAR\_SIZE]

メンバーのゲーマータグ。(オプション) メンバーが承諾した場合にのみ判明します。

*Status*\
型: [XblMultiplayerSessionMemberStatus](/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」は全体として更新する必要があるため、測定完了時に 1 回設定する必要があります。空の場合、「serverMeasurementTimeout」以内に完了した測定がないことを意味します。

*MembersInGroupIds*\
型: const uint32\_t\*

自分のグループ内の memberId のコレクション。「initializationGroup」リストが設定されている場合、既に存在しない限り、そのメンバー自身のインデックスが常に追加されます。マネージド初期化中に、リスト内のいずれかのメンバーが失敗した場合、このメンバーも失敗します。

*MembersInGroupCount*\
型: size\_t

MembersInGroupIds 配列内のエントリ数。

*QosMeasurementsJson*\
型: const char\*

セキュア デバイス アドレス別の QoS 測定。すべてのフィールドと同様に、「measurements」は全体として更新する必要があります。測定完了時に 1 回設定する必要があり、段階的にではありません。「measurements」オブジェクトが設定されている場合、そのメンバー自身のアドレスのエントリを含めることはできません。

*DeviceToken*\
型: [XblDeviceToken](/reference/live/xsapi-c/multiplayer_c/structs/xbldevicetoken)

これは、メンバーがセキュア デバイス アドレスをアップロードするときに設定されます。等価比較に使用できる、大文字と小文字を区別しない文字列です。

*Nat*\
型: [XblNetworkAddressTranslationSetting](/reference/live/xsapi-c/multiplayer_c/enums/xblnetworkaddresstranslationsetting)

メンバーがセキュア デバイス アドレスをアップロードするときのデバイスの NAT 設定です。

*ActiveTitleId*\
型: uint32\_t

メンバーがアクティブな場合、これはメンバーがアクティブなタイトル ID です。

*InitializationEpisode*\
型: uint32\_t

この値は、タイトルが独自の QoS を手動で管理している場合にのみ読み取りに有用です。「memberInitialization」セクションが設定されており、メンバーが「initialize」:true で追加された場合、これはメンバーが参加する初期化エピソードに設定されます。それ以外の場合は 0 です。ユーザーはバッチでセッションに参加します。初期化エピソード番号は、QoS を実行する必要があるユーザーのセットを示します。初期化エピソード 1 は、作成時に新しいセッションに追加されたメンバー用の特別な値です。

*JoinTime*\
型: time\_t

ユーザーがセッションに参加した時刻。「reserved」が true の場合、これは予約が行われた時刻です。

*InitializationFailureCause*\
型: [XblMultiplayerMeasurementFailure](/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](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference)

トーナメント チーム セッション参照。非推奨。将来のリリースで削除されます。

*Internal*\
型: void\*

内部使用のみ。

## 要件

**ヘッダー:** multiplayer\_c.h

## 関連項目

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


## Related topics

- [XblMultiplayerSessionMembers](/ja-jp/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionmembers.md)
- [XblMultiplayerSessionMemberStatus](/ja-jp/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionmemberstatus.md)
- [XblMultiplayerMeasurementFailure](/ja-jp/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayermeasurementfailure.md)
- [XblTournamentArbitrationStatus](/ja-jp/reference/live/xsapi-c/multiplayer_c/enums/xbltournamentarbitrationstatus.md)
- [XblNetworkAddressTranslationSetting](/ja-jp/reference/live/xsapi-c/multiplayer_c/enums/xblnetworkaddresstranslationsetting.md)
