> ## 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 샌드박스가 개발 및 테스트를 위해 콘텐츠를 격리하는 방법을 알아봅니다. 샌드박스에서 제품을 만들고 MSA를 통해 액세스를 제어하는 방법을 다룹니다.

XBOX 게임은 샌드박스에서 만듭니다. 이 접근 방식을 \_콘텐츠 격리(content isolation)\_라고 합니다. 샌드박스에서 제품을 만들면 선택한 사용자만 액세스할 수 있는 격리된 환경에서 테스트할 수 있습니다. 액세스는 샌드박스에 로그인할 수 있는 권한이 있는 Microsoft 계정(MSA)으로 제한됩니다.

샌드박스는 XBOX 게임 개발에 필수적입니다. Microsoft Store 경험과 함께 멀티플레이어 및 도전 과제 같은 XBOX 서비스를 테스트할 수 있는 환경을 제공합니다. 게임 설치 경험을 테스트하고 **Store listings**, **Properties**, **Gaming metadata**를 포함한 스토어 제품 세부 정보 페이지(PDP)를 검토할 수 있습니다.

일부 제품 유형은 자동으로 샌드박스를 지원합니다. 게임 번들과 같은 다른 제품 유형의 경우 제품을 만들 때 **Create this product in a sandbox**를 선택하세요.

다음과 같은 경우 제품을 샌드박스에서 만들어야 합니다.

* XBOX 서비스를 사용하는 경우
* 별도의 Microsoft Store 등록 정보를 갖는 추가 기능인 경우
* 부모 제품이 샌드박스에 있는 추가 기능인 경우
* XBOX 서비스를 사용하는 제품을 포함하는 번들인 경우
* 하나 이상의 XVC 패키지를 포함하는 경우

## 브랜치와 샌드박스의 차이점

브랜치와 샌드박스는 개발 및 게시 중에 함께 자주 사용되는 별개의 개념입니다. Partner Center에서 지원되는 각 모듈에는 자체 브랜치가 있습니다. **Main** 브랜치가 기본 브랜치입니다. 제품을 만들 때 모든 모듈에 대해 자동으로 표시됩니다. **Packages**, **Store listings**, **Pricing and availability** 등 지원되는 각 모듈에서 추가 브랜치를 만들 수 있습니다. 각 브랜치는 해당 모듈에 고유합니다. 예를 들면 다음과 같습니다.

* **Packages**의 Test 브랜치는 **Store listings**의 **Test** 브랜치와 독립적입니다.
* 한 모듈의 브랜치에서 변경한 내용은 다른 모듈에 자동으로 반영되지 않습니다.

브랜치를 사용하여 다양한 샌드박스에서 사용할 서로 다른 설정을 구성하고 테스트하세요. 예를 들어 게시된 구성을 덮어쓰지 않고 가격 변경을 테스트하려면 **Pricing and availability**에서 **New pricing**이라는 새 브랜치를 만들고 **Main** 브랜치에서 현재 설정을 가져온 다음 새 브랜치에서 원하는 변경을 하세요. 게시할 준비가 되면 변경 내용을 **Main** 브랜치로 가져올 수 있습니다.

자세한 내용은 [브랜치](/publishing/game-publishing/concepts/branches)를 참조하세요.

## 샌드박스 유형

샌드박스에는 **글로벌**과 **개발** 두 가지 유형이 있습니다.

* 글로벌 샌드박스에는 플레이어가 게임과 서비스에 액세스하는 **RETAIL**과 인증 테스트에 사용되는 다른 샌드박스가 포함됩니다.
* 개발 샌드박스는 Partner Center 계정에 특정한 것입니다. 이러한 샌드박스를 사용하여 제품을 개발하고 테스트할 수 있습니다.

### 격리형(Isolated) 및 공유형(Shared) 개발 샌드박스

개발 샌드박스는 **격리형(Isolated)** 또는 \*\*공유형(Shared)\*\*으로 구성할 수 있습니다.

* **공유형(Shared)** 샌드박스는 계정 내 모든 제품에서 사용할 수 있습니다.
* **격리형(Isolated)** 샌드박스는 지정한 제품만 사용할 수 있습니다.

