> ## 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.

# Session Directory URIs

> Session Directory URIs

# 会话目录 URI

本节详细介绍与多人游戏会话目录 (MPSD) 相关的、来自 XBOX Live 服务的通用资源标识符 (URI) 地址及其关联的超文本传输协议 (HTTP) 方法。

> **注意：**\
> 只有在 XBOX 360、Windows Phone 设备或 Xbox.com 上运行的游戏 title 才能使用会话目录 URI。

* [域](#ID4EUB)
* [服务版本](#ID4EZB)
* [系统对象和属性](#ID4EAC)
* [句柄](#ID4EBE)

## 域

sessiondirectory.xboxlive.com

## 服务版本

这些 REST URI 的调用方必须为 X-Xbl-Contract-Version 传递 104/105 或更高版本的值，该 HTTP 头指定娱乐发现服务 (EDS) 的服务版本。

## 系统对象和属性

在配置其会话和模板时，MPSD 使用一系列符合固定架构的会话 JSON 对象，这些架构由目录强制执行和解释。在调用各种会话目录 URI 支持的方法期间，将根据受支持的架构对这些对象进行验证和合并。与多人游戏配置关联的主要 JSON 对象包括：

* [MultiplayerActivityDetails (JSON)](https://devdocs.xbox.com/zh-CN/reference/live/rest/json/json-multiplayeractivitydetails)
* [MultiplayerSession (JSON)](https://devdocs.xbox.com/zh-CN/reference/live/rest/json/json-multiplayersession)
* [MultiplayerSessionReference (JSON)](https://devdocs.xbox.com/zh-CN/reference/live/rest/json/json-multiplayersessionreference)
* [MultiplayerSessionRequest (JSON)](https://devdocs.xbox.com/zh-CN/reference/live/rest/json/json-multiplayersessionrequest)

专门涉及游戏的关联 JSON 对象包括：

* [GameMessage (JSON)](https://devdocs.xbox.com/zh-CN/reference/live/rest/json/json-gamemessage)
* [GameResult (JSON)](https://devdocs.xbox.com/zh-CN/reference/live/rest/json/json-gameresult)
* [GameSession (JSON)](https://devdocs.xbox.com/zh-CN/reference/live/rest/json/json-gamesession)
* [GameSessionSummary (JSON)](https://devdocs.xbox.com/zh-CN/reference/live/rest/json/json-gamesessionsummary)

## 句柄

仅对于 2015 多人游戏，可以通过会话句柄访问会话。已添加多个 URI 以提供支持句柄的功能。

## 本节内容

[/handles](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/sessiondirectory/uri-handles)

  支持 POST 操作，用于将用户当前活动的会话设置为在 XBOX One 仪表板用户体验中显示，并在需要时邀请会话成员。

[/handles/{handleId}](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/sessiondirectory/uri-handleshandleid)

  支持通过标识符指定的会话句柄的 DELETE 和 GET 操作。

[/handles/{handleId}/session](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsession)

  使用句柄取消引用来支持会话的 PUT 和 GET 操作。

[/handles/query](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/sessiondirectory/uri-handlesquery)

  支持 POST 操作以创建会话句柄的查询。

[/serviceconfigs/{scid}/batch](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidbatch)

  在服务配置标识符级别支持 POST 操作以进行批处理查询。

[/serviceconfigs/{scid}/sessions](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessions)

  支持 GET 操作以检索一组会话文档。

[/serviceconfigs/{scid}/sessiontemplates](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplates)

  支持 GET 操作以检索一组 MPSD 会话模板。

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatename)

  支持 GET 操作以检索一组会话模板名称。

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/batch](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/sessiondirectory/uri-serviceconfigscidsessiontemplatessessiontemplatenamebatch)

  支持 POST 操作以在会话模板级别创建批处理查询。

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessions)

  支持 GET 操作以检索一组具有指定模板名称的会话模板。

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionssessionname)

  支持 PUT 和 GET 操作以创建和检索会话。

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}/members/me](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionssessionnamemembersme)

  支持 DELETE 操作以移除会话成员。

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}/servers/{server-name}](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionnamemembersservername)

  支持 DELETE 操作以移除会话的指定服务器。

## 另请参阅

[匹配 URI](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/matchtickets/atoc-reference-matchtickets)

##### 上级

[统一资源标识符 (URI) 参考](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/atoc-xboxlivews-reference-uris)


## Related topics

- [Multiplayer Session Directory overview](https://devdocs.xbox.com/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [Multiplayer Session Directory 개요](https://devdocs.xbox.com/ko/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [Vue d'ensemble de Multiplayer Session Directory](https://devdocs.xbox.com/fr-CA/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [Multiplayer Session Directory の概要](https://devdocs.xbox.com/ja-jp/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [Multiplayer Session advanced topics](https://devdocs.xbox.com/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-details.md)