GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName})

获取会话对象。

重要提示:
此 URI 方法需要每个请求都有一个 X-Xbl-Contract-Version 104/105 或更高版本的标头元素。

备注

此 HTTP/REST 方法读取指定名称的会话文档并检索会话。 如果成功,它将返回从服务器获取的会话对象及其所有属性。 此方法可由 Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetCurrentSessionAsync 包装。 GET 方法的参数直接与会话(在 GetCurrentSessionAsyncsessionReference 参数中传递)的 MultiplayerSessionReference 对象中指定的参数并行。

GET 方法的有线格式如下所示。

GET /serviceconfigs/00000000-0000-0000-0000-000000000000/sessiontemplates/quick/sessions/00000000-0000-0000-0000-000000000001 HTTP/1.1
      Content-Type: application/json

URI 参数

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

HTTP 状态代码

该服务返回 HTTP 状态代码,因为它适用于 MPSD。

请求正文

对象不会在此请求的正文中发送。

响应正文

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

另请参阅

父级

/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}