> ## 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. # Solução de problemas de erros de entrada e de área restrita > Diagnostique erros de entrada e de área restrita do XBOX Live no PC usando o XblPCSandbox, uma lista de verificação prévia, uma referência de códigos de erro e verificações de configuração do Partner Center. 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](#lista-de-verificação-prévia) * [Fluxograma de diagnóstico](#fluxograma-de-diagnóstico) * [Erros de conta e de área restrita](#erros-de-conta-e-de-área-restrita) * [Erros de configuração](#erros-de-configuração) * [Solução de problemas específicos do jogo](#solução-de-problemas-específicos-do-jogo) * [Solução de problemas adicional](#solução-de-problemas-adicional) * [Referência rápida de códigos de erro](#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. > [!NOTE] > > É fundamental já ter a ferramenta XblPCSandbox.exe instalada. > Para obter mais detalhes sobre como obtê-la, consulte a [visão geral das áreas restritas](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md) ### 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:** ```cmd theme={null} 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](https://partner.microsoft.com/en-us/xboxconfig?appid=\[productId)], substituindo o parâmetro \[productId] pelo seu respectivo *Product Id*. **Como corrigir:** ```cmd theme={null} XblPCSandbox ``` Consulte a [visão geral das áreas restritas](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md) 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:** ```cmd theme={null} 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](https://partner.microsoft.com/en-us/xboxconfig?appid=\[productId)], substituindo o parâmetro \[productId] pelo seu respectivo *Product Id*. **Como corrigir:** ```cmd theme={null} XblPCSandbox ``` Consulte a [visão geral das áreas restritas](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md) 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:** 1. Acesse o [Partner Center](https://partner.microsoft.com/dashboard). 2. Selecione **Apps and Games** 3. Selecione **XBOX Test accounts** (ou acesse o [gerenciamento de contas de teste](https://partner.microsoft.com/dashboard/xbox/testaccounts)). 4. 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:** 1. No Partner Center, acesse **XBOX services** > **Test accounts**. 2. Selecione sua conta de teste. 3. 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:** 1. Siga as informações fornecidas para a [Game Repair Tool](https://support.xbox.com/en-MD/help/games-apps/troubleshooting/gaming-services-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: ```cmd theme={null} 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](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/xbox_live_global_c/functions/xblinitialize.md). Encontre-o em **XBOX services** > **XBOX Settings** no Partner Center. > [!TIP] > > Use o **Store Association Wizard** no [MicrosoftGame.config Editor](https://docs.xbox.com/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-Editor.md) 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:** 1. Acesse o [Partner Center](https://partner.microsoft.com/dashboard). 2. Selecione seu produto. 3. Navegue até **XBOX services** > **Gameplay settings**. 4. Selecione a guia da sua área restrita de desenvolvimento. 5. 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. > [!WARNING] > > 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:** 1. Acesse o [Partner Center](https://partner.microsoft.com/dashboard). 2. Selecione seu produto. 3. Navegue até **XBOX services** > **XBOX Settings**. 4. 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:** 1. Marque a caixa de seleção **Windows 10 PC**. 2. Selecione **Save**. 3. Acesse **Gameplay settings** e **publique** suas configurações na área restrita de desenvolvimento. 4. 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](#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](#-1-verifique-se-o-id-da-área-restrita-não-tem-erros-de-digitação) e o [item 2 da lista de verificação](#-2-sua-área-restrita-está-correta) | | 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](#á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:** 1. Execute `XblPCSandbox /get` e compare a saída com o Partner Center. 2. Execute novamente `XblPCSandbox ` 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:** 1. Execute `XblPCSandbox /get` para confirmar em qual área restrita seu PC está definido. 2. No Partner Center, acesse **XBOX services** > **Test accounts** e verifique se sua conta de teste tem acesso a essa área restrita. 3. Se a área restrita não corresponder, mude para a correta: `XblPCSandbox ` ### 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:** 1. Mude para o RETAIL: `XblPCSandbox /retail` (ou `XblPCSandbox RETAIL`) 2. Abra o aplicativo XBOX e deixe-o iniciar completamente. 3. Volte para sua área restrita de desenvolvimento: `XblPCSandbox ` ### 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: 1. Mude para o RETAIL: `XblPCSandbox /retail` (ou `XblPCSandbox RETAIL`) 2. Pesquise "XBOX" na Microsoft Store e instale-o. 3. 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](#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:** 1. No Partner Center, navegue até seu produto > **XBOX services** > **XBOX Settings**. 2. Marque a caixa de seleção **Windows 10 PC**. 3. Selecione **Save**. 4. Acesse **Gameplay settings** e **publique** suas configurações na área restrita de desenvolvimento. 5. Aguarde **30 minutos** e tente entrar novamente. > [!WARNING] > > 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:** 1. Acesse **XBOX services** > **Gameplay settings** no Partner Center. 2. Selecione a guia da sua área restrita de desenvolvimento. 3. Selecione **Publish**. 4. 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](https://docs.xbox.com/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-Editor.md) 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](#-6-seus-ids-correspondem-ao-partner-center). ### SCID incorreto em XblInitialize O SCID **não** fica no `MicrosoftGame.config`; ele é passado como parâmetro para [XblInitialize](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/xbox_live_global_c/functions/xblinitialize.md). 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](#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`](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xuseraddasync) e [AdvancedUserModel](https://docs.xbox.com/pt-BR/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-advancedusermodel.md) 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](https://support.xbox.com/xbox-live-status) > [!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](#lista-de-verificação-prévia); 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`](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xuseraddasync) e [AdvancedUserModel](https://docs.xbox.com/pt-BR/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-advancedusermodel.md) 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](#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. | > [!NOTE] > > 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 bug > > Ou, se fizer diretamente pelo Hub de Feedback, use **Category: Gaming and XBOX** e **Area: Developer Tools** *** ## Confira também * [Visão geral das áreas restritas](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md) * [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) * [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) * [Referência do XblPCSandbox.exe](https://docs.xbox.com/pt-BR/tools/tools-services/live-pc-sandbox-switcher.md) ## Related topics - [Solução de problemas](https://docs.xbox.com/pt-BR/services/xbox-services/develop/troubleshooting/index.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) - [Solução de problemas de desenvolvimento do XStore](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-troubleshooting.md) - [Guia de solução de problemas do MPA](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpa/concepts/live-mpa-troubleshooting.md) - [Solução de problemas de convites e atividades do MPSD](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpsd/concepts/live-multiplayer-invite-troubleshooting.md)