Solução de problemas de erros de entrada e de área restrita

Este artigo ajuda você a diagnosticar e corrigir erros comuns de entrada e relacionados a áreas restritas do seu jogo em uma área restrita de desenvolvimento no PC.

Neste artigo

Lista de verificação prévia
Fluxograma de diagnóstico
Erros de conta e de área restrita
Erros de configuração
Solução de problemas específicos do jogo
Solução de problemas adicional
Referência rápida de códigos de erro

Lista de verificação prévia

Antes de investigar erros específicos, percorra esta lista de verificação. A maioria dos problemas de entrada é causada pela configuração incorreta de um destes itens. Verifique todos os itens a seguir antes de prosseguir para o fluxograma de diagnóstico e as seções de erros abaixo.

É fundamental já ter a ferramenta XblPCSandbox.exe instalada. Para obter mais detalhes sobre como obtê-la, consulte a visão geral das áreas restritas

Verificações do ambiente

Estes itens afetam sua capacidade de entrar nos serviços do XBOX de modo geral, incluindo o aplicativo XBOX. Verifique-os primeiro.

✅ 1. Verifique se o ID da área restrita não tem erros de digitação

Verifique se o ID da área restrita foi digitado corretamente. Como verificar:

XblPCSandbox /get

Compare a saída com a área restrita mostrada na página Gameplay settings do Partner Center. Você pode fazer isso usando https://partner.microsoft.com/en-us/xboxconfig?appid=[productId], substituindo o parâmetro [productId] pelo seu respectivo Product Id. Como corrigir:

XblPCSandbox <your sandbox ID>

Consulte a visão geral das áreas restritas para obter instruções detalhadas sobre como alternar entre áreas restritas.

✅ 2. Sua área restrita está correta

Seu PC precisa estar na mesma área restrita de desenvolvimento em que a configuração dos serviços do XBOX do seu jogo foi publicada. Como verificar:

XblPCSandbox /get

XblPCSandbox <your sandbox ID>

Consulte a visão geral das áreas restritas para obter instruções detalhadas sobre como alternar entre áreas restritas.

✅ 3. Sua conta de teste é válida

As contas de teste podem se tornar inválidas por vários motivos. Verifique todos os itens a seguir:

O acesso da conta à área restrita não expirou

O acesso das contas de teste às áreas restritas tem uma data de expiração. Contas com acesso expirado à área restrita não conseguem entrar nela. Como verificar:

Acesse o Partner Center.
Selecione Apps and Games
Selecione XBOX Test accounts (ou acesse o gerenciamento de contas de teste).
Encontre sua conta de teste e verifique as colunas Access Expires e Status.

Como corrigir: Se a conta tiver expirado, crie uma nova conta de teste ou estenda a data de expiração da conta existente.

A conta tem acesso à sua área restrita

Ao criar uma conta de teste, você precisa conceder a ela acesso a áreas restritas específicas. Como verificar:

No Partner Center, acesse XBOX services > Test accounts.
Selecione sua conta de teste.
Verifique se sua área restrita de desenvolvimento está listada no acesso a áreas restritas da conta.

Como corrigir: Edite a conta de teste e adicione sua área restrita de desenvolvimento à lista de acesso dela.

As credenciais estão corretas

Verifique se você está usando o endereço de email e a senha corretos da conta de teste. Os endereços de email de contas de teste normalmente terminam em @xboxtest.com.

✅ 4. Os componentes de jogos do XBOX estão atualizados

Os serviços do XBOX dependem do aplicativo XBOX e do componente Gaming Services no seu PC. Uma versão desatualizada de qualquer um deles pode causar falhas inesperadas de entrada. Como verificar:

Siga as informações fornecidas para a Game Repair Tool

✅ 5. Reinicie o PC

