POST (/users/xuid({xuid})/devices/current/titles/current)

使用用户状态更新游戏。这些 URI 的域是 userpresence.xboxlive.com。

备注

非主机平台上的所有游戏都可使用此 URI 来添加和更新游戏状态、丰富状态和媒体状态数据。

SandboxId 现在从 XToken 中的声明检索并强制执行。如果 SandboxId 未显示，Entertainment Discovery Services (EDS) 将引发“400 无效的请求”错误。

参数	类型	说明
xuid	64 位无符号整数	目标用户的 Xbox 用户 ID (XUID)。

类型	必需	说明	缺少时的响应
XUID	是	调用方的 Xbox 用户 ID (XUID)	403 已禁止
titleId	是	游戏的 titleId	403 已禁止
deviceId	所有均为“是”（除 Windows 和 Web 外）	调用方的 deviceId	403 已禁止
deviceType	所有均为“是”（除 Web 外）	调用方的 deviceType	403 已禁止
sandboxId	对于来自调用方	沙盒的调用为“是”	403 已禁止

标头	类型	说明
授权	字符串	HTTP 身份验证的身份验证凭据。示例值：“XBL3.0 x=<userhash>;<token>”。
x-xbl-contract-version	字符串	此请求应定向到的 Xbox LIVE 服务的版本名称/版本号。在验证标头的有效性、身份验证令牌中的声明等信息之后，请求将仅路由到该服务。示例值：3，vnext。
Content-Type	字符串	请求正文的 mime 类型示例值：application/json。
Content-Length	字符串	请求正文的长度。示例值：312。
主机	字符串	服务器域名。示例值：presencebeta.xboxlive.com。

标头	类型	说明
X-RequestedServiceVersion		此请求应定向到的 Xbox LIVE 服务的版本名称/版本号。在验证标头的有效性、身份验证令牌中的声明等信息之后，请求将仅路由到该服务。默认值：1。

请求对象为 TitleRequest。将更新仅实际出现在正文中的属性。存在于服务器上但不是正文一部分的任何属性均不会修改。

{
  id:"12341234",
  placement:"snapped",
  state:"active"
}

如果成功，将根据需要返回已创建的 HTTP 状态代码 200 或 201。

如果发生错误（HTTP 4xx 或 5xx），将在响应正文中返回相应的错误信息。