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

# XblMultiplayerSessionProperties

> XblMultiplayerSessionProperties

# XblMultiplayerSessionProperties

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

## 構文

```cpp theme={null}
typedef struct XblMultiplayerSessionProperties {  
    const char** Keywords;  
    size_t KeywordCount;  
    XblMultiplayerSessionRestriction JoinRestriction;  
    XblMultiplayerSessionRestriction ReadRestriction;  
    uint32_t* TurnCollection;  
    size_t TurnCollectionCount;  
    const char* MatchmakingTargetSessionConstantsJson;  
    const char* SessionCustomPropertiesJson;  
    const char* MatchmakingServerConnectionString;  
    const char** ServerConnectionStringCandidates;  
    size_t ServerConnectionStringCandidatesCount;  
    uint32_t* SessionOwnerMemberIds;  
    size_t SessionOwnerMemberIdsCount;  
    XblDeviceToken HostDeviceToken;  
    bool Closed;  
    bool Locked;  
    bool AllocateCloudCompute;  
    bool MatchmakingResubmit;  
} XblMultiplayerSessionProperties  
```

### メンバー

*Keywords*\
型: const char\*\*

セッションに関連付けられたキーワードのコレクション (オプション、空でもかまいません)。

*KeywordCount*\
型: size\_t

キーワードの数。

*JoinRestriction*\
型: [XblMultiplayerSessionRestriction](/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionrestriction)

「開かれた」セッションに参加できるユーザーを制限します。(予約には影響しないため、「非公開」および「表示」セッションには影響しません。) 既定は「none」です。「local」の場合、セッション内で既に「active」: true の誰かとトークンの DeviceId が一致するユーザーのみです。「followed」の場合、ローカル ユーザー (前述の定義) と、セッションの既存の (予約されていない) メンバーによってフォローされているユーザーのみが、予約なしで参加できます。

*ReadRestriction*\
型: [XblMultiplayerSessionRestriction](/reference/live/xsapi-c/multiplayer_c/enums/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](/reference/live/xsapi-c/multiplayer_c/structs/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](/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [マルチプレイヤー セッションの詳細トピック](/ja-jp/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-details.md)
- [Multiplayer Session Directory の概要](/ja-jp/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [XblMultiplayerSessionSessionProperties](/ja-jp/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionsessionproperties.md)
- [XblMultiplayerSessionPropertiesSetKeywords](/ja-jp/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionpropertiessetkeywords.md)
- [XblMultiplayerSessionPropertiesSetJoinRestriction](/ja-jp/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionpropertiessetjoinrestriction.md)