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

# 플레이테스트에서 XBOX services 사용

> 전체 XBOX services 및 업적부터 엠바고와 RETAIL 게시까지, 플레이테스트를 위해 게임의 XBOX services 구성을 준비합니다.

플레이테스트는 플레이어가 사용하는 라이브 환경인 RETAIL 샌드박스에서 실행됩니다. 빌드가
XBOX 로그인, 업적, 프레즌스 또는 기타 XBOX services를 사용하는 경우 게임에 전체 XBOX services가 필요하며,
게임의 XBOX services 구성을 RETAIL에 게시해야 합니다. 그러면 테스터는 출시된 게임의 플레이어와
동일한 라이브 XBOX services를 사용합니다.
[XBOX services 및 Playtest](https://docs.xbox.com/publishing/game-publishing/concepts/playtest-preview.md#xbox-services-and-playtest)를 참조하세요.

[플레이테스트를 만들기](https://docs.xbox.com/ko/tools/xbox-cli/first-playtest.md) 전에 다음 단계를 한 번 수행하세요.

1. [전체 XBOX services 받기](#1-get-full-xbox-services).
2. [업적 처리 방법 선택](#2-choose-what-happens-to-achievements).
3. [엠바고 설정](#3-set-the-embargo).
4. [RETAIL에 구성 게시](#4-publish-the-configuration-to-retail).

예에서는 XBOX 타이틀 ID `1234ABCD`와 빌드 테스트에 사용한 구성이 포함된 개발 샌드박스 `XDKS.1`을
사용합니다.

## 1. 전체 XBOX services 받기

새 게임은 XBOX services가 사용하지 않도록 설정된 상태로 시작합니다. 제한된 XBOX services는 개발
샌드박스에서만 작동하며 업적이나 통계를 포함하지 않습니다. 게임 콘셉트가 승인되면
게임의 Store ID를 XBOX 담당자에게 보내고 제품 온보딩을 요청하세요. 그런 다음 Partner Center에 있는
게임의 **Game setup** 페이지에서 **Enable full XBOX services**를 선택합니다.
[XBOX services 사용](https://docs.xbox.com/publishing/game-publishing/concepts/xbox-services.md#enable-xbox-services)을 참조하세요.

그때까지 업적이 포함된 구성은 유효성 검사에 실패합니다.

```text theme={null}
XblLimited products do not support achievements or stats2013/stats2015 configuration.
```

## 2. 업적 처리 방법 선택

RETAIL에 게시된 업적은 영구적입니다. 이름, 설명 및 아트는 계속 변경할 수 있지만,
업적을 제거하거나 잠금 해제 규칙 또는 게이머스코어를 변경할 수는 없습니다. RETAIL에 게시된 통계도
삭제할 수 없습니다. 타이틀 관리형 또는 이벤트 기반인 게임의 업적 시스템은
첫 번째 RETAIL 게시로 고정됩니다. 해당 게시 전에 다음 중 하나를 선택하세요.

| 선택 | 사용 시기 | 방법 |
| - | - | - |
| 최종 업적 게시 | 업적이 최종 확정된 경우. | 평소처럼 게시합니다. 출시되지 않은 게임의 경우 다음 단계의 엠바고가 다른 플레이어에게 업적을 숨깁니다. |
| 유효성 검사 재정의 요청 | 플레이테스트 중에 업적 디자인을 변경해야 하는 경우. | XBOX 담당자에게 개발 기간 유효성 검사 재정의를 요청합니다. 인증을 위해 게임을 제출하기 전에 재정의를 제거하세요. |

PC 또는 XBOX 본체용 게임은 RETAIL에 업적 게시를 건너뛸 수 없습니다. Partner
Center에서 \*\*Publish Achievements to Retail?\*\*에 **No**로 응답하면 다음 오류와 함께 실패합니다.

```text theme={null}
The specified Platform:Windows can be used only when game is configured to Publish Achievements.
```

게시된 모든 업적은 업적 및 게이머스코어에 대한 XBOX 요구 사항을 충족해야 합니다.
[업적](https://docs.xbox.com/publishing/game-publishing/concepts/playtest-preview.md#achievements)을 참조하세요.

## 3. 엠바고 설정

엠바고는 선택한 날짜까지 XBOX 앱과 본체 UI에서 플레이어에게 게임의 업적, 프레즌스 및 기타 XBOX services
데이터를 숨기고, 스크린샷과 동영상 캡처를 차단합니다.
엠바고가 없으면 플레이테스트 외부의 플레이어가 게임의 구성을 볼 수 있습니다.

아직 출시되지 않은 게임에만 엠바고를 설정하세요. 출시된 게임에서는 새 엠바고가 플레이어에게
해당 게임의 XBOX services 데이터를 숨깁니다.

Partner Center에서 **XBOX services** > **XBOX settings**를 열고 **Embargo date**로 이동한 다음,
플레이테스트 종료 이후이면서 게임의 공개 출시 이전인 UTC 날짜와 시간을 설정합니다.
플레이테스트가 출시 이후까지 진행되는 경우 출시 시점에 엠바고를 종료하세요. 테스터가 서로를
멀티플레이어 세션에 초대하는 경우 **Allow Multiplayer Invites in Embargo**를 선택합니다.
[엠바고 날짜 구성](https://docs.xbox.com/publishing/game-publishing/tutorial-xbox-managed/how-to-configure-xbox-services.md#configure-embargo-date)을 참조하세요.

엠바고는 `ALL` 샌드박스에 저장되는 타이틀 전체 설정이며, 모든 샌드박스에 적용됩니다.
확인하려면 `ALL`을 다운로드합니다.

```bash theme={null}
xbox xbl config download --title-id 1234ABCD --sandbox-id ALL --view draft --dest xbox-config-all
```

`productdeveloper.xml`에 엠바고가 포함되어 있습니다.

```xml theme={null}
<XboxLiveEmbargoDate>2027-03-01T17:00:00Z</XboxLiveEmbargoDate>
<EmbargoInvitesEnabled>true</EmbargoInvitesEnabled>
```

엠바고는 타이틀 전체 구성이 게시될 때 적용됩니다. Partner Center에 게시되지 않은 변경 사항이
표시되면 Partner Center에서 게시하거나 `--sandbox-id HIDDEN`으로 게시합니다.

> [!WARNING]
>
> 타이틀 전체 게시는 엠바고뿐만 아니라 보류 중인 모든 타이틀 전체 변경 사항을 게시하며, 해당
> 변경 사항은 RETAIL에도 적용됩니다. 먼저 보류 중인 변경 사항을 검토하세요.

```bash theme={null}
xbox xbl config publish --title-id 1234ABCD --sandbox-id HIDDEN
```

명령은 게시하기 전에 확인을 요청합니다.
[원본 선택](https://docs.xbox.com/ko/tools/xbox-cli/commands/xbl.md#source-selection)을 참조하세요.

게시는 비동기적으로 수행됩니다. RETAIL에 게시하기 전에 `lastPublish`에
타이틀 전체 게시가 성공한 것으로 표시되는지 확인하세요.

```bash theme={null}
xbox xbl config status --title-id 1234ABCD --sandbox-id HIDDEN
```

## 4. RETAIL에 구성 게시

개발 샌드박스의 구성을 RETAIL에 바로 게시합니다. RETAIL에는 CERT에 먼저 게시하거나
인증을 받을 필요가 없습니다.

> [!WARNING]
>
> RETAIL 게시는 완료되는 즉시 플레이어에게 라이브 상태가 되며, 게시된 업적은 제거할 수
> 없습니다. [안전 및 파괴적 작업](https://docs.xbox.com/ko/tools/xbox-cli/safety.md)을 참조하세요.

먼저 유효성을 검사합니다. 유효성 검사는 아무것도 변경하지 않으며, 게시로 추가되는 업적을 나열합니다.

```bash theme={null}
xbox xbl config publish --title-id 1234ABCD \
  --source-sandbox-id XDKS.1 --sandbox-id RETAIL --validate-only
```

유효성 검사에서 `FirstRetailPublishWithoutEffectiveEmbargo` 경고가 표시되면 아직 적용된 엠바고가
없는 것입니다. 타이틀 전체 게시를 포함하여 [3단계](#3-set-the-embargo)를 완료하세요.

`XDKS.1`에서 게시하면 RETAIL에서 이름이 같은 작업 문서와 RETAIL의 전역 타이틀
스토리지 파일이 바뀌며, RETAIL에만 있는 파일은 삭제됩니다.
[샌드박스 간 게시](https://docs.xbox.com/ko/tools/xbox-cli/commands/xbl.md#cross-sandbox-publishing-replaces-global-title-storage-files)를 참조하세요.

유효성 검사에 문제가 없으면 게시합니다. 명령은 게시 내용을 설명하고 먼저 확인을 요청합니다.

```bash theme={null}
xbox xbl config publish --title-id 1234ABCD --source-sandbox-id XDKS.1 --sandbox-id RETAIL
```

게시가 완료될 때까지 `lastPublish`를 확인합니다.

```bash theme={null}
xbox xbl config status --title-id 1234ABCD --sandbox-id RETAIL
```

그런 다음 [플레이테스트를 만들고 게시](https://docs.xbox.com/ko/tools/xbox-cli/first-playtest.md)합니다.


## Related topics

- [첫 번째 플레이테스트](https://docs.xbox.com/ko/tools/xbox-cli/first-playtest.md)
- [XBOX CLI](https://docs.xbox.com/ko/tools/xbox-cli/index.md)
- [Playtest 사용](https://docs.xbox.com/ko/publishing/game-publishing/concepts/playtest-preview.md)
- [XBOX 서비스 구성](https://docs.xbox.com/ko/publishing/game-publishing/concepts/xbox-services.md)
- [제품 변경 및 콘텐츠 업데이트](https://docs.xbox.com/ko/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-post-release-lifecycle.md)
