Skip to main content

XblMultiplayerSessionProperties

このセッションに関連付けられた一連のプロパティ。任意のプレイヤーがこれらのプロパティを変更できます。

構文

メンバー

Keywords
型: const char**
セッションに関連付けられたキーワードのコレクション (オプション、空でもかまいません)。 KeywordCount
型: size_t
キーワードの数。 JoinRestriction
型: XblMultiplayerSessionRestriction
「開かれた」セッションに参加できるユーザーを制限します。(予約には影響しないため、「非公開」および「表示」セッションには影響しません。) 既定は「none」です。「local」の場合、セッション内で既に「active」: true の誰かとトークンの DeviceId が一致するユーザーのみです。「followed」の場合、ローカル ユーザー (前述の定義) と、セッションの既存の (予約されていない) メンバーによってフォローされているユーザーのみが、予約なしで参加できます。 ReadRestriction
型: XblMultiplayerSessionRestriction
「開かれた」セッションを読み取れるユーザーを制限します。(予約には影響しないため、「非公開」および「表示」セッションには影響しません。) 既定は「none」です。「local」の場合、セッション内で既に「active」: true の誰かとトークンの DeviceId が一致するユーザーのみです。「followed」の場合、ローカル ユーザー (前述の定義) と、セッションの既存の (予約されていない) メンバーによってフォローされているユーザーのみが、予約なしで読み取ることができます。読み取り制限は、可視性が「open」または「visible」のセッションに適用され、招待なしで誰がセッションを読み取れるかを決定します。読み取り制限は、少なくとも参加制限と同じレベルのアクセス可能性である必要があります。つまり、‘readRestriction’ も設定せずに ‘joinRestriction’ を「followed」に設定することはできません。” TurnCollection
型: uint32_t*
誰の順番かを示すセッション MemberId のコレクション。 TurnCollectionCount
型: size_t
TurnCollection 配列内のエントリ数。 MatchmakingTargetSessionConstantsJson
型: const char*
ターゲット セッションの定数を表す JSON 文字列。 SessionCustomPropertiesJson
型: const char*
セッションのカスタム プロパティを指定する JSON 文字列。これらはいつでも変更できます。変更する場合は、multiplayer_service::write_session を呼び出して変更をサービスに書き込みます。 MatchmakingServerConnectionString
型: const char*
使用する特定の接続文字列を強制します。これは、進行中のセッションに参加するシナリオに役立ちます。 ServerConnectionStringCandidates
型: const char**
セッションがゲーム サーバーに接続するために使用できる接続文字列の順序付きリスト。一般的にタイトルはリストの最初のものを使用しますが、高度なタイトルは (負荷などに基づいて) 他のいずれかを選択するためのカスタム メカニズムを使用することもできます。 ServerConnectionStringCandidatesCount
型: size_t
ServerConnectionStringCandidates 配列内のエントリ数。 SessionOwnerMemberIds
型: uint32_t*
セッションの所有者のセッション MemberId。 SessionOwnerMemberIdsCount
型: size_t
SessionOwnerMemberIds 配列内のエントリ数。 HostDeviceToken
型: XblDeviceToken
ホストのデバイス トークン。少なくとも 1 人のメンバーの「deviceToken」と一致する必要があります。そうでない場合、このフィールドは削除されます。「peerToHostRequirements」と「host」が設定されている場合、測定ステージは指定されたホストが正しいホストであると仮定し、そのホストに対するメトリックのみを測定します。 Closed
型: bool
可視性、参加制限、セッション内の利用可能なスペースとは独立して、セッションが参加可能かどうかを制御します。予約には影響しません。既定は false です。 Locked
型: bool
true の場合、セッションのメンバーをロックできます。これにより、ユーザーが退出しても再度セッションに戻ることができますが、そのスポットには他のユーザーは入れません。既定は false です。 AllocateCloudCompute
型: bool
クライアントが true に設定すると、MPSD による XBOX Live Compute 割り当ての試行がトリガーされます。既定は false です。 MatchmakingResubmit
型: bool
見つかったマッチが機能せず、再送信する必要がある場合は true。マッチが機能し、マッチメイキング サービスがセッションを解放できることを示すには false に設定します。

要件

ヘッダー: multiplayer_c.h

関連項目

multiplayer_c
最終更新日 2026年8月24日