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

# 玩家帐户

> 根据玩家的 PlayFab ID 查找其帐户信息。

`playfab player` 命令系列属于实验性功能。其 CLI 接口可能会根据反馈而更改或被删除。

读取玩家的帐户信息。

| 命令 | PlayFab API 路径 | 说明 |
| - | - | - |
| `playfab player account get` | `/Admin/GetUserAccountInfo` | 根据玩家的 PlayFab ID 获取其帐户。 |

`player account get` 需要 `--playfab-id`,并且不接受 `--output table`。

```bash theme={null}
xbox --playfab-title-id ABC123 playfab player account get --playfab-id PLAYER123
```

## 要传递哪个 ID

`--playfab-id` 接受玩家的**主玩家帐户 ID**,即 PlayFab 的玩家登录 API 返回的 PlayFab ID。

PlayFab 还会为每个玩家提供一个**游戏玩家帐户 ID**。它看起来一样,都是 16 个十六进制字符,并且 Game Manager 会同时显示两者,但 `GetUserAccountInfo` 会拒绝它:

```console theme={null}
$ xbox --playfab-title-id ABC123 playfab player account get --playfab-id TITLEPLAYER123
{"code":400,"status":"BadRequest","error":"AccountNotFound","errorCode":1001,"errorMessage":"User not found"}
```

如果对你确定存在的玩家的查找失败,请检查你传递的是否为主玩家帐户 ID。

该命令无法按电子邮件、用户名、显示名称或平台 ID(例如 XBOX 用户 ID)查找玩家。请先在 Game Manager 中找到该玩家,以获取其 PlayFab ID。

## 返回的内容

响应是玩家的完整帐户记录,包括每个已关联的平台帐户,以及其他命令(例如
[`playfab file`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/playfab/file))所使用的游戏玩家帐户 ID:

```bash theme={null}
xbox --playfab-title-id ABC123 --data-only playfab player account get --playfab-id PLAYER123
```

```json theme={null}
{
  "UserInfo": {
    "PlayFabId": "PLAYER123",
    "Created": "2026-08-27T16:03:09.477Z",
    "TitleInfo": {
      "Origination": "CustomId",
      "DisplayName": "Hero",
      "isBanned": false,
      "TitlePlayerAccount": { "Id": "TITLEPLAYER123", "Type": "title_player_account" }
    },
    "SteamInfo": { "SteamId": "76561197960287930", "SteamCountry": "US" },
    "PsnInfo": { "PsnAccountId": "1234567890", "PsnOnlineId": "player1" },
    "PrivateInfo": { "Email": "player@example.com" }
  }
}
```

该记录可能包含个人信息,例如玩家的电子邮件地址。PlayFab 建议不要在本地存储这些信息,因此请注意保存输出或通过管道传输输出的位置。


## Related topics

- [删除主玩家帐户](https://docs.xbox.com/zh-CN/services/playfab/api-references/rest/admin/account-management/delete-master-player-account.md)
- [通过主玩家帐户 ID 获取游戏玩家](https://docs.xbox.com/zh-CN/services/playfab/api-references/rest/profiles/account-management/get-title-players-from-master-player-account-ids.md)
- [使用玩家详情](https://docs.xbox.com/zh-CN/services/playfab/player-progression/player-data/player-details.md)
- [PFProfilesGetTitlePlayersFromMasterPlayerAccountIdsAsync](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfprofiles/functions/pfprofilesgettitleplayersfrommasterplayeraccountidsasync.md)
- [player_created](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/PlayerIdentity/player-created.md)
