Skip to main content

POST (/handles)

設定使用者目前活動的多人遊戲工作階段,並在需要時邀請工作階段成員。
重要:
此方法由 2015 多人遊戲使用,僅適用於該多人遊戲版本及更新版本。其適用於範本合約 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
Last modified on October 6, 2026