> ## 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 타이틀 같은 기본값을 이후 명령을 위해 저장하며, 값 세트가 여러 개 필요하면 이름이 지정된 프로필에 저장합니다.

`xbox context`는 판매자, PlayFab 타이틀, XBOX 타이틀, 샌드박스의 기본값을 저장하므로 모든
명령에 이 값을 전달할 필요가 없습니다. 이 페이지에서는 값을 전달하지 않았을 때 명령이 이
값을 어디에서 가져오는지도 설명합니다. 컨텍스트는 로컬입니다. 이 명령은 Partner Center나
PlayFab에서 아무것도 변경하지 않습니다.

## 명령

| 명령 | 설명 |
| - | - |
| `context get` | 저장된 값을 표시합니다. |
| `context set` | 값 하나를 저장합니다. |
| `context unset` | 저장된 값을 제거합니다. |
| `context key list` | 저장할 수 있는 키와 각 키를 사용하는 명령을 나열합니다. 로그인이 필요하지 않습니다. |
| `context profile list` | `default`부터 시작하여 프로필을 나열합니다. |
| `context profile delete` | 이름이 지정된 프로필과 그 프로필에 저장된 모든 값을 삭제합니다. |

## 키

키는 키가 채우는 옵션의 이름입니다.

| 키 | 옵션 | 변수 | 사용하는 명령 |
| - | - | - | - |
| `playfab-title-id` | `--playfab-title-id` | `XBOX_PLAYFAB_TITLE_ID` | [`playfab`](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab) 명령 |
| `sandbox-id` | `--sandbox-id` | `XBOX_SANDBOX_ID` | [`xbl`](https://docs.xbox.com/ko/tools/xbox-cli/commands/xbl) `config status` 및 `config publish` |
| `seller-id` | `--seller-id` | `XBOX_SELLER_ID` | [`audience`](https://docs.xbox.com/ko/tools/xbox-cli/commands/audience), [`game`](https://docs.xbox.com/ko/tools/xbox-cli/commands/game), [`package`](https://docs.xbox.com/ko/tools/xbox-cli/commands/package), [`playtest`](https://docs.xbox.com/ko/tools/xbox-cli/commands/playtest), [`sandbox`](https://docs.xbox.com/ko/tools/xbox-cli/commands/sandbox), [`test-account`](https://docs.xbox.com/ko/tools/xbox-cli/commands/test-account), [`xbl`](https://docs.xbox.com/ko/tools/xbox-cli/commands/xbl) 명령 |
| `title-id` | `--title-id` | `XBOX_TITLE_ID` | [`xbl`](https://docs.xbox.com/ko/tools/xbox-cli/commands/xbl#title-targeting) `config list`, `config status`, `config publish`와 샌드박스 범위의 `config download` 및 `config save` |

그 밖의 옵션은 저장된 값이나 변수를 사용하지 않습니다.

`title-id`는 `1234ABCD`와 같은 16진수 XBOX 타이틀 ID이며, PlayFab 타이틀 ID가 아닙니다.
`xbl` 명령은 이 값을 사용하여 타이틀의 서비스 구성 식별자(SCID)를 찾으며, `--scid`를
전달하면 이 값을 무시합니다. [타이틀 지정](https://docs.xbox.com/ko/tools/xbox-cli/commands/xbl.md#title-targeting)을 참조하세요.

## 명령이 저장된 값을 사용하는 방식

명령이 이러한 옵션 중 하나를 사용하는 경우, 처음 찾은 값을 사용합니다.

1. `--seller-id`와 같은 명령줄의 옵션.
2. `XBOX_SELLER_ID`와 같은 옵션의 `XBOX_` 변수. 비어 있는 변수는 설정되지 않은 것으로 간주합니다.
3. 선택한 [프로필](#profiles)에 `context set`으로 저장된 값.

```bash theme={null}
xbox context set playfab-title-id ABC123
xbox playfab title-data get                                # uses ABC123
XBOX_PLAYFAB_TITLE_ID=DEF456 xbox playfab title-data get   # uses DEF456
xbox --playfab-title-id GHI789 playfab title-data get      # uses GHI789
```

변수나 저장된 컨텍스트의 값은 직접 입력한 값과 마찬가지로 검사되며, 오류에는
`XBOX_SELLER_ID: --seller-id must be a positive numeric value.`처럼 값의 출처가 표시됩니다.
명령에 필요한 값을 제공하는 곳이 없으면 값을 설정하는 방법을 알려 줍니다. 판매자가 선택
사항인 명령인 `xbl`과 `test-account`는 권한이 있는 유일한 판매자를 사용합니다.

무언가를 변경하는 명령은 `--confirm`을 사용하더라도 채운 각 값과 그 출처를 stderr에
씁니다. `--verbose`를 사용하면 모든 명령이 그렇게 합니다.

```text theme={null}
Using --playfab-title-id ABC123 from saved context.
```

[알려진 문제](https://docs.xbox.com/ko/tools/xbox-cli/known-issues.md)에서는 `game` 및 `sandbox` 명령이 이 방식으로
선택된 판매자와 다른 판매자를 사용하게 되는 두 가지 문제를 설명합니다.

## 프로필

프로필은 테스트 타이틀용과 프로덕션용처럼 이름이 지정된 저장된 값의 세트입니다. 명령은
`--profile`이 지정한 프로필을 사용하고, 없으면 `XBOX_PROFILE`이 지정한 프로필을, 그것도
없으면 `default`를 사용합니다.

```bash theme={null}
xbox --profile test context set playfab-title-id TEST1   # creates "test"
xbox --profile test playfab title-data get               # uses TEST1
xbox playfab title-data get                              # uses the default profile
```

셸의 모든 명령에 프로필을 사용하려면 `XBOX_PROFILE`을 설정하세요.

```bash theme={null}
export XBOX_PROFILE=test
```

프로필을 나열하려면 다음을 실행합니다.

```bash theme={null}
xbox context profile list
```

프로필과 그 프로필에 저장된 모든 값을 삭제하려면 다음을 실행합니다.

```bash theme={null}
xbox context profile delete test
```

* 프로필에 첫 번째 값을 저장하면 프로필이 생성됩니다. 이름은 문자, 숫자, 하이픈으로 최대
  64자까지 사용할 수 있으며 대/소문자를 구분하지 않습니다.

* 철자가 틀린 프로필처럼 존재하지 않는 프로필은 `default`로 대체되지 않고 실패합니다.

* 프로필은 `default`의 값을 가져오지 않습니다.

* `XBOX_` 변수는 여전히 프로필보다 우선합니다. 변수가 `--profile`이 지정한 프로필보다
  우선하면, 명령은 아무것도 변경하지 않더라도 이를 알려 줍니다.

  ```text theme={null}
  Using --playfab-title-id PROD1 from XBOX_PLAYFAB_TITLE_ID, not profile test.
  ```

* CLI는 명령 간에 프로필을 기억하지 않으므로, 프로필을 선택해도 다른 터미널이나 에이전트가
  사용하는 프로필은 바뀌지 않습니다.

## 값이 저장되는 위치

저장된 값은 CLI 상태 디렉터리의 `context.json`에 있습니다.

| OS | 디렉터리 |
| - | - |
| Windows | `%LOCALAPPDATA%\XboxDevCLI` |
| macOS | `~/Library/Application Support/XboxDevCLI` |
| Linux | `$XDG_DATA_HOME/XboxDevCLI`, 기본값은 `~/.local/share/XboxDevCLI` |

각 값은 값을 저장한 계정에 속하므로 다른 계정은 이 값을 사용하지 않습니다.
`auth logout`은 저장된 값을 유지하며, 같은 계정으로 다시 로그인하면 값이 복원됩니다.

## 인수 및 옵션

| 인수 또는 옵션 | 명령 | 설명 |
| - | - | - |
| `<key> <value>` | `set` | 저장할 키와 그 값입니다. 값은 키의 옵션에 유효해야 합니다. `seller-id`는 양수이고([`xbox seller list`](https://docs.xbox.com/ko/tools/xbox-cli/commands/seller) 참조), `playfab-title-id`는 문자와 숫자입니다. |
| `<key>...` | `unset` | 제거할 키입니다. 저장되지 않은 키를 제거해도 성공합니다. |
| `<name>` | `profile delete` | 삭제할 프로필입니다. `default`는 삭제할 수 없습니다. |
| `--profile <name>` | 모두 | `XBOX_PROFILE`의 프로필이나 `default` 대신 이 프로필을 사용합니다. [전역 옵션](https://docs.xbox.com/ko/tools/xbox-cli/commands.md)입니다. |
| `--all` | `unset` | 선택한 프로필에 저장된 모든 값을 제거합니다. 키 이름과 함께 사용할 수 없습니다. |
| `--base-url <url>` | `get`, `set`, `unset` | `XboxPartner:BaseUrl` 설정을 재정의합니다. 저장된 판매자 값은 저장할 때 사용한 엔드포인트에 속합니다. |
| `--output <format>` | 모두 | `json`(기본값), `json-compact` 또는 `table`. |

## 동작

`get`은 로그인한 `account`, `profile`, 그리고 `key`와 `value`로 이루어진 `values` 배열을
반환하며, 저장되지 않은 키의 값은 `null`입니다. 이 명령은 명령이 사용할 값이 아니라 저장된
값을 보여 줍니다. 명령이 사용할 값을 보려면 해당 명령을 `--verbose`로 실행하세요. 로그아웃한
상태에서는 `get`이 값을 표시하지 않고 로그인 방법을 알려 줍니다.

`set`, `unset`, `profile` 명령에는 로그인한 계정이 필요합니다. `set`은 서비스로 값을
확인하지 않으므로, 사용할 수 없는 판매자는 그 값을 보내는 첫 번째 명령에서 실패합니다.

서비스 주체에는 저장된 컨텍스트가 없습니다. 서비스 주체 모드에서는 로그인하는 명령이
`--profile`과 `XBOX_PROFILE`을 거부하고, `key list`를 제외한 모든 `context` 명령이
실패합니다. 대신 각 값을 해당 옵션이나 `XBOX_` 변수로 전달하세요.
[자동화(서비스 주체) 인증](https://docs.xbox.com/ko/tools/xbox-cli/authentication.md#automation-service-principal-authentication)을 참조하세요.

## 명령줄에서 오지 않는 값

저장된 컨텍스트는 OS 사용자가 실행하는 모든 터미널과 에이전트에서 공유되며, 환경 변수는
명령줄에 나타나지 않습니다. 따라서 채운 각 값을 알려 주는 것 외에도 다음과 같이 동작합니다.

* 대상이 컨텍스트 값 자체인 작업은 그 값이 명령줄에 있어야 합니다.
  `/Admin/DeleteTitle`은 타이틀을 삭제하고, `playfab api-policy set --overwrite`는 타이틀의
  전체 API 액세스 정책을 대체하므로, 둘 다 저장된 컨텍스트나 변수에서 온 타이틀을 거부하고
  대신 실행할 명령을 출력합니다.

  ```text theme={null}
  $ xbox playfab api /Admin/DeleteTitle --confirm
  Using --playfab-title-id ABC123 from saved context.
  '/Admin/DeleteTitle' acts on playfab-title-id ABC123, which comes from saved context.
  The target of a destructive operation must be named on the command line. To proceed, run:
    xbox --playfab-title-id ABC123 playfab api /Admin/DeleteTitle --confirm
  ```

  요청 본문에는 비밀이 포함될 수 있으므로, 출력된 명령에서는 인라인 `--body` 또는
  `--statements` 값이 빠집니다. `<body>` 또는 `<statements>` 자리에 값을 다시 넣으세요.

* 저장된 값을 사용하는 명령이 실행되는 동안(예: 확인을 기다리는 동안) 다른 계정이 로그인하면,
  명령은 아무것도 보내기 전에 중지됩니다. 다시 실행하세요.

확인 규칙은 [안전 및 파괴적 작업](https://docs.xbox.com/ko/tools/xbox-cli/safety.md)을 참조하세요.

## 테이블 출력

모든 context 명령은 `--output table`을 허용합니다.

| 명령 | 열 |
| - | - |
| `context get`, `set`, `unset` | `KEY`, `VALUE` |
| `context key list` | `KEY`, `USED BY` |
| `context profile list`, `profile delete` | `NAME` |

## 예제

저장할 수 있는 키를 나열합니다.

```bash theme={null}
xbox context key list --output table
```

판매자와 PlayFab 타이틀을 저장하고 저장된 내용을 확인합니다.

```bash theme={null}
xbox context set seller-id 1234567
xbox context set playfab-title-id ABC123
xbox context get --output table
```

저장된 값을 사용하는 명령을 실행하고, 타이틀이 어디에서 왔는지 확인합니다.

```bash theme={null}
xbox game list
xbox --verbose playfab title-data get
```

저장된 값 하나를 제거합니다.

```bash theme={null}
xbox context unset playfab-title-id
```

선택한 프로필에 저장된 모든 값을 제거합니다.

```bash theme={null}
xbox context unset --all
```

컨텍스트가 변경하지 않는 설정은 [구성](https://docs.xbox.com/ko/tools/xbox-cli/configuration.md)을 참조하세요.


## Related topics

- [라이선싱 테스트 활성화](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-licensing-setup.md)
- [제작 게임 - 컨텍스트](https://docs.xbox.com/ko/services/playfab/economy-monetization/economy-v2/tutorials/craftingGame/game-context.md)
- [SHAPE_CONTEXTS](https://docs.xbox.com/ko/reference/audio/acphal/structs/shape_contexts.md)
- [ACP_COMMAND_ENABLE_OR_DISABLE_XMA_CONTEXTS](https://docs.xbox.com/ko/reference/audio/acphal/structs/acp_command_enable_or_disable_xma_contexts.md)
- [SHARED_SHAPE_CONTEXTS](https://docs.xbox.com/ko/reference/audio/acphal/structs/shared_shape_contexts.md)