Às vezes, um serviço em segundo plano necessário para a entrada (como o XBOX Live Auth Manager ou o Gaming Services) entra em um estado inválido. Reiniciar o PC pode resolver problemas transitórios que as etapas acima não detectam. Antes de fazer isso, é importante enviar um bug pelo Hub de Feedback para que ele possa ser acompanhado e resolvido em uma versão futura. Você pode fazer isso usando o seguinte comando:

XblPCSandbox /feedback

Ou, se fizer diretamente pelo Hub de Feedback, use Category: Gaming and XBOX e Area: Developer Tools Quando fazer isso: Se você verificou todos os itens de ambiente acima e a entrada ainda falha, reinicie o PC e tente novamente antes de passar para as verificações do projeto.

Verificações do projeto

Estes itens afetam especificamente a entrada a partir do seu jogo. Se você consegue entrar no aplicativo XBOX, mas não no seu jogo, comece aqui.

✅ 6. Seus IDs correspondem ao Partner Center

Os IDs no seu MicrosoftGame.config precisam corresponder exatamente aos valores no Partner Center. Um único valor incompatível impedirá a entrada. Como verificar: Abra seu MicrosoftGame.config e compare estes valores com o Partner Center:

Campo do MicrosoftGame.config	Onde encontrá-lo no Partner Center
`StoreId`	Game Setup > Identity details > Show details > Store ID
`Identity/Name`	Game Setup > Identity details > Show details > Package/Identity/Name
`Identity/Publisher`	Game Setup > Identity details > Show details > Package/Identity/Publisher
`TitleId`	XBOX services > XBOX Settings > Title ID (valor hexadecimal, não decimal)
`MSAAppId`	XBOX services > XBOX Settings > MSA App ID (pode ser um GUID ou hexadecimal)

Além disso, verifique o SCID (identificador de configuração de serviço). O SCID não fica no seu MicrosoftGame.config; ele é passado como parâmetro para o método XblInitialize. Encontre-o em XBOX services > XBOX Settings no Partner Center.

Use o Store Association Wizard no MicrosoftGame.config Editor para vincular seu jogo automaticamente e reduzir a chance de erros de digitação.

✅ 7. A configuração dos serviços do XBOX está publicada na sua área restrita

Mesmo depois de salvar as alterações no Partner Center, elas não ficam ativas até que você as publique na sua área restrita de desenvolvimento. Como verificar:

Acesse o Partner Center.
Selecione seu produto.
Navegue até XBOX services > Gameplay settings.
Selecione a guia da sua área restrita de desenvolvimento.
Verifique o status de publicação.

Como corrigir: Se as alterações não tiverem sido publicadas, selecione Publish para enviá-las à sua área restrita de desenvolvimento. Aguarde aproximadamente 30 minutos para que as alterações se propaguem antes de testar novamente.

Clicar em Save na página XBOX Settings não publica as alterações. Você precisa publicá-las explicitamente na página Gameplay settings.

✅ 8. A plataforma PC está habilitada

Se você estiver desenvolvendo no PC, a plataforma Windows 10 PC (e posteriores) precisa estar habilitada para o seu título. Sem isso, a entrada falhará com o erro 0x87dd0005 (AM_E_XAST_UNEXPECTED). Como verificar:

Acesse o Partner Center.
Selecione seu produto.
Navegue até XBOX services > XBOX Settings.
Verifique se a caixa de seleção Windows 10 PC está marcada. Faça isso também para as versões mais recentes do Windows.

Como corrigir:

Marque a caixa de seleção Windows 10 PC.
Selecione Save.
Acesse Gameplay settings e publique suas configurações na área restrita de desenvolvimento.
Aguarde aproximadamente 30 minutos antes de testar.

Fluxograma de diagnóstico

Se a lista de verificação prévia não resolveu o problema, use este processo passo a passo para restringir a causa raiz. Comece na etapa 1 e siga as ramificações.

