> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# マルチプレイヤー サービスの構成

> セッションテンプレート、SmartMatch ホッパー、カスタム招待文字列をサービス構成に含めて、タイトル用に XBOX マルチプレイヤー サービスを構成します。

このトピックでは、セッションテンプレート、SmartMatch ホッパー、およびカスタム招待文字列の構成を含む、マルチプレイヤー サービスを構成する方法について説明します。タイトルで XBOX services を活用するには、最初にタイトルのサービス構成を定義する必要があります。サービス構成は XBOX services クラウドに存在し、ゲームを実行しているデバイスと XBOX services がどのようにやり取りするかを定義します。

マルチプレイヤー サービスの次の 3 つの側面を構成できます。

* セッションテンプレート
* SmartMatch ホッパー
* カスタム招待文字列

## セッションテンプレート

XBOX マルチプレイヤー サービスを使用することで、プレイヤーはセッションを作成および参加し、同じセッション内の他のプレイヤーとセッションメッセージを交換し、プレイの結果をセッションに投稿できます。結果を投稿すると、セッションがクリーンアップされ、セッション内のすべてのプレイヤーのリーダーボードが更新されることに注意してください。

たとえば、マルチプレイヤーセッションは 2 人のプレイヤー間のチェスの試合の場合があります。マルチプレイヤーセッションの別の例としては、多数のプレイヤーがプレイするアクション&アドベンチャータイトルの継続的なセッションが挙げられます。ゲームが新しいマルチプレイヤーセッションを作成する際、事前定義されたセッションテンプレートに基づいて作成します。このテンプレートは基本的に、セッションを説明する属性を含む JSON オブジェクトです。

新しいセッションテンプレートを作成するとき、次の表に示す値を定義する必要があります。

| フィールド | 説明 |
| - | - |
| セッション名 | マルチプレイヤーセッションテンプレートを特徴付ける名前を作成します。覚えやすく、認識しやすいものを選択します。名前は最大 100 文字のテキスト文字列である必要があります。 |
| コントラクトバージョン | この値はシステムにより自動的に入力され、JSON コントラクトの現在のシステムバージョンを示します。この値を編集しないでください。 |
| セッションテンプレート (JSON テキスト) | マルチプレイヤーセッションに関連付けられたさまざまな属性を記述する JSON データを指定します。 |

マルチプレイヤーセッションテンプレートの詳細 (JSON テキストのベースとして使用できるいくつかの事前定義されたテンプレートを含む) については、[マルチプレイヤーセッションテンプレート](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/mpsd/concepts/live-session-templates.md) を参照してください。

> [!NOTE]
>
> タイトルが Final Certification を通過すると、そのタイトルの既存のマルチプレイヤーセッションを変更または削除することはできなくなります。

## SmartMatch ホッパー

SmartMatch ホッパーは、XBOX マルチプレイヤー サービスへのオプションの追加機能です。SmartMatch ホッパーは、XBOX のサーバーベースマッチメイキングサービスの名前です。次の情報に基づいてプレイヤーをグループ化する方法を提供します。

* タイトルから提供
* プレイヤー統計に保存
* プレイヤーの設定から
* Quality of Service (QoS) から

マッチメイキングはサーバーベースになりました。プレイヤーはサービスにリクエストを送信し、後でマッチが見つかったときに通知を受けることができます。これは、マッチメイキングプロセスの間、プレイヤーがタイトル内で待機する必要がないことを意味します。プレイヤーは、タイトルのシングルプレイヤー部分をプレイしたり、他のタイトルをプレイしたりしながらも、マッチメイキングの候補にとどまることができます。このアプローチにより、マッチが見つかる前に一定数のプレイヤーが集まる必要がなくなります。

> [!NOTE]
>
> マッチメイキングホッパーは、事前に定義されたセッションテンプレートに基づいている必要があります。

新しい SmartMatch ホッパーを作成するときは、次の表に示す値を定義する必要があります。

| フィールド | 説明 |
| - | - |
| 名前 | マッチメイキングホッパーを特徴付ける名前を入力します。覚えやすく、認識しやすいものを選択します。名前は最大 140 文字のテキスト文字列です。 |
| 最小グループサイズ | 許容される最小プレイヤー数を指定します。最小値は 1 です。 |
| 最大グループサイズ | 許容される最大プレイヤー数を指定します。最大値は 256 です。 |
| ルール拡張サイクル数 | デフォルト値は 3 で、典型的なプレイヤー人口では変更しないでください。 |
| ランクホッパー | ホッパーがランクホッパーとしてマークされている場合、そのホッパー内のプレイヤーは、互いにブロックしていてもマッチングを許可されます。これにより、プレイヤーがよりスキルレベルの高い他のプレイヤーをブロックするのを防ぐことができます。 |
| セッションからの自動更新 | このフィールドが有効化されると、セッションのメンバーリストまたはメンバーのカスタムプロパティに加えられた変更が、以前に送信されたチケットに自動的に伝播されます。 |

> [!NOTE]
>
> タイトルが Final Certification を通過すると、そのタイトルの既存のマッチメイキングホッパーを変更または削除することはできなくなります。

## カスタム招待文字列

タイトルがプレイヤーにマルチプレイヤーゲームへの参加を招待するメッセージを送信するとき、デフォルトの招待文字列の代わりにカスタム招待テキスト文字列を表示することを選択できます。新しいカスタム招待文字列を作成するときは、次の表の値を定義する必要があります。

| フィールド | 説明 |
| - | - |
| ID | カスタム招待文字列の識別子。`custominvitestrings_` が ID の先頭に自動的に追加されます。この文字列の最大長は 100 文字です。 |
| 値 | カスタム招待通知に表示されるカスタム招待文字列のテキスト。この文字列の最大長は 100 文字です。 |

## 追加情報

マルチプレイヤー サービスの構成の詳細については、次のトピックを参照してください。

| トピック名 | 説明 |
| - | - |
| [マルチプレイヤーセッションテンプレート](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/mpsd/concepts/live-session-templates.md) | マルチプレイヤーセッションテンプレートの概要と、コピーして変更できるいくつかのテンプレートの例を提供します。 |
| [セッションテンプレート定数](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/mpsd/concepts/live-session-template-constants.md) | マルチプレイヤーセッションテンプレートの事前定義された要素について説明します。 |
| [Multiplayer 用の大規模セッションの使用](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/mpsd/concepts/live-large-sessions.md) | 大規模セッションを使用するタイミングと方法について説明します。 |


## Related topics

- [概念](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/concepts/index.md)
- [Multiplayer の概念](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/concepts/live-multiplayer-concepts-nav.md)
- [マルチプレイヤー サービスを直接呼び出すことの概要](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/concepts/live-intro-calling-mp-directly.md)
- [XBOX services マルチプレイヤーの概要](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/overviews/live-multiplayer-intro.md)
- [一般的なマルチプレイヤー シナリオ](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/overviews/live-common-multiplayer-scenarios.md)
