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

# Habilitar o desenvolvimento e os testes da XStore

> Configure seu produto XBOX para desenvolvimento e testes da API XStore em uma área restrita, incluindo os requisitos de direito, licenciamento e conta de teste.

Os jogos usam as [APIs XStore](https://docs.xbox.com/pt-BR/reference/system/xstore/xstore_members.md) para executar operações nas licenças e nos direitos associados ao seu jogo e aos produtos relacionados (por exemplo, complementos). Muitas das operações da `XStore` manipulam informações sobre o seu jogo gerenciadas pelos serviços da Microsoft Store.

> [!NOTE]
>
> Esta página foi substancialmente atualizada em relação às versões anteriores.

Desde junho de 2023, a maioria[\*](#exceptions) dos testes da API `XStore` não exige mais configurar o build para ser licenciável (por exemplo, contentIdOverride) nem que cada conta tenha um direito ao jogo.

Ao testar o comércio em áreas restritas de desenvolvimento, todas as compras em uma única conta de teste devem ser feitas na mesma área restrita. Trocar uma conta de teste para outra área restrita e comprar mais itens gera resultados de consulta inesperados para a conta em ambas as áreas restritas. Isso ocorre porque as licenças e as informações de uma compra estão vinculadas à primeira área restrita em que o item foi comprado para uma única conta.

Ao testar o comércio em áreas restritas de desenvolvimento no PC, verifique se a conta conectada ao aplicativo Microsoft Store e ao aplicativo XBOX é a mesma. Nas áreas restritas, as credenciais usadas para itens na Microsoft Store estão vinculadas especificamente à conta XBOX. Isso é fundamental para garantir que todas as operações interajam com produtos publicados especificamente na área restrita ativa. Consulte [Lidar com cenários de contas da loja incompatíveis no PC](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-mismatched-accounts.md) para obter mais informações.

Para testar a maioria[\*](#exceptions) das APIs `XStore`, verifique se a configuração do jogo contém os valores adequados derivados do Partner Center.

* **APIs relacionadas a licenciamento, como [XStoreQueryGameLicenseAsync](https://docs.xbox.com/pt-BR/reference/system/xstore/xstore_members.md), exigirão um contexto totalmente licenciado para funcionar corretamente.** Consulte [Habilitar testes de licença](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-licensing-setup.md) para obter detalhes completos.

## Aplicar IDs do jogo ao MicrosoftGameConfig

Primeiro, publique seu jogo e complementos no [Partner Center](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-initial-configuration.md).

Em seguida, no arquivo de configuração do jogo, verifique se os valores correspondem ao título configurado:

```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

Localizado no Partner Center em **Configuração do jogo > Detalhes de identidade**.

No PC: é estritamente obrigatório que corresponda ao que está atribuído ao seu jogo no Partner Center.

Embora não seja obrigatório para console, deve ser verificado quando um pacote é criado para envio ao Partner Center.

`Name` no nó `Identity` precisa corresponder a **Package/Identity/Name**; `Publisher` no nó `Identity` precisa corresponder a **Package/Identity/Publisher**.

![Configuração do jogo > Detalhes de identidade com Package/Identity/Name e Publisher circulados](https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_appidentity.png?fit=max\&auto=format\&n=iADzli99B7EWodAv\&q=85\&s=f0f690902c8867bbae062a337589d182)

### StoreID

Também encontrado em **Configuração do jogo > Detalhes de identidade**

![Configuração do jogo > Detalhes de identidade com StoreId circulado na URL e na página](https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_storeid.png?fit=max\&auto=format\&n=iADzli99B7EWodAv\&q=85\&s=1902ced5d2643fa8c1de30281ef96723)

## Documentação de referência da API

* [XStore (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xstore/xstore_members.md)
  * Funções
    * [XStoreQueryGameLicenseAsync](https://docs.xbox.com/pt-BR/reference/system/xstore/xstore_members.md)

## Confira também

[Visão geral de comércio](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-commerce-overview.md)

[Configuração inicial no Partner Center](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-initial-configuration.md)

[Habilitar testes de licença](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-licensing-setup.md)

[Trocar de área restrita corretamente para operações da Store](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-switching-sandbox.md)

[Referência da API XStore](https://docs.xbox.com/pt-BR/reference/system/xstore/xstore_members.md)


## Related topics

- [Habilitar testes de licenciamento](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-licensing-setup.md)
- [Configuração inicial no Partner Center](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-initial-configuration.md)
- [XStoreQueryGameLicenseAsync](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstorequerygamelicenseasync.md)
- [Solução de problemas de desenvolvimento do XStore](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-troubleshooting.md)
- [XStore no PC: DRM, tokens de licença e áreas restritas](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-pc.md)