Pular para o conteúdo principal

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. 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 para obter mais informações.

Neste artigo


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.
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. 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 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.
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 para obter mais detalhes.
Confira também Contas de teste 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.
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.

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 ou 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)

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 para ver um processo de diagnóstico guiado e uma referência de códigos de erro.

Confira também

Última modificação em 20 de outubro de 2026