GET (/handles/{handleId}/session)
指定したハンドルの識別子は、セッション オブジェクトを取得します。
重要:
このメソッドは、2015 Multiplayer によって使用され、そのバージョン以降のマルチプレイヤーにのみ適用されます。 これは 104/105 以降のテンプレート コントラクトで使用するためのもので、すべての要求でヘッダー要素 X-Xbl-Contract-Version: に 104/105 以降を指定する必要があります。
解説
この HTTP/REST メソッドは、サービス側の、セッションへの指定されたポインター (ハンドル) を使用して、サーバーからセッション オブジェクトを取得します。 返されるのは、すべての属性を含むセッション オブジェクトです。 このメソッドは、Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetCurrentSessionByHandleAsync でラップすることができます。
このメソッドの呼び出し元は、プレイヤーの MultiplayerActivityDetails オブジェクトからハンドル ID を取得します。 または、ユーザーがゲームへの招待を受け入れた後、呼び出し元はプロトコルのアクティベーションから ID を取得します。
URI パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| handleId | GUID | セッションのハンドルの一意の ID。 |
HTTP ステータス コード
サービスは、MPSD に適用される HTTP ステータス コードを返します。
リクエストの本文
この要求の本体で送信されるオブジェクトはありません。
応答の本文
「MultiplayerSession (JSON)」の応答の構造を参照してください。