┌─────────────────────────────────────────────────────────┐
│                  Still can't sign in?                   │
│         Start here after completing the                 │
│              Preflight Checklist                        │
└───────────────────────┬─────────────────────────────────┘
                        │
                        ▼
        ┌───────────────────────────────┐
        │  STEP 1: Can you sign in to   │
        │  the Xbox App with your       │
        │  test account?                │
        └───────┬───────────────┬───────┘
                │               │
            YES ▼           NO  ▼
    ┌───────────────┐   ┌──────────────────────────────────────────────┐
    │  Sandbox and  │   │  Sandbox or account                          │
    │  account are  │   │  issue. Check:                               │
    │  working.     │   │                                              │
    │  Go to Step 2 │   │  • Is the sandbox ID correct?                │
    │               │   │  • Is the account access to sandbox expired? │
    └───────┬───────┘   │  • Does the account have sandbox access?     │
            │           │  • Are the credentials right?                │
            │           │  • Is the Xbox App up to date?               │
            │           │  • Is the Xbox App licensed?                 │
            │           │                                              │
            │           │  See: Account & Sandbox Errors below         │
            │           └──────────────────────────────────────────────┘
            ▼
┌───────────────────────────────┐
│  STEP 2: Can you sign in to   │
│  a sample project with your   │
│  game's IDs?                  │
└───────┬───────────────┬───────┘
        │               │
    YES ▼           NO  ▼
┌───────────────┐   ┌──────────────────────────────┐
│  Config is    │   │  Configuration issue.        │
│  working.     │   │  Check:                      │
│  Go to Step 3 │   │                              │
│               │   │  • Are the IDs correct in    │
└───────┬───────┘   │    MicrosoftGame.config?     │
        │           │  • Are the gameplay settings │
        │           │    published to the sandbox? │
        │           │  • Is the PC Platform        │
        │           │    enabled?                  │
        │           │  • Is the SCID correct in    │
        │           │    XblInitialize?            │
        │           │                              │
        │           │  See: Configuration          │
        │           │  Errors below                │
        │           └──────────────────────────────┘
        ▼
┌───────────────────────────────┐
│  STEP 3: Game-specific issue  │
│  The sample works but your    │
│  game doesn't.                │
│                               │
│  • Compare the MicrosoftGame  │
│    .config files              │
│  • Compare the sign-in code   │
│  • Check the error code in    │
│     reference table below     │
└───────────────────────────────┘

Erros de conta e de área restrita

Se você não conseguiu entrar no aplicativo XBOX (etapa 1 do fluxograma de diagnóstico), o problema está na troca de área restrita, na conta de teste ou no próprio aplicativo XBOX.

O usuário não está nesta área restrita (0x8015DC12)

A conta de teste não tem acesso à área restrita ou a configuração do jogo não corresponde à área restrita. Causas comuns e correções:

Causa	Correção
Os IDs no `MicrosoftGame.config` não correspondem ao Partner Center	Consulte o item 1 da lista de verificação e o item 2 da lista de verificação
A conta de teste não tem acesso à área restrita	Edite a conta de teste no Partner Center e adicione sua área restrita
O acesso da conta de teste à área restrita expirou	Verifique a data de expiração no Partner Center; crie uma nova conta ou estenda-a
Uso de uma área restrita isolada em vez de compartilhada	Verifique o tipo de área restrita no Partner Center; mude para uma área restrita compartilhada, a menos que você tenha um motivo específico para usar uma isolada. Consulte Áreas restritas isoladas vs. compartilhadas.

ID de área restrita incorreto

Os erros comuns incluem:

Caracteres ausentes ou a mais: XDKS1 em vez de XDKS.1
Área restrita errada: alternar para uma área restrita diferente daquela em que a configuração do seu jogo foi publicada

Como corrigir:

Execute XblPCSandbox /get e compare a saída com o Partner Center.
Execute novamente XblPCSandbox <correct sandbox ID> com o valor exato do Partner Center.

Área restrita errada para a conta de teste (erro Garrison)

Se você vir uma mensagem de erro sugerindo que sua conta deveria funcionar em uma área restrita diferente, ou se o serviço de identidade do XBOX retornar um erro inesperado durante a entrada, provavelmente você entrou na área restrita errada para essa conta de teste. Como corrigir:

