Skip to main content

XblMultiplayerSessionMember

マルチプレイヤー セッション内のメンバーへの読み取り専用参照を表します。

構文

メンバー

MemberId
型: uint32_t
このメンバーの ID。このメンバーが属するセッションのコンテキスト内で一意です。 TeamId
型: const char*
トーナメントにおけるこのメンバーのチームの ID。非推奨。将来のリリースで削除されます。 InitialTeam
型: const char*
SmartMatch からの初期チーム割り当て。 ArbitrationStatus
型: XblTournamentArbitrationStatus
トーナメントにおけるメンバーのアービトレーション状態。非推奨。将来のリリースで削除されます。 Xuid
型: uint64_t
メンバーの XBOX ユーザー ID。メンバーが承諾した場合にのみ判明します。 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」は全体として更新する必要があるため、測定完了時に 1 回設定する必要があります。空の場合、「serverMeasurementTimeout」以内に完了した測定がないことを意味します。 MembersInGroupIds
型: const uint32_t*
自分のグループ内の memberId のコレクション。「initializationGroup」リストが設定されている場合、既に存在しない限り、そのメンバー自身のインデックスが常に追加されます。マネージド初期化中に、リスト内のいずれかのメンバーが失敗した場合、このメンバーも失敗します。 MembersInGroupCount
型: size_t
MembersInGroupIds 配列内のエントリ数。 QosMeasurementsJson
型: const char*
セキュア デバイス アドレス別の QoS 測定。すべてのフィールドと同様に、「measurements」は全体として更新する必要があります。測定完了時に 1 回設定する必要があり、段階的にではありません。「measurements」オブジェクトが設定されている場合、そのメンバー自身のアドレスのエントリを含めることはできません。 DeviceToken
型: XblDeviceToken
これは、メンバーがセキュア デバイス アドレスをアップロードするときに設定されます。等価比較に使用できる、大文字と小文字を区別しない文字列です。 Nat
型: XblNetworkAddressTranslationSetting
メンバーがセキュア デバイス アドレスをアップロードするときのデバイスの NAT 設定です。 ActiveTitleId
型: uint32_t
メンバーがアクティブな場合、これはメンバーがアクティブなタイトル ID です。 InitializationEpisode
型: uint32_t
この値は、タイトルが独自の QoS を手動で管理している場合にのみ読み取りに有用です。「memberInitialization」セクションが設定されており、メンバーが「initialize」:true で追加された場合、これはメンバーが参加する初期化エピソードに設定されます。それ以外の場合は 0 です。ユーザーはバッチでセッションに参加します。初期化エピソード番号は、QoS を実行する必要があるユーザーのセットを示します。初期化エピソード 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
最終更新日 2026年8月24日