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

# XStore 개발 및 테스트 활성화

> 사용 권한, 라이선싱, 테스트 계정 요구 사항을 포함하여 샌드박스에서 XStore API 개발 및 테스트용으로 XBOX 제품을 설정합니다.

게임은 [XStore API](/reference/system/xstore/xstore_members)를 사용해 게임 및 관련 제품(예: 추가 기능)과 연결된 라이선스와 사용 권한에 대한 작업을 수행합니다. 많은 `XStore` 작업은 Microsoft Store 서비스가 관리하는 게임 정보를 조작합니다.

<Note>
  이 페이지는 이전 버전에서 상당 부분 업데이트되었습니다.
</Note>

2023년 6월부터 대부분의[\*](#exceptions) `XStore` API 테스트는 더 이상 빌드를 라이선스 부여 가능하게 설정하거나(예: contentIdOverride) 각 계정이 게임에 대한 사용 권한을 갖도록 요구하지 않습니다.

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

PC의 개발 샌드박스에서 커머스를 테스트할 때는 Microsoft Store 앱과 XBOX 앱에 로그인된 계정이 동일한지 확인하세요. 샌드박스에 있을 때 Microsoft Store의 항목에 사용되는 자격 증명은 특정 XBOX 계정에 연결됩니다. 이것은 모든 작업이 활성 샌드박스에 게시된 제품과 상호 작용하도록 하는 데 매우 중요합니다. 자세한 내용은 [PC에서 스토어 계정 불일치 시나리오 처리](/publishing/xstore-commerce/xstore-mismatched-accounts)를 참고하세요.

대부분의[\*](#exceptions) `XStore` API를 테스트하려면 게임 config에 Partner Center에서 파생된 적절한 값이 포함되어 있는지 확인합니다.

<a id="exceptions" />

* **[XStoreQueryGameLicenseAsync](/reference/system/xstore/xstore_members) 같은 라이선싱 관련 API는 제대로 작동하려면 완전히 라이선스된 컨텍스트가 필요합니다.** 자세한 내용은 [라이선스 테스트 활성화](/publishing/xstore-commerce/xstore-licensing-setup)를 참고하세요.

## MicrosoftGameConfig에 게임 ID 적용

먼저 [Partner Center](/publishing/xstore-commerce/xstore-initial-configuration)에서 게임과 추가 기능을 게시하세요.

그런 다음 게임의 config 파일에서 값이 구성된 타이틀과 일치하는지 확인합니다.

```xml theme={null}
  <Identity
    Name="41336MicrosoftATG.InGameStoreXS"
    Publisher="CN=A4954634-DF4B-47C7-AB70-D3215D246AF1"
    Version="2023.5.5.0" />
  <StoreId>9NTL0QDWZ4FS</StoreId>
  <MSAAppId>000000004C2690C8</MSAAppId>
  <TitleId>62ab3c24</TitleId>
```

### Identity

Partner Center의 **Game setup > Identity details**에 있습니다.

PC: Partner Center에서 게임에 할당된 것과 엄격하게 일치해야 합니다.

콘솔에는 필수는 아니지만 Partner Center 제출용 패키지가 생성될 때 확인해야 합니다.

`Identity` 노드의 `Name`은 **Package/Identity/Name**과 일치해야 합니다. `Identity` 노드의 `Publisher`는 **Package/Identity/Publisher**와 일치해야 합니다.

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_appidentity.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=f0f690902c8867bbae062a337589d182" alt="Package/Identity/Name과 Publisher가 원으로 표시된 Game setup > Identity details" data-og-width="1124" width="1124" data-og-height="427" height="427" data-path="images/xstore/identitydetails_appidentity.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_appidentity.png?w=280&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=8e2ab6246d7c53aa58e9b5198c4a6357 280w, https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_appidentity.png?w=560&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=73e8f4ac014c15e5ac6a2320c982b4fd 560w, https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_appidentity.png?w=840&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=e8404c21a5aaf6dacb8652172c1664bf 840w, https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_appidentity.png?w=1100&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=7f782bd5e9e6b087580e58f648e56d01 1100w, https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_appidentity.png?w=1650&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=2f539bda98499c8d89efca0d31587749 1650w, https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_appidentity.png?w=2500&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=d2a838a12cb667aa59f82014055d4bb1 2500w" />

### StoreID

**Game setup > Identity details**에서도 확인할 수 있습니다.

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_storeid.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=1902ced5d2643fa8c1de30281ef96723" alt="URL과 페이지에서 StoreId가 원으로 표시된 Game setup > Identity details" data-og-width="1146" width="1146" data-og-height="722" height="722" data-path="images/xstore/identitydetails_storeid.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_storeid.png?w=280&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=e1140c4882103ee1552f75fb24e8d816 280w, https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_storeid.png?w=560&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=6a2b403d4302b0e1ae8cae6e4992cc91 560w, https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_storeid.png?w=840&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=e5eaa6967e59ba7b648a91b25085e111 840w, https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_storeid.png?w=1100&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=b38590d54bdb1bb89501e238dbfc8566 1100w, https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_storeid.png?w=1650&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=05c68d0fb041e551eb789ee21d7030a6 1650w, https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_storeid.png?w=2500&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=a3c17b86117be244a0687746e96b7f33 2500w" />

## 참조 API 문서

* [XStore (API 내용)](/reference/system/xstore/xstore_members)
  * 함수
    * [XStoreQueryGameLicenseAsync](/reference/system/xstore/xstore_members)

## 참고

[커머스 개요](/publishing/xstore-commerce/xstore-commerce-overview)

[Partner Center에서 초기 구성](/publishing/xstore-commerce/xstore-initial-configuration)

[라이선스 테스트 활성화](/publishing/xstore-commerce/xstore-licensing-setup)

[스토어 작업에 맞게 샌드박스 제대로 전환](/publishing/xstore-commerce/xstore-switching-sandbox)

[XStore API 참조](/reference/system/xstore/xstore_members)


## Related topics

- [라이선싱 테스트 활성화](/ko/publishing/xstore-commerce/xstore-licensing-setup.md)
- [XStore 개발 문제 해결](/ko/publishing/xstore-commerce/xstore-troubleshooting.md)
- [게임에 트라이얼 구현](/ko/publishing/xstore-commerce/xstore-trials.md)
- [기본 스토어 작업](/ko/publishing/xstore-commerce/xstore-basic-operations.md)
- [업데이트 확인](/ko/publishing/xstore-commerce/xstore-checking-updates.md)
