> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XBOX services 샌드박스 개요

> XBOX Live 서비스 구성을 개발 샌드박스에 게시하고, sandbox ID, 테스트 계정 및 PC 및 XBOX 콘솔에서 샌드박스를 전환하는 방법을 알아봅니다.

## XBOX services 개발을 위한 샌드박스 설정

게임에서 XBOX services를 사용하기 전에 [Partner Center](https://partner.microsoft.com/dashboard)에서 타이틀에 대한 정보를 온라인으로 구성해야 합니다. 이 정보에는 타이틀에서 표시하려는 리더보드, 플레이어가 잠금 해제할 수 있는 도전 과제, 매치메이킹 구성 등이 포함됩니다.

서비스 구성을 변경할 때는 XBOX services에서 해당 변경 사항을 반영하기 전에 Partner Center에서 게시해야 합니다. 라이브 버전에 영향을 주지 않고 타이틀 작업을 할 수 있는 격리된 환경인 *개발 샌드박스*에 게시합니다.

기본적으로 XBOX One(또는 이후) 콘솔과 Windows 10(및 이후) PC는 **RETAIL** 샌드박스에 있습니다.

자세한 내용은 [고급 XBOX services 샌드박스](/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes)도 참조하세요.

## 이 문서의 내용

* [샌드박스의 이점](#benefits-of-sandboxes)
* [Sandbox ID](#sandbox-ids)
* [어떤 데이터가 샌드박스화되나요?](#what-data-is-sandboxed)
* [테스트 계정](#test-accounts)
* [여러 샌드박스 사용](#using-multiple-sandboxes)
* [PC에서 샌드박스 설정](#set-up-your-sandbox-on-pc)
* [콘솔에서 샌드박스 설정](#set-up-your-sandbox-on-console)

***

## 샌드박스의 이점

개발 샌드박스는 여러 가지 이점을 제공합니다:

* **안전한 반복.** 현재 사용 가능한 버전에 영향을 주지 않고 타이틀의 서비스 구성을 변경할 수 있습니다.
* **도구 액세스.** 보안상의 이유로 일부 도구는 개발 샌드박스에서만 작동합니다.
* **구성 분기.** 팀의 개발자는 서로 영향을 주지 않고 별도의 샌드박스에서 서비스 구성 변경 사항을 테스트할 수 있습니다.
* **개인 정보 보호.** 다른 게시자는 샌드박스에 대한 액세스 권한을 부여받지 않으면 여러분이 무슨 작업을 하고 있는지 볼 수 없습니다.

## Sandbox ID

각 샌드박스에는 고유한 **대소문자 구분** 식별자가 있습니다. 개발 샌드박스는 퍼블리셔 별칭을 기반으로 하는 명명 규칙을 따릅니다(예: `XDKS.1` 또는 `XLDP.5`).

이를 Sandbox ID라고 하며 경우에 따라 Sandbox Name이라고도 합니다.

<Info>Sandbox ID는 **대소문자를 구분**합니다. `XDKS.1`은 `xdks.1` 또는 `Xdks.1`과 동일하지 않습니다. 그러나 **XblPCSandbox.exe** 도구는 PC에서 샌드박스를 전환할 때 대소문자를 자동으로 수정합니다. 모든 sandbox ID는 대문자입니다. 확정된 sandbox ID는 항상 Partner Center를 참조하세요.</Info>

## 어떤 데이터가 샌드박스화되나요?

모든 XBOX services 데이터가 샌드박스의 영향을 받지는 않습니다. **샌드박스화된** 데이터는 샌드박스별로 격리됩니다. 즉, 생성된 샌드박스 내에서만 존재하며 다른 샌드박스에서는 볼 수 없습니다. **샌드박스화되지 않은** 데이터는 RETAIL을 포함한 모든 샌드박스 간에 전역적으로 공유됩니다.

| 기능                          | 샌드박스화됨? |
| --------------------------- | ------- |
| 도전 과제, 리더보드 및 통계            | 예       |
| 서비스 구성(도전 과제, 리더보드, 세션 템플릿) | 예       |
| 소셜 정보(친구, 팔로워)              | 아니요     |

**주요 영향:**

* 한 샌드박스에서 획득한 도전 과제는 다른 샌드박스로 이월되지 않습니다.
* 서로 다른 샌드박스의 사용자는 서로 매칭하거나 함께 멀티플레이어 게임을 할 수 없습니다.
* 한 샌드박스에 게시된 서비스 구성은 다른 샌드박스에서 볼 수 없습니다.

## 테스트 계정

개인 XBOX 계정 대신 개발 및 테스트에 사용할 [테스트 계정](/services/xbox-services/develop/test-accounts/live-test-accounts)을 만들 수 있습니다.

이것이 샌드박스로 작업할 때 권장되는 옵션입니다.

테스트 계정:

* 개발 샌드박스에만 로그인할 수 있습니다(RETAIL 아님).
* 특정 샌드박스에 대한 액세스 권한을 부여받을 수 있습니다.
* Partner Center에서 확인 및 관리할 수 있는 **만료 날짜**를 가질 수 있습니다.
* 소셜 상호 작용 또는 멀티플레이어와 같은 시나리오를 테스트할 수 있는 **자녀 계정**을 가질 수 있습니다.

<Tip>테스트 계정으로 로그인하는 데 문제가 있는 경우 자세한 내용은 [로그인 및 샌드박스 오류 문제 해결](/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes) 섹션을 참조하세요.</Tip>

자세한 내용은 [테스트 계정](/services/xbox-services/develop/test-accounts/live-test-accounts)도 참조하세요.

## 여러 샌드박스 사용

여러 샌드박스는 보다 고급 시나리오에 유용합니다:

* **서비스 구성 격리.** 활성 개발용 *Development* 샌드박스와 QA 팀용 *Testing* 샌드박스를 사용합니다. *Development*에 게시하는 변경 사항은 테스터가 보는 내용에 영향을 미치지 않습니다.
* **멀티플레이어 격리.** 개발자와 테스터를 별도의 샌드박스에 두어 매치메이킹이 테스트 중에 두 그룹을 섞지 않도록 합니다.

<Note>**XBOX Creators Program**에 있는 경우 샌드박스를 하나만 가질 수 있습니다. 여러 샌드박스를 만들려면 **Managed Partners Program**에 있어야 합니다.</Note>

샌드박스 격리, 제품 인스턴스 및 다중 조직 시나리오에 대한 자세한 내용은 [고급 XBOX services 샌드박스](/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes)를 참조하세요.

## 샌드박스가 워크플로에 어떻게 맞는지

다음은 샌드박스를 사용할 때의 일반적인 워크플로입니다:

1. **디바이스를 전환**하여 개발 샌드박스로 이동합니다. 구성하려는 환경에 따라 아래의 [PC](#set-up-your-sandbox-on-pc) 또는 [Console](#set-up-your-sandbox-on-console) 지침을 참조하세요.
2. 서비스 구성을 반복하면서 **변경 사항을 개발 샌드박스에 게시**합니다.
3. 동일한 샌드박스에서 작업해야 하는 팀 구성원과 **액세스를 공유**합니다.
4. 소매 환경에서 테스트하거나 시스템 앱을 업데이트하거나 다른 게임을 플레이해야 할 때 **RETAIL로 다시 전환**합니다.

***

## PC에서 샌드박스 설정

### XblPCSandbox.exe를 사용하여 샌드박스 전환(권장)

**XblPCSandbox.exe**는 GDK에 포함된 명령줄 도구입니다. PC에서 샌드박스를 전환하는 권장 방법입니다.

XblPCSandbox.exe 및 해당 인수 사용 방법에 대한 자세한 내용은 [XBOX Live PC Sandbox Switcher (XblPCSandbox.exe)](/tools/tools-services/live-pc-sandbox-switcher)를 참조하세요.

***

## 콘솔에서 샌드박스 설정

이 섹션에서는 XBOX One(또는 이후) 콘솔을 개발 샌드박스로 전환하여 XBOX services로 게임을 테스트하는 방법을 설명합니다.

### XBOX Device Portal 사용

XBOX Device Portal을 사용하여 콘솔의 샌드박스를 변경할 수 있습니다. 이렇게 하려면 콘솔에서 "Dev Home"으로 이동하여 활성화합니다.

그런 다음 PC의 웹 브라우저에 IP 주소를 입력하여 콘솔에 연결할 수 있습니다. 그런 다음 **XBOX Live**를 선택하고 그곳의 텍스트 상자에 샌드박스를 입력할 수 있습니다.

### XBOX Manager 사용

XBOX Manager는 XBOX One 이상의 콘솔용입니다.

XBOX Manager를 사용하면 PC에서 콘솔의 특정 측면을 관리할 수 있습니다. 여기에는 재부팅, 설치된 앱 관리 및 샌드박스 변경이 포함됩니다.

샌드박스를 변경하려는 콘솔을 마우스 오른쪽 버튼으로 클릭하고 \*\*Settings...\*\*로 이동합니다.

그런 다음 그곳에 샌드박스를 입력할 수 있습니다.

### XBOX 콘솔 UI 사용

XBOX One(또는 이후) 콘솔에서 바로 개발 샌드박스를 변경하려면 **Settings**로 이동합니다. 그런 다음 **Developer Settings**로 이동하면 샌드박스를 변경할 수 있는 옵션이 표시됩니다.

***

## 다음 단계

샌드박스 전환 중에 문제가 발생한 경우 안내된 진단 프로세스 및 오류 코드 참조는 [로그인 및 샌드박스 오류 문제 해결](/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes)로 진행하세요.

## 참고 항목

* [고급 샌드박스 개념 개요](/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes)
* [테스트 계정](/services/xbox-services/develop/test-accounts/live-test-accounts)
* [로그인 및 샌드박스 오류 문제 해결](/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes)
* [XblPCSandbox.exe 참조](/tools/tools-services/live-pc-sandbox-switcher)
* [XBOX services 구성 개요](/services/xbox-services/fundamentals/portal-config/live-portal-config-overview)
* [MicrosoftGame.config 개요](/build/core-features/common/game-config/MicrosoftGameConfig-Overview)


## Related topics

- [샌드박스](/ko/services/xbox-services/fundamentals/sandboxes/index.md)
- [로그인 및 샌드박스 오류 문제 해결](/ko/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md)
- [PC 샌드박스 전환기 (XblPCSandbox.exe)](/ko/tools/tools-services/live-pc-sandbox-switcher.md)
- [XBOX 서비스 구성 요약 페이지](/ko/services/xbox-services/fundamentals/portal-config/live-portal-summary-tab.md)
- [계정 인증 및 접근 개요](/ko/services/xbox-services/fundamentals/identity/auth/live-authentication-overview.md)