샌드박스를 격리형으로 구성하는 경우 해당 샌드박스에 게시할 수 있는 제품을 선택해야 합니다. 추가 기능은 부모 제품의 권한을 상속합니다. 제품 목록을 업데이트하려면 **Sandboxes** 페이지에서 샌드박스를 선택한 다음 이어지는 페이지에서 **Manage approved products**를 선택하세요. 샌드박스 유형은 언제든지 **Isolated**와 **Shared** 간에 변경할 수 있습니다.

## 샌드박스 식별자

각 Partner Center 계정은 100개의 개발 샌드박스에 액세스할 수 있습니다. 각 개발 샌드박스에는 두 부분으로 구성된 고유 식별자가 있습니다. 하나는 Partner Center 계정에 고유한 접두사(예: ABCDEF)이고, 다른 하나는 0에서 99 사이의 숫자 값입니다. 이 두 부분이 합쳐져 샌드박스 ID(예: **ABCDEF.1**)를 이룹니다.

글로벌 샌드박스는 숫자 값 없이 이름이 지정됩니다(예: **RETAIL**).

일반적으로 다음과 같이 구성합니다.

* 개발용 샌드박스 하나 이상(예: 각 개발 팀당 샌드박스).
* QA용 샌드박스 하나 이상(예: 내부 QA 팀용 샌드박스와 함께 작업하는 각 외부 QA 팀용 샌드박스).
* 인증에 제출할 릴리스 후보를 준비하고 테스트하는 위치로 사용할 인증 스테이징 샌드박스 하나.

이러한 구조는 팀이 민첩성을 유지하고 제품의 담당 영역에 집중할 수 있게 해줍니다.

## 개발 샌드박스 만들기 및 관리

샌드박스에서 새 게임을 만들 때 **Game setup** 페이지에서 기본 개발 샌드박스를 선택합니다. 생성된 샌드박스가 없는 경우 **Manage sandboxes**를 선택하여 **Sandboxes** 페이지로 이동하고 첫 번째 개발 샌드박스를 만드세요. 필요에 따라 **Sandboxes** 페이지로 돌아가 새 개발 샌드박스를 만들 수 있습니다. 이 페이지는 **Apps and games** 대시보드와 제품 설정 페이지에서 액세스할 수 있습니다.

자세한 내용은 [개발 샌드박스를 만들고 관리하는 방법](/publishing/game-publishing/how-to/how-to-create-and-manage-sandboxes)을 참조하세요.

## 테스트 계정 만들기 및 관리

해당 샌드박스에 게시된 제품이나 XBOX 서비스에 액세스하려면 먼저 승인된 MSA를 사용하여 샌드박스에 로그인해야 합니다. **RETAIL**과 같은 글로벌 샌드박스는 표준 MSA를 사용합니다. 개발 샌드박스는 Partner Center에서 만드는 XBOX 테스트 계정을 사용합니다. 각 테스트 계정이 액세스할 수 있는 샌드박스를 제어할 수 있습니다. 테스트 계정을 만들고 구성하려면 **Apps and games** 대시보드로 이동한 다음 **XBOX test accounts**를 선택하세요. 여기에서 다음 작업을 할 수 있습니다.

* 테스트 계정 배치 생성.
* 테스트 계정 배치의 속성(계정 유형 및 샌드박스 액세스 등) 확인 및 수정.
* 배치의 각 테스트 계정에 대한 이메일, 게이머태그, XUID, 권한 등 테스트 계정 배치 세부 정보 확인.
* 테스트 계정 배치 삭제.

자세한 내용은 [XBOX 테스트 계정을 만들고 관리하는 방법](/publishing/game-publishing/how-to/how-to-create-and-manage-test-accounts)을 참조하세요.

## 샌드박스에 제품 게시

제품을 확인하거나 테스트하려면 샌드박스에 게시하세요.

### XBOX 서비스 게시

게임의 XBOX 서비스만 게시해야 하는 경우 **Gameplay settings**로 이동하여 **Publish**를 선택한 다음, 설정을 게시할 위치를 선택하세요.

### 제품 게시

제품을 게시하려면 **Review and publish** 옵션을 사용합니다. 제품의 **Overview** 페이지에서 액세스할 수 있습니다. **Review and publish** 페이지에서 **Publish to** 드롭다운에서 대상 위치를 선택하세요. **RETAIL**을 선택하는 경우 제품의 **Main** 브랜치에서만 게시할 수 있습니다. 개발 샌드박스를 선택하는 경우 **Publish from**을 선택합니다. 제품이 이미 이 샌드박스에 게시된 경우 **RETAIL**을 선택할 수 있으며, 또는 **Custom**을 선택할 수 있습니다. **Custom**을 선택하면 각 제품 모듈에 대해 원하는 구성을 가진 브랜치를 선택할 수 있습니다.

