Skip to main content

​
POST (/users/xuid()/devices/current/titles/current)

以使用者的目前狀態更新遊戲。 這些 URI 的網域為 userpresence.xboxlive.com。

​
備註

非主機平台上的所有遊戲都可以使用此 URI，為遊戲新增及更新目前狀態、豐富目前狀態和媒體目前狀態資料。 SandboxId 現在會從 XToken 中的宣告擷取並強制執行。如果 SandboxId 不存在，則 Entertainment Discovery Services (EDS) 會擲回 400 Bad request 錯誤。

​
URI 參數

​
授權

| 類型| 必要| 描述| 遺漏時的回應| | --- | --- | --- | --- | --- | --- | --- | | XUID| 是| 呼叫端的 XBOX 使用者識別碼 (XUID)| 403 Forbidden| | titleId| 是| 遊戲的 titleId| 403 Forbidden| | deviceId| 除了 Windows 和 Web 以外皆為是| 呼叫端的 deviceId| 403 Forbidden| | deviceType| 除了 Web 以外皆為是| 呼叫端的 deviceType| 403 Forbidden| | sandboxId| 來自以下來源的呼叫為是 | 呼叫端的沙箱| 403 Forbidden|

​
必要的要求標頭

| 標頭| 類型| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| string| HTTP 驗證的驗證認證。範例值：“XBL3.0 x=<userhash>;<token>”。| | x-xbl-contract-version| string| 此要求應導向之 XBOX LIVE 服務的組建名稱/編號。只有在驗證標頭的有效性、驗證權杖中的宣告等之後，要求才會路由至該服務。範例值：3、vnext。| | Content-Type| string| 要求本文的 MIME 類型。範例值：application/json。| | Content-Length| string| 要求本文的長度。範例值：312。| | Host| string| 伺服器的網域名稱。範例值：presencebeta.xboxlive.com。|

​
選用的要求標頭

| 標頭| 類型| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| | 此要求應導向之 XBOX LIVE 服務的組建名稱/編號。只有在驗證標頭的有效性、驗證權杖中的宣告等之後，要求才會路由至該服務。預設值：1。|

​
要求本文

要求物件是 TitleRequest。只有實際存在於本文中的屬性才會更新。任何不屬於本文但存在於伺服器上的屬性都不會被修改。

​
要求範例

​
回應本文

成功時，會視情況傳回 HTTP 狀態碼 200 或 201 Created。 發生錯誤時 (HTTP 4xx 或 5xx)，會在回應本文中傳回適當的錯誤資訊。

​
另請參閱

上層
/users/xuid()/devices/current/titles/current
詳細資訊
Marketplace URI 其他參考
Last modified on October 6, 2026