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

> 检查和管理一个游戏的 PlayFab 服务,以及每个 playfab 命令共享的选项和响应信封。

`xbox playfab` 检查和管理一个 PlayFab 游戏的 PlayFab 服务。每个服务都有自己的页面。

```text theme={null}
xbox playfab <command> [flags]
```

除工作室命令(`service-principal` 以及使用 `/Studio/` 路径的 `api`)外,每个 `playfab` 命令都需要 PlayFab 游戏 ID。请传递 `--playfab-title-id`,或者使用 `xbox context set playfab-title-id <id>` 保存默认值;请参阅[上下文](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/context.md)。

## 命令

| 命令 | 说明 |
| - | - |
| [`api`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/playfab/api) | 直接调用任何 PlayFab API 终结点。 |
| [`mps`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/playfab/mps) | 管理多人游戏服务器 (MPS)(实验性)。 |
| [`file`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/playfab/file) | 管理实体文件。 |
| [`title-data`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/playfab/title-data) | 管理游戏数据键/值对。 |
| [`api-policy`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/playfab/api-policy) | 管理游戏的 API 访问策略。 |
| [`cloudscript`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/playfab/cloudscript) | 管理脚本和函数注册(实验性)。 |
| [`group`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/playfab/group) | 管理组和成员身份(实验性)。 |
| [`player-data`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/playfab/player-data) | 管理游戏范围或发行商范围的玩家数据。 |
| [`economy`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/playfab/economy) | 管理 Economy v2 库存。 |
| [`experiment`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/playfab/experiment) | 读取游戏的 A/B 试验、记分卡、处理分配和排除组(实验性)。 |
| [`player`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/playfab/player) | 查找玩家帐户(实验性)。 |
| [`privacy`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/playfab/privacy) | 导出玩家的数据,并列出其玩过的游戏(实验性)。 |
| [`service-principal`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/playfab/service-principal) | 授予、检查和撤销 Microsoft Entra ID 服务主体对工作室及其游戏的访问权限(实验性)。 |

## 选项

除了[全局选项](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands.md#global-options)之外,每个 `playfab` 命令还接受以下选项。

| 选项 | 说明 |
| - | - |
| `--data-only` | 去掉 PlayFab `{code,status,data}` 响应信封,仅写入 `data` 字段。 |
| `--confirm`, `--yes`, `-y` | 确认 `Delete*` 或 `Shutdown*` PlayFab API 操作。在交互式终端之外是必需的。请参阅[安全性和破坏性操作](https://docs.xbox.com/zh-CN/tools/xbox-cli/safety.md)。 |

## 响应信封

默认情况下,命令会写入 PlayFab 的完整响应信封:

```json theme={null}
{
  "code": 200,
  "status": "OK",
  "data": {
    "Data": {
      "SettingA": "the value"
    }
  }
}
```

添加 `--data-only` 可仅写入 `data` 有效负载,添加 `--output json-compact` 可输出单行 JSON:

```bash theme={null}
xbox --playfab-title-id ABC123 --data-only --output json-compact playfab api /Admin/GetTitleData
```

`file upload`、`file download` 和 `file delete` 不返回信封。它们不向 stdout 写入任何内容,而是在 stderr 上报告其执行的操作。请参阅[文件](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/playfab/file.md#output)。


## Related topics

- [PlayFab 支持](https://docs.xbox.com/zh-CN/services/playfab/pricing/support.md)
- [C# PlayFab SDK](https://docs.xbox.com/zh-CN/services/playfab/sdks/c-sharp/index.md)
- [PlayFab 概念](https://docs.xbox.com/zh-CN/services/playfab/get-started/concepts.md)
- [PlayFab 基础](https://docs.xbox.com/zh-CN/services/playfab/get-started/index.md)
- [PlayFab Party](https://docs.xbox.com/zh-CN/build/console-features/networking/game-mesh/playfab-party-intro-networking.md)
