Skip to main content

​
GET (/handles//session)

取得指定控制代碼識別碼的工作階段物件。
重要：
此方法由 2015 多人遊戲使用，僅適用於該多人遊戲版本及更新版本。其適用於範本合約 104/105 或更新版本，且每個要求都需要 X-Xbl-Contract-Version: 104/105 或更新版本的標頭元素。

​
備註

此 HTTP/REST 方法會使用提供的工作階段服務端指標 (控制代碼)，從伺服器擷取工作階段物件。傳回值為工作階段物件及其所有屬性。此方法可由 Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetCurrentSessionByHandleAsync 包裝。 此方法的呼叫者會從玩家的 MultiplayerActivityDetails 物件取得控制代碼識別碼。或者，呼叫者會在使用者接受遊戲邀請後，從通訊協定啟用取得該識別碼。

​
URI 參數

| 參數| 類型| 描述| | --- | --- | --- | --- | | handleId| GUID| 工作階段控制代碼的唯一識別碼。|

​
HTTP 狀態碼

服務會傳回適用於 MPSD 的 HTTP 狀態碼。

​
要求本文

此要求的本文中不會傳送任何物件。

​
回應本文

請參閱 MultiplayerSession (JSON) 中的回應結構。

​
另請參閱

上層
/handles//session
Last modified on October 6, 2026