会话目录 URI
本部分提供了有关 Xbox Live 服务面向多人游戏会话目录 (MPSD) 的统一资源标识符 (URI) 地址和关联超文本传输协议 (HTTP) 方法的详细信息。
注意：
只有在 Xbox 360、Windows Phone 设备或 Xbox.com 上运行的游戏可以使用会话目录 URI。
域
服务版本
这些 REST URI 的调用方必须为 X-Xbl-Contract-Version（指定 Entertainment Discovery Services (EDS) 服务版本的 HTTP 标头）传递值 104/105 或之后的值。
系统对象和属性
对于会话和模板的配置，MPSD 使用许多会话 JSON 对象，这些对象符合目录强制执行和解释的固定架构。 在调用各种会话目录 URI 支持的方法期间，将根据所支持的架构验证和合并这些对象。 与多人游戏配置关联的主要 JSON 对象包括：
- MultiplayerActivityDetails (JSON)
- MultiplayerSession (JSON)
- MultiplayerSessionReference (JSON)
- MultiplayerSessionRequest (JSON)
具体涉及到游戏的关联 JSON 对象包括：
句柄
仅就 2015 年的多人游戏而言，可通过会话句柄访问会话。 添加了几个 URI 以提供支持句柄的功能。
本部分内容
支持执行 POST 操作来为用户当前活动设置会话，以便在 Xbox One 仪表板用户体验中显示，并在需要时邀请会话成员。
支持对标识符指定的会话句柄执行 DELETE 和 GET 操作。
支持使用句柄取消引用对会话执行 PUT 和 GET 操作。
支持执行 POST 操作来为会话句柄创建查询。
支持在服务配置标识符级别针对批处理查询执行 POST 操作。
/serviceconfigs/{scid}/sessions
支持执行 GET 操作以检索一组会话文档。
/serviceconfigs/{scid}/sessiontemplates
支持执行 GET 操作以检索一组 MPSD 会话模板。
/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}
支持执行 GET 操作以检索一组会话模板名称。
/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/batch
支持在会话模板级别执行 POST 操作以创建批处理查询。
/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions
支持执行 GET 操作以检索一组具有指定模板名称的会话模板。
/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}
支持执行 PUT 和 GET 操作以创建和检索会话。
/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}/members/me
支持执行 DELETE 操作以删除会话成员。
支持执行 DELETE 操作以删除会话的指定服务器。