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

# 게임

> 판매자의 Partner Center 게임을 나열하고, 게임 하나를 조회하고, 게임을 생성하고, 생성 작업을 확인합니다.

`game` 명령은 판매자의 Partner Center 게임을 나열하고, Store ID, XBOX 타이틀 ID 또는 이름으로 게임을
조회하고, 게임을 생성하고, 생성 작업을 확인합니다.

각 명령은 `--seller-id` 또는 저장된 판매자에서 가져온 판매자 하나에 대해 작동합니다.
[컨텍스트](https://docs.xbox.com/ko/tools/xbox-cli/commands/context.md)를 참조하세요. 여러 판매자에 속해 있다면
[이 알려진 문제](https://docs.xbox.com/ko/tools/xbox-cli/known-issues.md#xbox-game-commands-ignore---seller-id)를 참조하세요. 이러한
명령이 다른 판매자를 사용할 수 있습니다.

## 명령

| 명령 | 설명 |
| - | - |
| `game list` | 판매자의 모든 게임을 나열합니다. |
| `game get` | Store ID, XBOX 타이틀 ID 또는 이름 키워드로 게임을 가져옵니다. |
| `game create` | 게임을 생성한 다음 생성 작업을 기다립니다. |
| `game job get` | 게임 생성 작업의 현재 상태를 읽습니다. |

## 인수

| 인수 | 명령 | 설명 |
| - | - | - |
| `[title-id]` | `get` | XBOX 타이틀 ID입니다. 1\~8자리 16진수이며 선택적으로 `0x` 접두사를 붙일 수 있습니다(예: `1234ABCD`). `42`는 `0x00000042`를 의미합니다. |
| `<job-id>` | `job get` | `game create`가 출력하는 생성 작업 ID입니다. |

## 옵션

| 옵션 | 명령 | 설명 |
| - | - | - |
| `--seller-id <id>` | 모두 | Partner Center 판매자 ID입니다. |
| `--base-url <url>` | 모두 | 요청의 기본 URL이며, `XboxPartner:BaseUrl` 구성 키를 재정의합니다. |
| `--store-id <id>` | `get` | 게임의 Microsoft Store ID이며, 예를 들면 `9N0000000000`입니다. `title-id`와 함께 사용하여 결과 범위를 좁힐 수 있습니다. |
| `--keyword <text>` | `get` | 이름에 이 텍스트가 포함된 게임을 찾으며, 대/소문자를 무시합니다. `title-id` 또는 `--store-id`와 함께 사용할 수 없습니다. |
| `-d`, `--details` | `list`, `get` | 게임마다 텍스트 블록 하나를 표시합니다. `--output`과 함께 사용할 수 없습니다. |
| `--name <name>` | `create` | 필수. 게임의 이름입니다. |
| `--supported-device <device>` | `create` | 필수. `xbox` 또는 `desktop`이며, 둘 다 지정하려면 옵션을 반복합니다. |
| `--sandbox-id <id>` | `create` | 게임의 개발 샌드박스입니다. 기존 공유 샌드박스여야 합니다. [`sandbox get`](https://docs.xbox.com/ko/tools/xbox-cli/commands/sandbox)은 샌드박스의 유형을 표시합니다. |
| `--confirm`, `--yes`, `-y` | `create` | 확인 프롬프트 없이 게임을 생성합니다. |
| `--output <format>` | 모두 | `json`(기본값) 또는 `json-compact`이며, `table`은 `list`와 `get`에서만 사용할 수 있습니다. |

`game get`에는 `title-id`, `--store-id`, `--keyword` 중 하나 이상이 필요합니다. 위치 값은 항상 XBOX 타이틀
ID이며, 값이 Store ID처럼 보이면 오류에 `--store-id`를 사용하는 같은 명령이 제안됩니다.

```text theme={null}
title-id must be one to eight hexadecimal digits, with an optional 0x prefix. 9N0000000000 looks like a Store ID. Did you mean:
  xbox game get --store-id 9N0000000000 --seller-id 1234567
```

## 나열 및 조회

```bash theme={null}
xbox game list --output table
xbox game get --store-id 9N0000000000
xbox game get 1234ABCD --details
xbox game get --keyword "nod arena" --output table
```

`game list`는 판매자의 전체 카탈로그를 반환하며, `--keyword`를 사용한 `game get`은 전체 카탈로그를
검색합니다. 카탈로그가 크면 읽는 데 몇 분이 걸릴 수 있으며, 명령은 stderr에
[진행률](https://docs.xbox.com/ko/tools/xbox-cli/commands.md#progress)을 표시합니다. 페이징 옵션은 없으므로 `less` 또는 `more`로
출력을 페이지 단위로 보세요. 요청이 실패하면 명령은 부분 결과를 출력하지 않고 상관 관계 ID를 stderr에
씁니다. 각 요청은 2분 후에 시간 초과됩니다. 이를 변경하려면 `XboxPartner:TimeoutSeconds`를 설정하세요
([구성](https://docs.xbox.com/ko/tools/xbox-cli/configuration.md) 참조).

## 출력

JSON 출력은 `games` 배열 하나입니다. 각 게임에는 다음 필드가 있습니다.

| 필드 | 설명 |
| - | - |
| `productId` | Partner Center 제품 ID입니다. |
| `storeId` | Microsoft Store ID입니다. |
| `xboxTitleId` | XBOX 타이틀 ID입니다. `0x` 없이 대문자 16진수 8자리이며, 예를 들면 `"1234ABCD"`입니다. 게임에 유효한 타이틀 ID가 없으면 `null`입니다. |
| `SCID` | 서비스 구성 식별자(SCID)이며, 예를 들면 `"00000000-0000-0000-0000-00001234ABCD"`입니다. 키는 대문자입니다. `xboxTitleId`가 `null`이면 `null`입니다. |
| `name` | 게임의 이름입니다. |
| `primaryDevelopmentSandbox` | 게임의 개발 샌드박스 또는 `null`. |
| `deviceFamilies` | 지원되는 디바이스이며, 예를 들면 `["xbox", "desktop"]`입니다. 나열된 디바이스가 없으면 `null` 또는 `[]`입니다. |
| `packageIdentityName`, `packageIdentityPublisher`, `packageFamilyName` | 게임의 패키지 ID입니다. |
| `msaAppId` | Microsoft 계정(MSA) 앱 ID입니다. |

`game create`와 `game job get`은 생성 작업을 씁니다. 같은 필드를 가진 작업의 `game` 필드는 게임이
존재하게 되면 나타납니다.

### 테이블 출력

`list`와 `get`은 `--output table`을 허용하며, XBOX 타이틀 ID마다 한 행과 `TITLE ID`, `STORE IDS`,
`PRODUCT NAME`, `MSA APP ID`, `PACKAGE FAMILY NAME` 열을 표시합니다. 타이틀의 Store ID와 기타 값은 같은
행에 표시되며, 긴 값은 잘립니다. `create`와 `job get`은 `--output table`을 거부합니다.

### 세부 정보 보기

`--details`는 타이틀 ID마다 블록 하나를 출력하며, 그 아래에 모든 게임과 SCID 및 개발 샌드박스를 포함한
모든 식별자를 잘림 없이 표시합니다. 누락된 값은 `-`로 표시됩니다. `--details` 또는 `--output table`을
사용하면 결과 수와 소요 시간이 stderr로 출력됩니다.

## 게임 생성

```bash theme={null}
xbox game create --name "Nod Arena" \
  --supported-device xbox --supported-device desktop \
  --sandbox-id TESTSB.42 --seller-id 1234567 --confirm
```

`game create`는 게임을 생성하기 전에 묻습니다. 터미널이 없으면 `--confirm`이 필요합니다. CLI는 게임을
삭제할 수 없습니다. 여러 판매자에 속해 있다면 먼저
[알려진 문제](https://docs.xbox.com/ko/tools/xbox-cli/known-issues.md#xbox-game-commands-ignore---seller-id)를 확인하세요. 게임이
다른 판매자에 생성될 수 있습니다.

이 명령은 요청을 한 번 보내고, 생성 작업을 최대 2분 동안 기다린 다음, 작업을 stdout에 씁니다. 작업 ID,
상관 관계 ID 및 작업을 확인하는 명령은 stderr로 출력됩니다. 작업보다 대기가 먼저 끝나면 작업은 계속
실행됩니다. `game job get`으로 확인하고, 게임을 다시 생성하지 마세요.

요청이 실패하면 stderr에 게임이 생성되었을 가능성이 있는지가 표시됩니다.

* 요청이 전송되지 않았거나 서비스가 요청을 거부한 경우(예: 게임이 사용할 수 없는 샌드박스에 대한 `400`)
  **게임이 생성되지 않았습니다**. 문제를 해결하고 명령을 다시 실행하세요.
* 서버 오류, 시간 초과 또는 연결 끊김 이후에는 **결과를 알 수 없습니다**. 다시 시도하기 전에 stderr에
  출력된 명령으로 `game list`를 확인하세요.

## 생성 작업 확인

```bash theme={null}
xbox game job get 11111111-2222-3333-4444-555555555555 --output json-compact
```

`job get`은 읽기만 하므로 원하는 만큼 자주 실행할 수 있습니다. 성공한 작업도 `errors` 필드에 문제를
보고할 수 있습니다.

## 종료 코드

| 종료 코드 | 의미 |
| - | - |
| `0` | 작업이 성공했거나 아직 실행 중입니다. `create`는 대기가 끝날 때도 `0`으로 종료되므로, `0`이 게임의 존재를 보장하지는 않습니다. |
| `1` | 명령이 실패했습니다. `create`의 경우 stderr에 게임이 생성되었을 가능성이 있는지가 표시됩니다. |
| `2` | 작업이 게임을 생성하지 않고 끝났습니다. 작업의 `errors` 필드를 참조하세요. |
| `130` | 명령이 읽는 동안 또는 `create`가 요청에 대한 응답을 기다리는 동안 Ctrl+C를 눌렀습니다. `create`의 경우 stderr에 결과를 알 수 없다고 표시됩니다. |

종료 코드로 `create`를 다시 실행할지 결정하지 마세요. stderr에 게임이 생성되지 않았다고 표시되면 오류를
해결하고 다시 실행하세요. 그렇지 않으면 출력된 `game job get` 또는 `game list` 명령으로 확인하세요.

## 엔드투엔드 예제

판매자를 한 번 저장한 다음, 해당 판매자를 사용하는 게임을 생성합니다.

```bash theme={null}
xbox context set seller-id 1234567

xbox game create --name "Nod Arena" \
  --supported-device xbox --supported-device desktop \
  --sandbox-id TESTSB.42 --confirm
```

작업보다 대기가 먼저 끝나면 게임을 다시 생성하는 대신 작업을 확인하세요. `game create`가 stderr에 출력한
작업 ID를 사용합니다.

```bash theme={null}
xbox game job get 11111111-2222-3333-4444-555555555555 --output json-compact
```

작업이 성공하면 게임을 찾습니다.

```bash theme={null}
xbox game get --keyword "Nod Arena" --output table
```


## Related topics

- [게임 설정](https://docs.xbox.com/ko/publishing/game-publishing/concepts/game-setup-overview.md)
- [게임 인증](https://docs.xbox.com/ko/publishing/game-publishing/tutorial-xbox-managed/how-to-certify-a-game.md)
- [게임 저장](https://docs.xbox.com/ko/build/core-features/common/game-save/index.md)
- [게임 개념 제출](https://docs.xbox.com/ko/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-game-concepts.md)
- [게임 바인딩](https://docs.xbox.com/ko/services/xbox-services/fundamentals/game-binding/index.md)
