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

# Visão geral das áreas restritas dos serviços do Xbox

> Publique a configuração de serviço do XBOX Live em uma área restrita de desenvolvimento e conheça os IDs de área restrita, as contas de teste e como alternar áreas restritas no PC e no console XBOX.

## Configurando áreas restritas para o desenvolvimento com os serviços do XBOX

Antes de usar os serviços do XBOX no seu jogo, você precisa configurar online as informações sobre o seu título no [Partner Center](https://partner.microsoft.com/dashboard). Essas informações incluem recursos como os placares que seu título deseja exibir, as conquistas que os jogadores podem desbloquear, a configuração de matchmaking etc.

Ao fazer alterações na sua configuração de serviço, você precisa publicá-las no Partner Center antes que sejam adotadas pelos serviços do XBOX. Você publica em uma *área restrita de desenvolvimento* — um ambiente isolado em que pode trabalhar no seu título sem afetar a versão ao vivo.

Por padrão, os consoles XBOX One (ou posterior) e os PCs com Windows 10 (e posterior) ficam na área restrita **RETAIL**.

Confira também [Áreas restritas avançadas dos serviços do XBOX](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md) para obter mais informações.

## Neste artigo

* [Benefícios das áreas restritas](#benefits-of-sandboxes)
* [IDs de área restrita](#sandbox-ids)
* [Quais dados ficam na área restrita?](#what-data-is-sandboxed)
* [Contas de teste](#test-accounts)
* [Usando várias áreas restritas](#using-multiple-sandboxes)
* [Configurar sua área restrita no PC](#set-up-your-sandbox-on-pc)
* [Configurar sua área restrita no console](#set-up-your-sandbox-on-console)

***

## Benefícios das áreas restritas

As áreas restritas de desenvolvimento oferecem vários benefícios:

* **Iterar com segurança.** Você pode fazer alterações na configuração de serviço do seu título sem afetar a versão disponível no momento.
* **Acesso a ferramentas.** Algumas ferramentas só funcionam em uma área restrita de desenvolvimento, por motivos de segurança.
* **Ramificar sua configuração.** Os desenvolvedores da sua equipe podem testar alterações na configuração de serviço em áreas restritas separadas, sem afetar uns aos outros.
* **Privacidade.** Outros publicadores não podem ver no que você está trabalhando sem receber acesso à sua área restrita.

## IDs de área restrita

Cada área restrita tem um identificador exclusivo que **diferencia maiúsculas de minúsculas**. As áreas restritas de desenvolvimento seguem uma convenção de nomenclatura baseada no moniker do seu publicador (por exemplo, `XDKS.1` ou `XLDP.5`).

Esses identificadores são chamados de Sandbox ID e, em alguns casos, de Sandbox Name.

> [!NOTE]
>
> Os IDs de área restrita **diferenciam maiúsculas de minúsculas**. `XDKS.1` não é o mesmo que `xdks.1` ou `Xdks.1`. No entanto, a ferramenta **XblPCSandbox.exe** corrigirá automaticamente as maiúsculas e minúsculas ao alternar áreas restritas no PC. Todos os IDs de área restrita estão em maiúsculas. Sempre consulte o Partner Center para obter o ID de área restrita definitivo.

## Quais dados ficam na área restrita?

Nem todos os dados dos serviços do XBOX são afetados pelas áreas restritas. Os dados **em área restrita** ficam isolados por área restrita — eles só existem na área restrita em que foram criados e não ficam visíveis em outras áreas restritas. Os dados **fora de área restrita** são compartilhados globalmente entre todas as áreas restritas, incluindo a RETAIL.

| Recurso | Em área restrita? |
| - | - |
| Conquistas, placares e estatísticas | Sim |
| Configuração de serviço (conquistas, placares, modelos de sessão) | Sim |
| Informações sociais (amigos, seguidores) | Não |

**Principais implicações:**

* As conquistas obtidas em uma área restrita não são transferidas para outra área restrita.
* Usuários em áreas restritas diferentes não podem ser colocados na mesma partida nem jogar multiplayer juntos.
* A configuração de serviço publicada em uma área restrita não fica visível em outra.

## Contas de teste

Você pode criar [contas de teste](https://docs.xbox.com/pt-BR/services/xbox-services/develop/test-accounts/live-test-accounts.md) para usar no desenvolvimento e nos testes, em vez da sua conta pessoal do XBOX.

Essa é a opção recomendada para trabalhar com áreas restritas.

Contas de teste:

* Podem entrar **somente** em áreas restritas de desenvolvimento (não na RETAIL).
* Podem receber acesso a áreas restritas específicas.
* Podem ter uma **data de expiração** que você pode verificar e gerenciar no Partner Center.
* Podem ter **contas de criança**, que permitem testar cenários como interações sociais ou multiplayer.

> [!TIP]
>
> Se você estiver com problemas para entrar com uma conta de teste, consulte a seção [Solução de problemas de entrada e de área restrita](https://docs.xbox.com/pt-BR/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md) para obter mais detalhes.

Confira também [Contas de teste](https://docs.xbox.com/pt-BR/services/xbox-services/develop/test-accounts/live-test-accounts.md) para obter mais informações.

## Usando várias áreas restritas

Várias áreas restritas são úteis em cenários mais avançados:

* **Isolamento da configuração de serviço.** Use uma área restrita de *desenvolvimento* para o desenvolvimento ativo e uma área restrita de *testes* para a sua equipe de QA. As alterações que você publicar na de *desenvolvimento* não afetarão o que os testadores veem.
* **Isolamento do multiplayer.** Mantenha os desenvolvedores e os testadores em áreas restritas separadas para que o matchmaking não misture os dois grupos durante os testes.

> [!NOTE]
>
> Se você participa do **XBOX Creators Program**, só pode ter uma área restrita. Para criar várias áreas restritas, você precisa participar do **Managed Partners Program**.

Para obter mais detalhes sobre o isolamento das áreas restritas, as instâncias de produto e os cenários com várias organizações, consulte [Áreas restritas avançadas dos serviços do XBOX](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md).

## Como as áreas restritas se encaixam no seu fluxo de trabalho

Este é o fluxo de trabalho típico ao usar áreas restritas:

1. **Mude seu dispositivo** para a sua área restrita de desenvolvimento. Consulte as instruções para [PC](#set-up-your-sandbox-on-pc) ou [console](#set-up-your-sandbox-on-console) abaixo, dependendo do ambiente que você planeja configurar.
2. **Publique as alterações** na sua área restrita de desenvolvimento à medida que itera na configuração de serviço.
3. **Compartilhe o acesso** com os membros da equipe que precisam trabalhar na mesma área restrita.
4. **Volte para a RETAIL** quando precisar testar no ambiente de varejo, atualizar os aplicativos do sistema ou jogar outros jogos.

***

## Configurar sua área restrita no PC

### Alterne sua área restrita usando o XblPCSandbox.exe (recomendado)

O **XblPCSandbox.exe** é uma ferramenta de linha de comando incluída no GDK. Ela é a maneira recomendada de alternar áreas restritas no PC.

Para obter informações mais detalhadas sobre como usar o XblPCSandbox.exe e seus respectivos argumentos, consulte [XBOX Live PC Sandbox Switcher (XblPCSandbox.exe)](https://docs.xbox.com/pt-BR/tools/tools-services/live-pc-sandbox-switcher.md)

***

## Configurar sua área restrita no console

Esta seção explica como mudar seu console XBOX One (ou posterior) para uma área restrita de desenvolvimento para que você possa testar seu jogo com os serviços do XBOX.

### Usando o XBOX Device Portal

Você pode usar o XBOX Device Portal para alterar a área restrita do seu console. Para isso, acesse o "Dev Home" no console e habilite-o.

Depois disso, você pode digitar o endereço IP no navegador web do seu PC para se conectar ao console. Em seguida, selecione **XBOX Live** e insira a área restrita na caixa de texto.

### Usando o XBOX Manager

O XBOX Manager é para consoles XBOX One ou posteriores.

O XBOX Manager permite administrar determinados aspectos do seu console a partir do PC. Isso inclui reiniciar, gerenciar os aplicativos instalados e alterar a área restrita.

Clique com o botão direito do mouse no console cuja área restrita você deseja alterar e acesse **Settings...**

Em seguida, você pode inserir uma área restrita.

### Usando a interface do console XBOX

Se quiser alterar sua área restrita de desenvolvimento diretamente no console XBOX One (ou posterior), acesse **Configurações**. Em seguida, acesse **Configurações do desenvolvedor**, e você verá uma opção para alterar a área restrita.

***

## Próximas etapas

Se você encontrou algum problema ao alternar áreas restritas, acesse [Solução de problemas de entrada e de área restrita](https://docs.xbox.com/pt-BR/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md) para ver um processo de diagnóstico guiado e uma referência de códigos de erro.

## Confira também

* [Visão geral conceitual das áreas restritas avançadas](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md)
* [Contas de teste](https://docs.xbox.com/pt-BR/services/xbox-services/develop/test-accounts/live-test-accounts.md)
* [Solução de problemas de entrada e de área restrita](https://docs.xbox.com/pt-BR/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md)
* [Referência do XblPCSandbox.exe](https://docs.xbox.com/pt-BR/tools/tools-services/live-pc-sandbox-switcher.md)
* [Visão geral da configuração dos serviços do XBOX](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/portal-config/live-portal-config-overview.md)
* [Visão geral do MicrosoftGame.config](https://docs.xbox.com/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-Overview.md)


## Related topics

- [Áreas restritas](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/sandboxes/live-sandboxes-nav.md)
- [Áreas restritas avançadas dos serviços do XBOX](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md)
- [Página de resumo da configuração dos serviços do XBOX](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/portal-config/live-portal-summary-tab.md)
- [Solução de problemas de entrada nos serviços do XBOX](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/identity/auth/live-troubleshooting-sign-in.md)
- [Visão geral do multijogador dos serviços XBOX](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/overviews/live-multiplayer-intro.md)
