> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TitleRequest (JSON)

> TitleRequest (JSON)

# TitleRequest (JSON)

要求遊戲的相關資訊。

## TitleRequest

TitleRequest 物件具有下列規格。

| 成員 | 類型 | 描述 |
| - | - | - |
| id | 32 位元不帶正負號的整數 | 遊戲的識別碼。 |
| activity | [ActivityRequest](/zh-TW/reference/live/rest/json/json-activityrequest) | 遊戲內資訊，包括 Rich Presence 和媒體資訊 (如果有的話)。 |
| state | string | 使用者是否處於使用中。若要將使用者標示為非使用中，此欄位為必要。預設值為 "active"。 |
| placement | string | 遊戲的放置模式。可能的值包括 "full"、"fill"、"snapped" 或 "background"。預設值為 "full"。 |

## 範例 JSON 語法

```json theme={null}
{
  id:"12341234",
  placement:"snapped",
  state:"active",
  activity:
  {
    richPresence:
    {
      id:"playingMapWeapon",
      scid:"82b11353-08ba-48ca-9f1a-21627b189b0f"
    }
  }
}
    
```

## 另請參閱

##### 上層

[JavaScript Object Notation (JSON) 物件參考](/zh-TW/reference/live/rest/json/atoc-xboxlivews-reference-json)

##### 參考

[POST (/users/xuid({xuid})/devices/current/titles/current)](/zh-TW/reference/live/rest/uri/presence/uri-usersxuiddevicescurrenttitlescurrentpost)


## Related topics

- [Updating a user's Presence via REST](/services/xbox-services/community/presence/how-to/live-updating-presence-rest.md)
- [REST를 통한 사용자 Presence 업데이트](/ko/services/xbox-services/community/presence/how-to/live-updating-presence-rest.md)
- [Atualizando a presença de um usuário via REST](/pt-BR/services/xbox-services/community/presence/how-to/live-updating-presence-rest.md)
- [Actualización de la presencia de un usuario mediante REST](/es/services/xbox-services/community/presence/how-to/live-updating-presence-rest.md)
- [Mise à jour de la présence d'un utilisateur au moyen de REST](/fr-CA/services/xbox-services/community/presence/how-to/live-updating-presence-rest.md)