Execute XblPCSandbox /get para confirmar em qual área restrita seu PC está definido.
No Partner Center, acesse XBOX services > Test accounts e verifique se sua conta de teste tem acesso a essa área restrita.
Se a área restrita não corresponder, mude para a correta: XblPCSandbox <correct sandbox ID>

Erro de licenciamento do aplicativo XBOX (0x803F8001)

O aplicativo XBOX pode não ser iniciado se você não o tiver aberto anteriormente no RETAIL. Como corrigir:

Mude para o RETAIL: XblPCSandbox /retail (ou XblPCSandbox RETAIL)
Abra o aplicativo XBOX e deixe-o iniciar completamente.
Volte para sua área restrita de desenvolvimento: XblPCSandbox <your sandbox ID>

Não é possível encontrar o aplicativo XBOX

O aplicativo XBOX está disponível na Microsoft Store, mas somente quando você está na área restrita RETAIL. Se não conseguir encontrá-lo:

Mude para o RETAIL: XblPCSandbox /retail (ou XblPCSandbox RETAIL)
Pesquise “XBOX” na Microsoft Store e instale-o.
Volte para sua área restrita.

Erros de configuração

Se você consegue entrar no aplicativo XBOX, mas não consegue entrar no seu jogo ou em um projeto de exemplo (etapa 2 do fluxograma de diagnóstico), o problema está na configuração dos serviços do XBOX do seu jogo.

Plataforma PC não habilitada (0x87dd0005, AM_E_XAST_UNEXPECTED)

Esse erro significa que a plataforma Windows 10 PC não foi adicionada no Partner Center. Verifique também as versões posteriores. Como corrigir:

No Partner Center, navegue até seu produto > XBOX services > XBOX Settings.
Marque a caixa de seleção Windows 10 PC.
Selecione Save.
Acesse Gameplay settings e publique suas configurações na área restrita de desenvolvimento.
Aguarde 30 minutos e tente entrar novamente.

Clicar em Save na página XBOX Settings não publica as alterações. Você precisa publicá-las explicitamente na página Gameplay settings para que a entrada funcione.

Configuração dos serviços do XBOX não publicada

As alterações salvas no Partner Center não ficam ativas até serem publicadas na sua área restrita de desenvolvimento. Como corrigir:

Acesse XBOX services > Gameplay settings no Partner Center.
Selecione a guia da sua área restrita de desenvolvimento.
Selecione Publish.
Aguarde aproximadamente 30 minutos para que as alterações se propaguem.

IDs incorretos no MicrosoftGame.config

Uma causa comum de erros de entrada é um ou mais valores incompatíveis no MicrosoftGame.config. Como corrigir: Use o Store Association Wizard no MicrosoftGame.config Editor para vincular seu jogo e preencher automaticamente os valores corretos. Ou verifique manualmente cada valor no Partner Center usando o item 6 da lista de verificação.

SCID incorreto em XblInitialize

O SCID não fica no MicrosoftGame.config; ele é passado como parâmetro para XblInitialize. Verifique se você está passando o SCID correto do Partner Center (XBOX services > XBOX Settings).

Áreas restritas isoladas vs. compartilhadas

A menos que você tenha um motivo específico para usar uma área restrita isolada, use uma área restrita compartilhada. Você pode verificar o tipo da sua área restrita no Partner Center. As áreas restritas isoladas têm restrições adicionais que podem causar falhas de entrada.

Solução de problemas específicos do jogo

Se a entrada no aplicativo XBOX funciona e um projeto de exemplo funciona com os IDs do seu jogo, mas seu jogo ainda não consegue entrar (etapa 3 do fluxograma de diagnóstico), o problema é específico do código ou da configuração do seu jogo.

Compare os arquivos MicrosoftGame.config

Compare o MicrosoftGame.config do seu jogo com o do exemplo que funciona. Procure campos a mais ou ausentes, diferenças de formatação ou valores incorretos.