**Publish**를 선택한 후 **Overview** 페이지에 표시되는 정보를 확인하여 게시 상태를 모니터링합니다. 이전 게시 세부 정보를 검토하려면 **History**를 선택할 수 있습니다.

<Note>
  게시할 수 있는 유일한 글로벌 샌드박스는 RETAIL입니다. 인증에 업데이트를 제출하려면 **Certify** 워크플로를 사용하세요.
</Note>

## 샌드박스에서 제품 테스트

샌드박스에 게시한 후 승인된 계정으로 샌드박스에 로그인합니다. XBOX 서비스만 게시한 경우 Game Development Kit(GDK) 도구를 통해 디바이스에 배포된 패키지를 사용하여 서비스에 연결할 수 있습니다. 전체 제품을 게시한 경우 샌드박스 내 Microsoft Store에서의 사용 가능 여부는 **Pricing and availability** 모듈에서 구성한 **Schedule**에 따라 달라집니다. 자세한 내용은 [제품이 Microsoft Store에서 표시되고 구매 가능하도록 구성](/publishing/game-publishing/how-to/how-to-visible-release)을 참조하세요.

제품의 **Pricing and availability** 모듈에서 **Release** 날짜나 **Discoverable in the Microsoft Store** 날짜를 미래로 구성한 경우 Microsoft Store의 검색 기능을 사용하여 찾을 수 없습니다. Partner Center의 제품 **Setup** 페이지에 있는 Store 프로토콜 링크를 사용하여 제품을 찾을 수 있습니다.

<Note>
  제품의 **Pricing and availability** 모듈의 **Visibility** 섹션에서 [비공개 대상 그룹](/publishing/game-publishing/concepts/availability/visibility-audiences)을 구성한 경우, 이는 개발 샌드박스에서의 제품 표시 여부에 영향을 주지 않습니다. **Private audience**는 RETAIL 샌드박스에 게시된 제품에만 적용됩니다.
</Note>

## 사용자의 샌드박스 수준 권한 관리

[Partner Center 계정에 사용자를 추가](https://learn.microsoft.com/windows/apps/publish/partner-center/overview-users-groups-azure-ad-applications)할 때 [사용자 지정 권한을 부여](https://learn.microsoft.com/windows/apps/publish/partner-center/overview-of-roles-and-permissions-for-account-users)할 수 있습니다. **Test accounts** 및 **XBOX devices** 계정 수준 권한에 대해서는 사용자가 이러한 권한을 갖는 특정 샌드박스를 선택할 수 있습니다. 이렇게 하려면 권한을 선택한 다음 **All sandboxes**를 선택하거나 하나 이상의 개별 샌드박스를 선택하세요. **All sandboxes**를 선택하면 기존의 모든 샌드박스와 향후 만들어질 샌드박스에 권한이 부여됩니다. 현재의 모든 샌드박스에는 권한을 부여하지만 향후 샌드박스에는 부여하지 않으려면 **All sandboxes**를 해제한 다음 각 샌드박스를 개별적으로 선택하세요.

## 참고 항목

* [개발 샌드박스를 만들고 관리하는 방법](/publishing/game-publishing/how-to/how-to-create-and-manage-sandboxes)
* [브랜치](/publishing/game-publishing/concepts/branches)
* [검토 및 게시](/publishing/game-publishing/concepts/modular-submission)
* [계정 사용자 관리](https://learn.microsoft.com/windows/apps/publish/partner-center/manage-account-users)


## Related topics

- [샌드박스](/ko/services/xbox-services/fundamentals/sandboxes/index.md)
- [Steamworks에 없는 GDK 기능](/ko/build/steam-porting-guide/gdk-features-not-in-steamworks.md)
- [XBOX services 샌드박스 개요](/ko/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)
- [개발 샌드박스 만들기 및 관리](/ko/publishing/game-publishing/how-to/how-to-create-and-manage-sandboxes.md)
- [로그인 및 샌드박스 오류 문제 해결](/ko/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md)