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

# Solução de problemas de entrada nos serviços do XBOX

> Diagnostique falhas comuns de entrada nos serviços do XBOX, incluindo incompatibilidades de área restrita, acesso de contas de teste e problemas de publicação da configuração de serviço durante o desenvolvimento.

Há vários problemas comuns que podem dificultar a entrada.

## Problemas de área restrita

Você deve se familiarizar com o conceito de áreas restritas e com a forma como elas se relacionam com os serviços do XBOX.
Consulte a [visão geral das áreas restritas dos serviços do XBOX](/pt-BR/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox).

As áreas restritas impõem o isolamento de conteúdo e o controle de acesso antes do lançamento no varejo.
Os usuários sem acesso à sua área restrita de desenvolvimento não podem executar nenhuma operação de leitura ou gravação relacionada ao seu título.
Você também pode publicar variações da configuração de serviço em diferentes áreas restritas para testes.

Os pontos de atenção relacionados às áreas restritas são discutidos abaixo.

#### A conta de desenvolvedor não tem acesso à área restrita correta para acesso em tempo de execução

Para entrar em um título que está em desenvolvimento, é preciso usar uma conta de teste (também conhecida como *conta de desenvolvimento*) ou uma conta de desenvolvedor autorizada.

* Verifique se você está tentando entrar com uma ou outra.
* As contas de teste são criadas no Partner Center.
* Você pode autorizar uma conta de desenvolvedor associada aos serviços do XBOX no Partner Center em [https://partner.microsoft.com/xboxconfig/TestAccounts/](https://partner.microsoft.com/xboxconfig/TestAccounts/).
* Verifique se a conta tem acesso à área restrita em que seu título está publicado.
* As contas de teste que você cria no Partner Center herdam as permissões da conta do Partner Center que as criou.

### Seu dispositivo não está na área restrita correta

O dispositivo em que você está desenvolvendo precisa estar definido para uma área restrita de desenvolvimento.
No XBOX One (ou posterior), defina sua área restrita usando o *XBOX One Manager*.

Para o Windows 10 Desktop, use o script `SwitchSandbox.cmd` localizado no diretório `Tools` da instalação do XBOX SDK.

### A configuração de serviço do seu título não está publicada na área restrita de desenvolvimento correta

Verifique se a configuração de serviço do seu título está publicada em uma área restrita de desenvolvimento.

Não é possível entrar na rede XBOX (também conhecida como XBOX Live) em uma determinada área restrita de desenvolvimento para um título, a menos que esse título esteja publicado na mesma área restrita.

Para publicar o título na mesma área restrita, consulte a seção [IDs de área restrita](/pt-BR/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes#ids-de-área-restrita) no artigo "Configurando áreas restritas".

Para publicar sua configuração do Partner Center em uma área restrita, acesse a página de configuração dos serviços do XBOX no Partner Center e selecione o botão **Test**.

## IDs configurados incorretamente

Há vários IDs necessários para configurar seu jogo.

Alguns pontos de atenção são:

* Verifique se o App ID foi inserido corretamente no Partner Center.
* Verifique se o PFN foi inserido corretamente no Partner Center.
* Verifique se a "Package Identity" no seu appxmanifest está correta. Ela é mostrada no Partner Center como "Package/Identity/Name" na seção App Identity.

## Title ID ou SCID configurado incorretamente

Para títulos do XDK e do GDK, esses valores são definidos no seu `package.appxmanifest`.

## Depuração com base no código de erro

Veja a seguir alguns dos códigos de erro que você pode encontrar ao entrar e as etapas que pode seguir para depurar esses erros.
Os códigos de erro aparecem da seguinte forma:

<img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/sign_in_error.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=168ef508b3147a49336dd21791e1c20c" alt="0x8015DC12 Sign-In Error Screenshot" width="648" height="628" data-path="images/gdk/services/sign_in_error.png" />

### 0x80860003 O aplicativo está desabilitado ou configurado incorretamente

1. Tente excluir seu arquivo PFX.

   <img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pfx_file.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=b790352df1c50e0dbdce6bb7f4e75f01" alt="pfx file in Solution Explorer" width="534" height="561" data-path="images/gdk/services/pfx_file.png" />

   Se você não entrou no Visual Studio com a conta Microsoft usada para provisionar o aplicativo no Partner Center, o Visual Studio gerará automaticamente um arquivo pfx de assinatura com base na sua conta Microsoft pessoal ou na sua conta de domínio.
   Ao criar o pacote appx, o Visual Studio usará esse pfx gerado automaticamente para assinar o pacote e alterará a parte "publisher" da identidade do pacote no `package.appxmanifest`.
   Como resultado, os bits produzidos (especificamente, o `appxmanifest.xml`) terão uma identidade de pacote diferente daquela que você pretende usar.

2. Verifique se o seu `package.appxmanifest` está definido com a mesma identidade de aplicativo do seu título no Partner Center.
   Você pode clicar com o botão direito do mouse no projeto e escolher **Store** -> **Associate App With Store...**, conforme mostrado na captura de tela abaixo, ou editar manualmente o `package.appxmanifest`.

   <img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/appxmanifest_binding.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=376612e98a1f724b54de5b1344a7dd5a" alt="Associate with store" width="851" height="852" data-path="images/gdk/services/appxmanifest_binding.png" />

### 0x8015DC12 Erro de isolamento de conteúdo

Esse erro significa que o dispositivo ou o usuário não tem acesso ao título especificado.

1. Isso pode significar que você não está usando uma conta de teste para tentar entrar ou que sua conta de teste não tem acesso à mesma área restrita em que você está conectado.
   Verifique as instruções sobre a criação de contas de teste em [Contas de teste dos serviços do XBOX](/pt-BR/services/xbox-services/develop/test-accounts/live-test-accounts).
   Se necessário, crie uma nova conta de teste com acesso à área restrita apropriada.

   Talvez seja necessário remover sua conta antiga do Windows 10; você pode fazer isso acessando Configurações no menu Iniciar e, em seguida, Contas.

2. Verifique se o seu título está publicado na área restrita que você está tentando usar.
   Consulte a seção [IDs de área restrita](/pt-BR/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes#ids-de-área-restrita) em Configurando áreas restritas.

### 0x87DD000E Título não autorizado

Verifique se o seu dispositivo está definido para a área restrita de desenvolvimento correta e se o usuário tem acesso a ela.

Verifique a configuração de vinculação e do App ID no Partner Center, conforme descrito acima.

Se você estiver recebendo um erro não descrito aqui, consulte a lista de erros na documentação de `xbox::services::xbox_live_error_code` para obter mais informações sobre os códigos de erro.
Você também pode consultar `errors.h` nos arquivos de inclusão da XSAPI.

Se não conseguir entrar com o seu título, publique um tópico de suporte nos [fóruns](https://forums.xboxlive.com) ou entre em contato com seu gerente de conta.


## Related topics

- [Entrada do usuário](/pt-BR/services/xbox-services/fundamentals/identity/auth/live-authentication-nav.md)
- [Autenticação](/pt-BR/services/xbox-services/fundamentals/identity/auth/index.md)
- [Solução de problemas de entrada e de área restrita](/pt-BR/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md)
- [Guia de solução de problemas de convites e atividades do MPSD](/pt-BR/services/xbox-services/multiplayer/mpsd/concepts/live-multiplayer-invite-troubleshooting.md)
- [Guia de solução de problemas de convites e atividades do MPA](/pt-BR/services/xbox-services/multiplayer/mpa/concepts/live-mpa-troubleshooting.md)
