メインコンテンツへスキップ

GET (/handles/)

ハンドル ID で指定されたハンドルを取得します。
重要:
このメソッドは 2015 Multiplayer で使用され、そのマルチプレイヤー バージョン以降にのみ適用されます。テンプレート コントラクト 104/105 以降で使用することを意図しており、リクエストごとに X-Xbl-Contract-Version: 104/105 以降のヘッダー要素が必要です。

備考

この HTTP/REST メソッドは、指定されたハンドルについて、そのセッションのユーザーの現在のアクティビティを取得します。返されるのは、すべての属性を含むセッション オブジェクトです。このメソッドは Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetCurrentSessionByHandleAsync でラップできます。 このメソッドの呼び出し元は、プレイヤーの MultiplayerActivityDetails オブジェクトからハンドル ID を取得します。あるいは、ユーザーがゲームの招待を受け入れた後のプロトコル アクティベーションから ID を取得します。

URI パラメーター

| Parameter| Type| Description| | --- | --- | --- | --- | | handleId| GUID| セッションのハンドルの一意の ID。|

HTTP ステータス コード

サービスは MPSD に該当する HTTP ステータス コードを返します。

リクエスト本文

このリクエストの本文にはオブジェクトは送信されません。

レスポンス本文

レスポンス構造については「MultiplayerSession (JSON)」を参照してください。

関連項目

親
/handles/
最終更新日 2026年10月19日