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

POST (/handles)

ユーザーの現在のアクティビティに対するマルチプレイヤー セッションを設定し、必要に応じてセッション メンバーを招待します。
重要:
このメソッドは 2015 Multiplayer で使用され、そのマルチプレイヤー バージョン以降にのみ適用されます。テンプレート コントラクト 104/105 以降での使用を意図しており、すべてのリクエストにヘッダー要素 X-Xbl-Contract-Version: 104/105 以降が必要です。

解説

この HTTP/REST メソッドは、現在のアクティビティのセッションを設定するために使用できます。この場合、このメソッドは Microsoft.Xbox.Services.Multiplayer.MultiplayerService.SetActivityAsync によってラップできます。リクエスト本文では、JSON ファイル内の sessionRef オブジェクトを使用してセッション参照を定義し、type フィールドを “activity” に設定する必要があります。レスポンス本文は取得されません。セッション参照で指定される項目の定義については、Microsoft.Xbox.Services.Multiplayer.MultiplayerSessionReference を参照してください。 この POST メソッドは、ハンドルで指定されたユーザーをセッションに招待するためにも使用できます。この場合、このメソッドは Microsoft.Xbox.Services.Multiplayer.MultiplayerService.SendInvitesAsync によってラップできます。POST メソッドをこのように使用する場合は、リクエスト本文でセッション参照を定義する必要がありますが、type フィールドは “invite” に設定します。レスポンス本文は招待ハンドルです。

URI パラメーター

なし

HTTP ステータス コード

サービスは、MPSD に適用される HTTP ステータス コードを返します。

リクエスト本文

アクティビティ設定のためのリクエスト本文

招待送信のためのリクエスト本文

レスポンス本文

アクティビティ設定のためのレスポンス本文

なし。

招待送信のためのレスポンス本文

招待ハンドル。

関連項目

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