> ## 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/ko/tools/xbox-cli/commands/context.md)를 참조하세요.

## 명령

| 명령 | 설명 |
| - | - |
| [`api`](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab/api) | 모든 PlayFab API 엔드포인트를 직접 호출합니다. |
| [`mps`](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab/mps) | Multiplayer Servers(MPS)를 관리합니다(실험적). |
| [`file`](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab/file) | 엔터티 파일을 관리합니다. |
| [`title-data`](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab/title-data) | 타이틀 데이터 키/값 쌍을 관리합니다. |
| [`api-policy`](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab/api-policy) | 타이틀의 API 액세스 정책을 관리합니다. |
| [`cloudscript`](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab/cloudscript) | 스크립트와 함수 등록을 관리합니다(실험적). |
| [`group`](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab/group) | 그룹과 멤버 자격을 관리합니다(실험적). |
| [`player-data`](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab/player-data) | 타이틀 또는 퍼블리셔 범위의 플레이어 데이터를 관리합니다. |
| [`economy`](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab/economy) | Economy v2 인벤토리를 관리합니다. |
| [`experiment`](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab/experiment) | 타이틀의 A/B 실험, 스코어카드, 처리 할당 및 제외 그룹을 읽습니다(실험적). |
| [`player`](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab/player) | 플레이어 계정을 조회합니다(실험적). |
| [`privacy`](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab/privacy) | 플레이어의 데이터를 내보내고, 플레이어가 플레이한 타이틀을 나열합니다(실험적). |
| [`service-principal`](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab/service-principal) | 스튜디오와 해당 타이틀에 대한 Microsoft Entra ID 서비스 주체의 액세스 권한을 부여, 검사 및 취소합니다(실험적). |

## 옵션

모든 `playfab` 명령은 [전역 옵션](https://docs.xbox.com/ko/tools/xbox-cli/commands.md#global-options) 외에 다음 옵션을 허용합니다.

| 옵션 | 설명 |
| - | - |
| `--data-only` | PlayFab `{code,status,data}` 응답 봉투를 제거하고 `data` 필드만 씁니다. |
| `--confirm`, `--yes`, `-y` | `Delete*` 또는 `Shutdown*` PlayFab API 작업을 확인합니다. 대화형 터미널 밖에서는 필수입니다. [안전 및 파괴적 작업](https://docs.xbox.com/ko/tools/xbox-cli/safety.md)을 참조하세요. |

## 응답 봉투

기본적으로 명령은 PlayFab의 전체 응답 봉투를 씁니다.

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

`data` 페이로드만 쓰려면 `--data-only`를 추가하고, 한 줄 JSON을 원하면 `--output json-compact`를
추가하세요.

```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/ko/tools/xbox-cli/commands/playfab/file.md#output)을
참조하세요.


## Related topics

- [C# PlayFab SDK](https://docs.xbox.com/ko/services/playfab/sdks/c-sharp/index.md)
- [PlayFab 지원](https://docs.xbox.com/ko/services/playfab/pricing/support.md)
- [PlayFab 개념](https://docs.xbox.com/ko/services/playfab/get-started/concepts.md)
- [Multiplayer with PlayFab](https://docs.xbox.com/ko/services/playfab/multiplayer/mpintro.md)
- [PlayFab Party](https://docs.xbox.com/ko/build/console-features/networking/game-mesh/playfab-party-intro-networking.md)
