> ## 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 遊戲識別碼。請傳遞 `--playfab-title-id`，或使用 `xbox context set playfab-title-id <id>` 儲存預設值；請參閱[內容](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/context.md)。

## 命令

| 命令 | 描述 |
| - | - |
| [`api`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/playfab/api) | 直接呼叫任何 PlayFab API 端點。 |
| [`mps`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/playfab/mps) | 管理多人遊戲伺服器 (MPS) (實驗性)。 |
| [`file`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/playfab/file) | 管理實體檔案。 |
| [`title-data`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/playfab/title-data) | 管理遊戲資料索引鍵/值組。 |
| [`api-policy`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/playfab/api-policy) | 管理遊戲的 API 存取原則。 |
| [`cloudscript`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/playfab/cloudscript) | 管理指令碼和函式註冊 (實驗性)。 |
| [`group`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/playfab/group) | 管理群組和成員資格 (實驗性)。 |
| [`player-data`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/playfab/player-data) | 管理遊戲範圍或發行者範圍的玩家資料。 |
| [`economy`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/playfab/economy) | 管理 Economy v2 物品欄。 |
| [`experiment`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/playfab/experiment) | 讀取遊戲的 A/B 實驗、計分卡、處理方式指派和排除群組 (實驗性)。 |
| [`player`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/playfab/player) | 查閱玩家帳戶 (實驗性)。 |
| [`privacy`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/playfab/privacy) | 匯出玩家的資料，並列出他們玩過的遊戲 (實驗性)。 |
| [`service-principal`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/playfab/service-principal) | 授與、檢查及撤銷 Microsoft Entra ID 服務主體對工作室及其遊戲的存取權 (實驗性)。 |

## 選項

除了[全域選項](https://docs.xbox.com/zh-TW/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-TW/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-TW/tools/xbox-cli/commands/playfab/file.md#output)。


## Related topics

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