> ## 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-CN/reference/live/rest/json/json-activityrequest) | 标题内的信息,包括丰富在线状态和媒体信息(如果可用)。 |
| 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 对象表示法 (JSON) 对象参考](/zh-CN/reference/live/rest/json/atoc-xboxlivews-reference-json)

##### 参考

[POST (/users/xuid({xuid})/devices/current/titles/current)](/zh-CN/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)