> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 工作階段目錄 URI

> 工作階段目錄 URI

# 工作階段目錄 URI

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

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

* [網域](#ID4EUB)
* [服務版本](#ID4EZB)
* [系統物件和屬性](#ID4EAC)
* [控制代碼](#ID4EBE)

<a id="ID4EUB" />

## 網域

sessiondirectory.xboxlive.com

<a id="ID4EZB" />

## 服務版本

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

<a id="ID4EAC" />

## 系統物件和屬性

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

* [MultiplayerActivityDetails (JSON)](/zh-TW/reference/live/rest/json/json-multiplayeractivitydetails)
* [MultiplayerSession (JSON)](/zh-TW/reference/live/rest/json/json-multiplayersession)
* [MultiplayerSessionReference (JSON)](/zh-TW/reference/live/rest/json/json-multiplayersessionreference)
* [MultiplayerSessionRequest (JSON)](/zh-TW/reference/live/rest/json/json-multiplayersessionrequest)

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

* [GameMessage (JSON)](/zh-TW/reference/live/rest/json/json-gamemessage)
* [GameResult (JSON)](/zh-TW/reference/live/rest/json/json-gameresult)
* [GameSession (JSON)](/zh-TW/reference/live/rest/json/json-gamesession)
* [GameSessionSummary (JSON)](/zh-TW/reference/live/rest/json/json-gamesessionsummary)

<a id="ID4EBE" />

## 控制代碼

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

<a id="ID4EFE" />

## 本節內容

[/handles](/zh-TW/reference/live/rest/uri/sessiondirectory/uri-handles)

  支援 POST 作業，以設定使用者目前活動的工作階段，使其顯示在 XBOX One 儀表板使用者體驗中，並在需要時邀請工作階段成員。

[/handles/{handleId}](/zh-TW/reference/live/rest/uri/sessiondirectory/uri-handleshandleid)

  支援針對以識別碼指定之工作階段控制代碼的 DELETE 和 GET 作業。

[/handles/{handleId}/session](/zh-TW/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsession)

  使用控制代碼取值，支援工作階段的 PUT 和 GET 作業。

[/handles/query](/zh-TW/reference/live/rest/uri/sessiondirectory/uri-handlesquery)

  支援 POST 作業，以建立工作階段控制代碼的查詢。

[/serviceconfigs/{scid}/batch](/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidbatch)

  支援在服務設定識別碼層級進行批次查詢的 POST 作業。

[/serviceconfigs/{scid}/sessions](/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessions)

  支援 GET 作業，以擷取一組工作階段文件。

[/serviceconfigs/{scid}/sessiontemplates](/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplates)

  支援 GET 作業，以擷取一組 MPSD 工作階段範本。

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}](/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatename)

  支援 GET 作業，以擷取一組工作階段範本名稱。

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/batch](/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigscidsessiontemplatessessiontemplatenamebatch)

  支援 POST 作業，以在工作階段範本層級建立批次查詢。

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions](/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessions)

  支援 GET 作業，以擷取一組具有指定範本名稱的工作階段範本。

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}](/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionssessionname)

  支援 PUT 和 GET 作業，以建立和擷取工作階段。

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}/members/me](/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionssessionnamemembersme)

  支援 DELETE 作業，以移除工作階段成員。

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}/servers/{server-name}](/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionnamemembersservername)

  支援 DELETE 作業，以移除工作階段的指定伺服器。

<a id="ID4ESF" />

## 另請參閱

<a id="ID4EUF" />

[配對 URI](/zh-TW/reference/live/rest/uri/matchtickets/atoc-reference-matchtickets)

<a id="ID4E1F" />

##### 上層

[統一資源識別碼 (URI) 參考](/zh-TW/reference/live/rest/uri/atoc-xboxlivews-reference-uris)


## Related topics

- [多人遊戲工作階段目錄概觀](/zh-TW/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [多人遊戲工作階段目錄](/zh-TW/services/xbox-services/multiplayer/mpsd/live-xbox-multiplayer-session-directory.md)
- [多人遊戲工作階段目錄 (MPSD)](/zh-TW/services/xbox-services/multiplayer/mpsd/live-mpsd-nav.md)
- [多人遊戲工作階段目錄 (MPSD) 概念](/zh-TW/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-concepts-nav.md)
- [多人遊戲工作階段目錄 (MPSD) 範例程式碼](/zh-TW/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-howto-nav.md)