> ## 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 사용자가 로그아웃되고 스토어 범위가 업데이트되도록 PC에서 Xblpcsandbox.exe를 사용해 Microsoft Store 작업을 위한 샌드박스를 올바르게 전환합니다.

PC에서 다양한 방법으로 샌드박스를 전환할 수 있습니다. 샌드박스가 변경되면 XBOX 서비스 지원 앱에 로그인된 모든 계정을 로그아웃하기 때문에 `Xblpcsandbox.exe`를 사용하세요.

XBOX 서비스 작업의 경우, 새로 전환된 샌드박스에 프로비저닝된 계정으로 로그인하는 것으로 충분하며, 이는 리테일에서 서로 다른 계정으로 로그인하는 것과 유사합니다. 로그인하면 `XUser` 컨텍스트는 현재 샌드박스를 이해합니다.

스토어 작업에는 제품 탐색 및 구매를 샌드박스로 범위 지정하려면 XBOX 서비스 지원 앱에 로그인한 XBOX 사용자가 필요합니다. Microsoft Store 앱에 계정으로 로그인하는 것만으로는 샌드박스 범위가 기본적으로 리테일(또는 이전에 설정된 경우 이전 샌드박스)로 지정됩니다.

<Info />

따라서 샌드박스를 전환한 후 **먼저** XBOX 서비스에 로그인하는 것이 중요합니다.

1. GDK 명령 프롬프트에서: `xblpcsandbox` \<sandbox id>
2. 샌드박스용으로 프로비저닝된 계정으로 XBOX 앱에 로그인
3. 동일한 계정으로 Microsoft Store 앱에 로그인

<Note>
  XBOX 앱은 스토어 계정을 새로 로그인한 계정으로 전환할지를 묻는 대화 상자를 표시할 수 있습니다.
</Note>

샌드박스에서 이 메커니즘에 의존하지 마세요. 항상 Microsoft Store 앱에서 테스트 계정으로 명시적으로 로그인하세요.

스토어 계정은 XBOX 계정과 다른 계정일 수도 있습니다. 자세한 내용은 [PC에서 스토어 계정 불일치 시나리오 처리](/publishing/xstore-commerce/xstore-mismatched-accounts)를 참고하세요.

샌드박스가 관련된 모든 전환 후 다음 단계를 수행합니다.

* 리테일에서 샌드박스로
* 한 샌드박스에서 다른 샌드박스로
* 샌드박스에서 리테일로

계정을 제대로 전환하지 못했을 때 가장 흔한 문제는 XBOX 서비스 로그인 **후에** 스토어 계정이 로그인되지 않아 모든 스토어 작업이 부적절한 결과를 반환하는 것입니다.

<Note>
  개발 샌드박스에서 커머스를 테스트할 때 단일 테스트 계정의 모든 구매가 동일한 샌드박스에서 이루어지는지 확인하세요.
</Note>

테스트 계정을 다른 샌드박스로 전환하고 더 많은 항목을 구매하면 두 샌드박스 모두에서 해당 계정에 대해 예기치 않은 쿼리 결과가 발생합니다. 이 동작은 구매의 라이선스와 정보가 단일 계정에 대해 항목이 처음 구매된 샌드박스에 연결되어 있기 때문에 발생합니다.

## XBOX 앱 최적화

XBOX 앱에는 어떤 샌드박스가 활성 상태인지 보여주는 메뉴 표시기가 있습니다.

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/xboxapp-sandboxindicator.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=08e656f9274149823494ff146edad0ed" alt="XBOX 앱 샌드박스 표시기" width="937" height="545" data-path="images/xstore/xboxapp-sandboxindicator.png" />

표시기는 PC가 개발 샌드박스에 대해 올바르게 구성되고 XBOX 앱에 로그인된 테스트 계정이 해당 샌드박스에 액세스할 수 있을 때 나타납니다.

XBOX 앱을 사용하면 앱이 자동으로 스토어 계정을 조정하려고 시도한다는 추가 이점이 있습니다. 따라서 XBOX 앱 내에서 유지되면 카탈로그, 구매 작업 및 소유권이 동일한 계정과 샌드박스에서 반영됩니다.

## 인게임 스토어 작업(`XStore` API 사용)

게임이 얻는 `XStoreContext`는 스토어 계정의 것으로, Microsoft Store 앱에 명시적으로 로그인한 것이든 XBOX 앱 로그인의 일부로 이루어진 것이든 마찬가지입니다. `XStore` API가 사용하는 계정을 가장 잘 나타내는 지표는 XBOX 앱이 스토어 작업에 사용하는 계정입니다.

## 참고

XBOX Live PC Sandbox Switcher

XBOX services Sandboxes overview

로그인 오류 문제 해결

[XStore 개발 및 테스트 활성화](/publishing/xstore-commerce/xstore-product-testing-setup)


## Related topics

- [라이선싱 테스트 활성화](/ko/publishing/xstore-commerce/xstore-licensing-setup.md)
- [XStore 개발 및 테스트 활성화](/ko/publishing/xstore-commerce/xstore-product-testing-setup.md)
- [Partner Center에서 초기 구성](/ko/publishing/xstore-commerce/xstore-initial-configuration.md)
- [PC의 XStore — DRM, 라이선스 토큰, 샌드박스](/ko/publishing/xstore-commerce/xstore-pc.md)
- [샌드박스](/ko/publishing/game-publishing/concepts/sandboxes.md)
