> ## 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.

# Player (JSON)

> Player (JSON)

# Player (JSON)

包含遊戲工作階段中玩家的資料。

<a id="ID4EN" />

## Player

Player 物件具有下列規格。

| 成員 | 類型 | 描述 |
| - | - | - |
| customData | 8 位元不帶正負號的整數陣列 | 1024 位元組的 Base64 編碼遊戲特定玩家資料。此值對伺服器而言是不透明的。 |
| gamertag | string | 玩家的玩家代號 (最多 15 個字元)。用戶端在 UI 中識別玩家時應使用此值。 |
| isCurrentlyInSession | 布林值 | 指出玩家目前是否在工作階段中，或已離開工作階段。 |
| seatIndex | 32 位元帶正負號的整數 | 玩家在工作階段中的索引。 |
| xuid | 64 位元不帶正負號的整數 | 玩家的 XBOX 使用者識別碼 (XUID)。 |

<a id="ID4E3C" />

## 範例 JSON 語法

```json theme={null}
{
    "xuid": 2533274790412952,
    "gamertag":"MyTestUser",
    "seatindex": 3
    "customData":"AIHJ2?iE?/jiKE!l5S=T..."
    "isCurrentlyInSession":"true"
}
    
```

<a id="ID4EFD" />

## 另請參閱

<a id="ID4EHD" />

##### 上層

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

<a id="ID4ERD" />

##### 參考

[GameSession (JSON)](/zh-TW/reference/live/rest/json/json-gamesession)


## Related topics

- [player_authenticated](/services/playfab/api-references/events/PlayerIdentity/player-authenticated.md)
- [Delete Player](/services/playfab/api-references/rest/admin/account-management/delete-player.md)
- [Report Player](/services/playfab/api-references/rest/client/account-management/report-player.md)