XblMultiplayerSessionConstants

マルチプレイヤー セッションの定数を表します。

構文

typedef struct XblMultiplayerSessionConstants {  
    uint32_t MaxMembersInSession;  
    XblMultiplayerSessionVisibility Visibility;  
    uint64_t* InitiatorXuids;  
    size_t InitiatorXuidsCount;  
    const char* CustomJson;  
    const char* SessionCloudComputePackageConstantsJson;  
    uint64_t MemberReservedTimeout;  
    uint64_t MemberInactiveTimeout;  
    uint64_t MemberReadyTimeout;  
    uint64_t SessionEmptyTimeout;  
    uint64_t ArbitrationTimeout;  
    uint64_t ForfeitTimeout;  
    bool EnableMetricsLatency;  
    bool EnableMetricsBandwidthDown;  
    bool EnableMetricsBandwidthUp;  
    bool EnableMetricsCustom;  
    XblMultiplayerMemberInitialization* MemberInitialization;  
    XblMultiplayerPeerToPeerRequirements PeerToPeerRequirements;  
    XblMultiplayerPeerToHostRequirements PeerToHostRequirements;  
    const char* MeasurementServerAddressesJson;  
    bool ClientMatchmakingCapable;  
    XblMultiplayerSessionCapabilities SessionCapabilities;  
} XblMultiplayerSessionConstants  

メンバー

MaxMembersInSession
型: uint32_t

このセッションのメンバーの最大数。

Visibility
型: XblMultiplayerSessionVisibility

このセッションの可視性。

InitiatorXuids
型: uint64_t*

だれがセッションを開始したかを示す Xbox ユーザー ID のコレクション。 (オプション)

InitiatorXuidsCount
型: size_t

InitiatorXuids 配列内のエントリの数です。

CustomJson
型: const char*

セッションのカスタム定数を指定する JSON 文字列。 これらの定数は、セッションが作成された後は変更できません。 (オプション)

SessionCloudComputePackageConstantsJson
型: const char*

JSON 文字列で指定されたセッションの Cloud Compute パッケージ定数。 これらの定数は、セッションが作成された後は変更できません。 (オプション)

MemberReservedTimeout
型: uint64_t

予約のあるメンバーがセッションに参加するための最大時間 (ミリ秒単位)。 この時間内にメンバーが参加しない場合、予約は削除されます。

MemberInactiveTimeout
型: uint64_t

非アクティブなメンバーがアクティブになるまでの最大時間 (ミリ秒単位)。 非アクティブなメンバーがこの時間内にアクティブにならない場合、そのメンバーはセッションから削除されます。

MemberReadyTimeout
型: uint64_t

アクティブになる準備ができているとマークされたメンバーの最大時間 (ミリ秒単位)。 シェルがタイトルを起動してマルチプレイヤー ゲームを開始すると、メンバーは準備完了としてマークされます。 準備完了としてマークされたメンバーがこの時間内にアクティブにならない場合、そのメンバーは非アクティブになります。

SessionEmptyTimeout
型: uint64_t

セッションが空のままでいられる最大時間 (ミリ秒単位)。 この時間内にセッションに参加するメンバーがいない場合、セッションは削除されます。

ArbitrationTimeout
型: uint64_t

結果が確定する時刻を表す開始時刻からのデルタ (ミリ秒単位)。 この時点でだれからも (クライアントからもサーバーからも) 報告がない場合、マッチ結果を不完全と宣言します。 非推奨です。 この構造は将来のリリースで削除される予定です。

ForfeitTimeout
型: uint64_t

開始時刻からの経過時間。セッションにアクティブなユーザーがいない場合にマッチがキャンセルされるまでの時間を表します。 非推奨です。 この構造は将来のリリースで削除される予定です。

EnableMetricsLatency
型: bool

true の場合、接続性を判断するために、タイトルで遅延を測定する必要があることを示します。 capabilities.connectivity が true である必要があります。

EnableMetricsBandwidthDown
型: bool

true の場合、接続を判別するために、タイトルがダウンストリーム (ホストツーピア) 帯域幅を測定する必要があることを示します。 capabilities.connectivity が true である必要があります。

EnableMetricsBandwidthUp
型: bool

true の場合、接続を判別するために、タイトルがアップストリーム (ピアツーホスト) 帯域幅を測定する必要があることを示します。 capabilities.connectivity が true である必要があります。

EnableMetricsCustom
型: bool

trueの 場合、タイトルが接続性の判断に役立つカスタム測定値を必要としていることを示します。 capabilities.connectivity が true である必要があります。

MemberInitialization
型: XblMultiplayerMemberInitialization*

true の場合、タイトルが接続性の判断に役立つカスタム測定値を必要としていることを示します。 タイムアウトと初期化段階は、メトリックが設定されている場合の初期のサービス品質 (QoS) 測定を含め、セッションによって自動的に追跡されます。

PeerToPeerRequirements
型: XblMultiplayerPeerToPeerRequirements

セッションメンバー間で接続死するQoS要件。

PeerToHostRequirements
型: XblMultiplayerPeerToHostRequirements

ホスト候補とセッション メンバー間の接続の QoS 要件。

MeasurementServerAddressesJson
型: const char*

評価する必要のある潜在的サーバー接続文字列のセット。

ClientMatchmakingCapable
型: bool

マッチメイキング ステータス フィールドに書き込みできるかどうかを示します。

SessionCapabilities
型: XblMultiplayerSessionCapabilities

セッションの機能。

解説

セッション定数は、セッションが作成されたときにのみ、作成者またはセッション テンプレートによって設定されます。

要件

ヘッダー: multiplayer_c.h

関連項目

multiplayer_c