工作階段目錄 URI

本節提供 XBOX Live 服務中多人遊戲工作階段目錄 (MPSD) 的統一資源識別碼 (URI) 位址及相關聯超文字傳輸通訊協定 (HTTP) 方法的詳細資料。

注意：
只有在 XBOX 360、Windows Phone 裝置或 Xbox.com 上執行的遊戲才能使用工作階段目錄 URI。

網域

sessiondirectory.xboxlive.com

這些 REST URI 的呼叫者必須為 X-Xbl-Contract-Version 傳遞 104/105 或更新的值，此 HTTP 標頭用於指定 Entertainment Discovery Services (EDS) 的服務版本。

為了設定其工作階段和範本，MPSD 使用許多符合固定結構描述的工作階段 JSON 物件，這些結構描述由目錄強制執行並解譯。在呼叫各種工作階段目錄 URI 所支援的方法期間，會根據支援的結構描述驗證並合併這些物件。與多人遊戲設定相關聯的主要 JSON 物件如下：

與遊戲特別相關的 JSON 物件如下：

僅限 2015 多人遊戲，可以透過工作階段控制代碼存取工作階段。已新增數個 URI 以提供支援控制代碼的功能。

/handles 支援 POST 作業，以設定使用者目前活動的工作階段，使其顯示在 XBOX One 儀表板使用者體驗中，並在需要時邀請工作階段成員。 /handles/ 支援針對以識別碼指定之工作階段控制代碼的 DELETE 和 GET 作業。 /handles//session 使用控制代碼取值，支援工作階段的 PUT 和 GET 作業。 /handles/query 支援 POST 作業，以建立工作階段控制代碼的查詢。 /serviceconfigs//batch 支援在服務設定識別碼層級進行批次查詢的 POST 作業。 /serviceconfigs//sessions 支援 GET 作業，以擷取一組工作階段文件。 /serviceconfigs//sessiontemplates 支援 GET 作業，以擷取一組 MPSD 工作階段範本。 /serviceconfigs//sessiontemplates/ 支援 GET 作業，以擷取一組工作階段範本名稱。 /serviceconfigs//sessiontemplates//batch 支援 POST 作業，以在工作階段範本層級建立批次查詢。 /serviceconfigs//sessiontemplates//sessions 支援 GET 作業，以擷取一組具有指定範本名稱的工作階段範本。 /serviceconfigs//sessiontemplates//sessions/ 支援 PUT 和 GET 作業，以建立和擷取工作階段。 /serviceconfigs//sessiontemplates//sessions//members/me 支援 DELETE 作業，以移除工作階段成員。 /serviceconfigs//sessiontemplates//sessions//servers/ 支援 DELETE 作業，以移除工作階段的指定伺服器。