セッション ディレクトリ URI
ここでは、Xbox Live サービスの Multiplayer Session Directory (MPSD) についてのユニバーサル リソース識別子 (URI) アドレスおよび関連するハイパー テキスト転送プロトコル (HTTP) のメソッドについて詳しく説明します。
注:
Xbox 360、Windows Phone デバイス、または Xbox.com で実行されているゲームのタイトルのみがセッション ディレクトリ URI を使用できます。
ドメイン
サービスのバージョン
これらの REST URI の呼び出し元は、Entertainment Discovery Services (EDS) のサービス バージョンを指定する HTTP ヘッダーである X-Xbl-Contract-Version に、104/105 以降の値を渡す必要があります。
システム オブジェクトおよびプロパティ
セッションとテンプレートの構成について、MPSD は、ディレクトリが適用および解釈する固定のスキーマに準拠した複数のセッション JSON オブジェクトを使用します。 さまざまなセッション ディレクトリ URI によってサポートされているメソッドの呼び出し時に、これらのオブジェクトは、サポートされているスキーマに基づいて検証およびマージされます。 マルチプレイヤーの構成に関連付けられている主な JSON オブジェクトは、次のとおりです。
- MultiplayerActivityDetails (JSON)
- MultiplayerSession (JSON)
- MultiplayerSessionReference (JSON)
- MultiplayerSessionRequest (JSON)
特にゲームに関係する関連付けられた JSON オブジェクトは、次のとおりです。
ハンドル
2015 マルチプレイヤーのみ、セッション ハンドルを使用してセッションにアクセスできます。 ハンドルをサポートする機能を提供するために、複数の URI が追加されました。
このセクションの内容
ユーザーの現在のアクティビティが Xbox One ダッシュボードのユーザー エクスペリエンスに表示され、必要な場合はセッション メンバーを招待するようにセッションを設定する POST 操作をサポートしています。
識別子で指定されたセッション ハンドルに対して、DELETE および GET 操作をサポートします。
ハンドルの逆参照を使用して、セッションの PUT と GET 操作をサポートします。
セッション ハンドルに対するクエリを作成する POST 操作をサポートします。
バッチ クエリの POST 操作をサービス構成 ID レベルでサポートします。
/serviceconfigs/{scid}/sessions
セッションのドキュメントのセットを取得するための GET 操作をサポートします。
/serviceconfigs/{scid}/sessiontemplates
MPSD セッション テンプレートのセットを取得するための GET 操作をサポートします。
/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}
セッションのテンプレート名のセットを取得するための GET 操作をサポートします。
/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/batch
セッション テンプレートのレベルでバッチ クエリを作成するために POST 操作をサポートします。
/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions
指定されたテンプレート名のセッション テンプレートを取得する GET 操作をサポートします。
/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}
セッションの作成と取得を行う PUT 操作と GET 操作をサポートします。
/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}/members/me
セッションのメンバーを削除する DELETE 操作をサポートします。
セッションの指定されたサーバーを削除する DELETE 操作をサポートします。