XblMultiplayerSessionMember

[アーティクル]
05/09/2023

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

構文

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

トーナメントのメンバーの調停状態。非推奨。今後のリリースで削除される予定です

Xuid
型: uint64_t

メンバーの Xbox ユーザー ID。メンバーが受け入れた場合にのみ認識されます。

CustomConstantsJson
型: const char*

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

SecureDeviceBaseAddress64
型: const char*

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

役割
型: const XblMultiplayerSessionMemberRole*

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

RolesCount
型: size_t

ロール配列内のエントリの数。

CustomPropertiesJson
型: const char*

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

ゲーマータグ
型: 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*

マイグループの memberIds のコレクション。 "InitializationGroup" のリストが設定されている場合は、メンバー自身のインデックスが既に存在しないなら必ず追加されます。管理された初期化中に、リスト内のいずれかのメンバーにエラーが発生した場合、このメンバーも失敗します。

MembersInGroupCount
型: size_t

MembersInGroupIds 配列内のエントリの数。

QosMeasurementsJson
型: const char*

セキュアデバイスアドレスによる QoS 測定。すべてのフィールドと同様に、"measurements" はまとめて更新する必要があります。段階的に設定するのではなく、測定が完了したときに一括で設定してください。 "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 になります。 "参加" または "測定" ステージからの遷移時に、このメンバーが成功しない場合に設定されます。

Groups
型: const char**

現在のユーザーのグループ名の配列で、マルチプレイヤーセッションの間にそのユーザーがどのグループに属していたかを示します。

GroupsCount
型: size_t

グループ配列内の項目の数。

Encounters
型: const char**

現在のユーザーのグループ名のリストを取得します。これは、マルチプレイヤーセッションの間にそのユーザーがどのグループと遭遇したかを示します。

EncountersCount
型: size_t

グループ配列内の項目の数。

TournamentTeamSessionReference
型: XblMultiplayerSessionReference

トーナメントチームのセッション参照。非推奨。今後のリリースで削除される予定です

Internal
型: void*

内部でのみ使用されます。

要件

ヘッダー: multiplayer_c.h

次の方法で共有

XblMultiplayerSessionMember

構文

メンバー

要件

関連項目

その他のリソース