跳转到主要内容

​
GET (/serviceconfigs//sessiontemplates//sessions/)

获取会话对象。
重要：
此 URI 方法要求每个请求都包含一个 X-Xbl-Contract-Version: 104/105 或更高版本的头元素。

​
备注

此 HTTP/REST 方法读取指定名称的会话文档并检索会话。成功后，它将返回从服务器获取的会话对象及其所有属性。此方法可以由 Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetCurrentSessionAsync 包装。GET 方法的参数直接与会话的 MultiplayerSessionReference 对象中指定的参数对应，该对象在 GetCurrentSessionAsync 的 sessionReference 参数中传递。 GET 方法的线路格式如下所示。

​
URI 参数

| 参数| 类型| 说明| | --- | --- | --- | --- | | scid| GUID| 服务配置标识符 (SCID)。会话标识符的第 1 部分。| | sessionTemplateName| string| 会话模板当前实例的名称。会话标识符的第 2 部分。| | sessionName| GUID| 会话的唯一 ID。会话标识符的第 3 部分。|

​
HTTP 状态代码

服务返回适用于 MPSD 的 HTTP 状态代码。

​
请求正文

此请求正文中不发送任何对象。

​
响应正文

请参阅 MultiplayerSession (JSON) 中的响应结构。

​
另请参阅

上级
/serviceconfigs//sessiontemplates//sessions/
最后修改于 2026年10月19日