Compare o código de entrada

Compare a implementação de entrada do seu jogo com o código do exemplo. Procure diferenças em como XUserAddAsync é chamado (opções, callbacks, tratamento de erros).

Nenhum usuário padrão (0x89245106, E_GAMEUSER_NO_DEFAULT_USER)

Esse erro significa que não há nenhum usuário padrão conectado no momento. Causa: você chamou XUserAddAsync com a opção AddDefaultUserSilently, mas nenhum usuário está conectado no momento. Como corrigir: Consulte XUserAddAsync e AdvancedUserModel para obter mais informações.

Solução de problemas adicional

Os serviços do XBOX estão passando por uma interrupção

Se você esgotou todas as outras opções, verifique se os serviços do XBOX estão passando por uma interrupção:

Página de status do XBOX

[!IMPORTANT] Limitação conhecida (GDK 26.04): o XblPCSandbox não consegue alternar áreas restritas quando executado em uma sessão SSH. Execute o XblPCSandbox em uma sessão local.

Referência rápida de códigos de erro

Código de erro	Nome	Causa provável	Correção
`0x8015DC12`	Usuário não está na área restrita	IDs incompatíveis, sem acesso à área restrita, acesso expirado da conta de teste à área restrita ou área restrita isolada	Consulte a lista de verificação; verifique os IDs, o acesso da conta e o tipo de área restrita
`0x87dd0005`	`AM_E_XAST_UNEXPECTED`	Plataforma PC não habilitada no Partner Center	Habilite Windows 10 (e posteriores) PC em XBOX Settings, publique na área restrita e aguarde 30 min
`0x89245106`	`E_GAMEUSER_NO_DEFAULT_USER`	Nenhum usuário padrão conectado; `XUserAddAsync(AddDefaultUserSilently)` foi chamado	Consulte `XUserAddAsync` e AdvancedUserModel para obter mais informações sobre como resolver isso.
`0x803F8001`	Erro de licenciamento	O aplicativo XBOX não foi iniciado anteriormente no RETAIL	Mude para o RETAIL, inicie o aplicativo XBOX e volte para a área restrita de desenvolvimento
`0x80004005`	Falha genérica de entrada	Configuração incorreta da área restrita ou da conta; também pode indicar um problema no serviço	Percorra a lista de verificação prévia; verifique o ID da área restrita, o acesso da conta de teste e a expiração da conta. Se o problema persistir, tente reiniciar o PC e alternar novamente as áreas restritas.

Se você vir um código de erro que não está listado aqui, envie o problema pelo Hub de Feedback.Use xblPcSandbox /feedback para enviar o bugOu, se fizer diretamente pelo Hub de Feedback, use Category: Gaming and XBOX e Area: Developer Tools

Confira também

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

⌘I

XBOX Services

PlayFab

Solução de problemas de erros de entrada e de área restrita

Neste artigo

Lista de verificação prévia

Verificações do ambiente

✅ 1. Verifique se o ID da área restrita não tem erros de digitação

✅ 2. Sua área restrita está correta

✅ 3. Sua conta de teste é válida

O acesso da conta à área restrita não expirou

A conta tem acesso à sua área restrita

As credenciais estão corretas

✅ 4. Os componentes de jogos do XBOX estão atualizados

✅ 5. Reinicie o PC

Verificações do projeto

✅ 6. Seus IDs correspondem ao Partner Center

✅ 7. A configuração dos serviços do XBOX está publicada na sua área restrita

✅ 8. A plataforma PC está habilitada

Fluxograma de diagnóstico

Erros de conta e de área restrita

O usuário não está nesta área restrita (0x8015DC12)

ID de área restrita incorreto

Área restrita errada para a conta de teste (erro Garrison)

Erro de licenciamento do aplicativo XBOX (0x803F8001)

Não é possível encontrar o aplicativo XBOX

Erros de configuração

Plataforma PC não habilitada (0x87dd0005, AM_E_XAST_UNEXPECTED)

