会话目录 URI

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

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

域

sessiondirectory.xboxlive.com

这些 REST URI 的调用方必须为 X-Xbl-Contract-Version 传递 104/105 或更高版本的值，该 HTTP 头指定娱乐发现服务 (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 操作以移除会话的指定服务器。