Configuração dos serviços do XBOX não publicada

IDs incorretos no MicrosoftGame.config

SCID incorreto em XblInitialize

Áreas restritas isoladas vs. compartilhadas

Solução de problemas específicos do jogo

Compare os arquivos MicrosoftGame.config

Compare o código de entrada

Nenhum usuário padrão (0x89245106, E_GAMEUSER_NO_DEFAULT_USER)

Solução de problemas adicional

Os serviços do XBOX estão passando por uma interrupção

Referência rápida de códigos de erro

Confira também

​Neste artigo

​Lista de verificação prévia

​Verificações do ambiente

​✅ 1. Verifique se o ID da área restrita não tem erros de digitação

​✅ 2. Sua área restrita está correta

​✅ 3. Sua conta de teste é válida

​O acesso da conta à área restrita não expirou

​A conta tem acesso à sua área restrita

​As credenciais estão corretas

​✅ 4. Os componentes de jogos do XBOX estão atualizados

​✅ 5. Reinicie o PC

​Verificações do projeto

​✅ 6. Seus IDs correspondem ao Partner Center

​✅ 7. A configuração dos serviços do XBOX está publicada na sua área restrita

​✅ 8. A plataforma PC está habilitada

​Fluxograma de diagnóstico

​Erros de conta e de área restrita

​O usuário não está nesta área restrita (0x8015DC12)

​ID de área restrita incorreto

​Área restrita errada para a conta de teste (erro Garrison)

​Erro de licenciamento do aplicativo XBOX (0x803F8001)

​Não é possível encontrar o aplicativo XBOX

​Erros de configuração

​Plataforma PC não habilitada (0x87dd0005, AM_E_XAST_UNEXPECTED)

​Configuração dos serviços do XBOX não publicada

​IDs incorretos no MicrosoftGame.config

​SCID incorreto em XblInitialize

​Áreas restritas isoladas vs. compartilhadas

​Solução de problemas específicos do jogo

​Compare os arquivos MicrosoftGame.config

​Compare o código de entrada

​Nenhum usuário padrão (0x89245106, E_GAMEUSER_NO_DEFAULT_USER)

​Solução de problemas adicional

​Os serviços do XBOX estão passando por uma interrupção

​Referência rápida de códigos de erro

​Confira também

Neste artigo

Lista de verificação prévia

Verificações do ambiente

✅ 1. Verifique se o ID da área restrita não tem erros de digitação

✅ 2. Sua área restrita está correta

✅ 3. Sua conta de teste é válida

O acesso da conta à área restrita não expirou

A conta tem acesso à sua área restrita

As credenciais estão corretas

✅ 4. Os componentes de jogos do XBOX estão atualizados

✅ 5. Reinicie o PC

Verificações do projeto

✅ 6. Seus IDs correspondem ao Partner Center

✅ 7. A configuração dos serviços do XBOX está publicada na sua área restrita

✅ 8. A plataforma PC está habilitada

Fluxograma de diagnóstico

Erros de conta e de área restrita

O usuário não está nesta área restrita (0x8015DC12)

ID de área restrita incorreto

Área restrita errada para a conta de teste (erro Garrison)

Erro de licenciamento do aplicativo XBOX (0x803F8001)

Não é possível encontrar o aplicativo XBOX

Erros de configuração

Plataforma PC não habilitada (0x87dd0005, AM_E_XAST_UNEXPECTED)

Configuração dos serviços do XBOX não publicada

IDs incorretos no MicrosoftGame.config

SCID incorreto em XblInitialize

Áreas restritas isoladas vs. compartilhadas

Solução de problemas específicos do jogo

Compare os arquivos MicrosoftGame.config

Compare o código de entrada

Nenhum usuário padrão (0x89245106, E_GAMEUSER_NO_DEFAULT_USER)

Solução de problemas adicional

Os serviços do XBOX estão passando por uma interrupção

Referência rápida de códigos de erro

Confira também