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

# XR-074 Perda de conectividade com os serviços XBOX e de parceiros

> Como os títulos lidam com a perda de conectividade com os serviços do XBOX e de parceiros, incluindo políticas de repetição, mensagens de erro amigáveis e o sinalizador RequireXboxLive.

Versão 2.0, 11/1/2025

Os títulos devem lidar de forma adequada com erros de conectividade com os serviços XBOX e de parceiros. Os títulos devem respeitar as políticas de repetição definidas pelo XBOX ao tentar repetir uma solicitação ao serviço XBOX após a ocorrência de uma falha. Os títulos devem gerenciar adequadamente as mensagens ao usuário quando os serviços estiverem indisponíveis. Se um serviço de parceiro não estiver disponível, o jogo não deve indicar que há um problema com a rede XBOX. Os títulos não devem falhar nem travar se os serviços de rede estiverem lentos ou disponíveis de forma intermitente.

## Mais informações

Os títulos devem reagir ao desempenho de suas próprias operações de rede e/ou usar as APIs de qualidade de rede **Windows.XBOX.Networking** para determinar as condições atuais da rede. Eles também devem se degradar de forma adequada, transferindo menos dados, escolhendo funções de usuário apropriadas ou usando serviços de nuvem.

### Tratamento de problemas com serviços que não são do XBOX

Os títulos que encontrarem problemas com serviços de parceiros, como tempos limite não transitórios, erros de API de rede ou configuração de serviço ausente que afete a experiência do usuário, devem alertar o usuário sobre o recurso ou serviço específico que está indisponível. Os títulos devem falhar de forma adequada, passando para um estado seguro enquanto o usuário soluciona o problema ou para um estado em que o usuário possa tentar novamente de forma manual.

Um exemplo de mensagem amigável é:

> "Desculpe, o *serviço que não é da Microsoft* não está disponível no momento. Tente novamente mais tarde. Para obter mais informações, entre em contato com *informações de contato do suporte que não é da Microsoft*."

### Tratamento de problemas com os serviços XBOX

Algumas funcionalidades podem ficar indisponíveis se a conectividade com um serviço XBOX for perdida. Nesses casos, os títulos devem usar mensagens claras e amigáveis para comunicar isso aos usuários.

Se um serviço estiver indisponível, os títulos têm permissão para repetir a solicitação, mas só podem fazer isso dentro dos parâmetros permitidos pelo XBOX. Para obter mais informações sobre a resiliência de serviço para títulos de console XBOX, incluindo a lógica obrigatória de repetição e retirada de HTTP, bem como diretrizes de interação do usuário para serviços individuais, consulte [Resiliência a interrupções de serviço para títulos](/pt-BR/services/xbox-services/develop/best-practices/live-best-practices-calling-xbl)

### Exigência de conectividade com o XBOX

Ao desenvolver para consoles XBOX, títulos que exigem conectividade com a Internet — ou com o XBOX, em particular — para a maior parte de suas funcionalidades podem incluir o sinalizador booliano `RequireXboxLive` em seu manifesto AppX. Isso impedirá que o título seja iniciado no console XBOX quando o XBOX estiver indisponível e suspenderá e, em seguida, encerrará o título se a conectividade for perdida.

Para obter informações sobre rede usando o GDK, leia a [seção Rede](/pt-BR/build/console-features/networking/gc-networking-toc).

## Casos de teste de certificação

### 074-01 Desconexão da WAN dos serviços XBOX

**Etapas de teste**

1. Entre em um perfil XBOX.
2. Ao executar as ações a seguir, desconecte a rede WAN. Se você estiver usando um switch/hub Ethernet, desconecte o cabo de uplink do dispositivo de rede. Se o dispositivo estiver conectado via Wi-Fi, desconecte o cabo de uplink da conexão do ponto de acesso sem fio:
   * Criar um novo ponto de salvamento
   * Carregar um ponto de salvamento
   * Atingir um ponto de salvamento automático
   * Enumerar uma lista de jogos salvos
   * Pesquisar e entrar em uma sessão online
   * Tentar criar uma sessão online
   * Exibir um placar de líderes (se aplicável)
   * Jogar offline

**Resultado esperado**<br />Caso o console não consiga acessar os serviços XBOX, o título deve responder com uma mensagem de erro amigável.

**Exemplos de aprovação**

1. O título exibe uma mensagem de erro indicando a perda de conexão de rede com os serviços XBOX.
2. O título não exibe uma mensagem de erro durante a execução de um modo de jogo local que não exige os serviços XBOX.
3. Um título com `RequireXboxLive` no manifesto AppX é suspenso e, em seguida, encerrado quando a conectividade é perdida.

**Exemplos de falha**

1. O usuário não consegue concluir uma sessão de jogo XBOX não online.
2. O título entra em um estado sem resposta ou instável.

### 074-02 Desconexão direta

**Etapas de teste**

1. Inicie o título e entre em um perfil XBOX.
2. Ao executar as ações a seguir no título, remova o cabo de rede do dispositivo ou desligue o WAP ou o roteador sem fio:
   * Criar um novo ponto de salvamento.
   * Carregar um ponto de salvamento.
   * Atingir um ponto de salvamento automático.
   * Enumerar uma lista de jogos salvos.
   * Pesquisar e entrar em uma sessão online.
   * Tentar criar uma sessão online.
   * Exibir um placar de líderes (se aplicável).
   * Jogar offline.

**Resultado esperado**<br />Caso o dispositivo perca a conexão com os serviços XBOX, o título deve responder com uma mensagem de erro amigável.

**Exemplos de aprovação**

1. O título exibe uma mensagem amigável enquanto está no modo de jogo online.
2. O título não interrompe a jogabilidade durante o modo de jogo offline.
3. Um título com `RequireXboxLive` no manifesto AppX é suspenso e, em seguida, encerrado quando a conectividade é perdida.

**Exemplos de falha**

1. Uma mensagem de erro é exibida durante o modo de jogo offline.
2. O título entra em um estado sem resposta ou instável.
3. O usuário consegue exibir menus online ou mídia em buffer depois que a rede fica offline.

### 074-03 Desconexão dos serviços XBOX durante a suspensão

Em consoles de varejo, um jogo será suspenso nas seguintes condições:

* Quando o console entra em Espera Conectada ao ser desligado com o modo de energia definido como Inicialização instantânea.
* Quando o jogo permanece fora de foco por dez minutos. Por exemplo, ao iniciar um aplicativo como Configurações e mantê-lo em foco por dez minutos.

Para os fins deste caso de teste, ambos os métodos devem ser verificados na etapa 3.

**Etapas de teste**

1. Entre em um perfil XBOX com o modo de energia do console definido como Inicialização instantânea.
2. Inicie o jogo e avance para a jogabilidade.
3. Em vários pontos ao longo do jogo, suspenda o jogo.
4. Retome o jogo e verifique se o jogo lida com a desconexão de forma adequada.
5. Repita as etapas 3 e 4 ao longo do jogo.

**Resultado esperado**<br />Caso o console não consiga acessar os serviços XBOX depois de ser suspenso, o título deve ser retomado com êxito, lidar com a situação de forma adequada e responder com uma mensagem de erro amigável quando apropriado.

**Exemplos de aprovação**

1. Durante uma sessão multijogador online do XBOX, o título exibe uma mensagem de erro indicando a perda de conexão de rede com os serviços XBOX.
2. O título não exibe uma mensagem de erro durante a execução de um modo de jogo local que não exige os serviços XBOX.

**Exemplos de falha**

1. O usuário não consegue concluir uma sessão de jogo XBOX não online.
2. O título entra em um estado sem resposta ou instável.
3. O título exibe uma mensagem de erro enganosa ou incorreta após ser retomado.

### 074-04 Reconexão aos serviços XBOX durante a suspensão

Em consoles de varejo, um jogo será suspenso nas seguintes condições:

* Quando o console entra em Espera Conectada ao ser desligado com o modo de energia definido como Inicialização instantânea.
* Quando o jogo permanece fora de foco por dez minutos. Por exemplo, ao iniciar um aplicativo como Configurações e mantê-lo em foco por dez minutos.

Para os fins deste caso de teste, ambos os métodos devem ser verificados na etapa 3.

**Etapas de teste**

1. Entre em um perfil XBOX com o modo de energia do console definido como Inicialização instantânea e verifique se o console está na página inicial.
2. Sem conexão com o XBOX, mas mantendo uma conexão de rede local, inicie o título.
   * Se estiver usando um switch/hub Ethernet, desconecte o cabo de uplink do dispositivo de rede.
   * Se o dispositivo estiver conectado via Wi-Fi, desconecte o cabo de uplink do ponto de acesso sem fio.
3. Em vários pontos ao longo do jogo, suspenda o jogo.
4. Reconecte o cabo de uplink e aguarde até que o console se reconecte aos serviços XBOX.
5. Retome o jogo e verifique se o jogo lida com a reconexão de forma adequada.
6. Repita as etapas 2 a 5 ao longo do jogo.

**Resultado esperado**<br />Caso o console não consiga acessar os serviços XBOX depois de ser suspenso, o título deve ser retomado com êxito, lidar com a situação de forma adequada e responder com uma mensagem de erro amigável quando apropriado.

**Exemplos de aprovação**

1. O usuário consegue retomar o título e concluir uma sessão de jogo XBOX offline sem interrupção.
2. O título permanece estável e não falha.

**Exemplos de falha**

1. O usuário não consegue concluir uma sessão de jogo XBOX não online.
2. O título entra em um estado sem resposta ou instável.
3. O título exibe uma mensagem de erro enganosa ou incorreta após ser retomado.

### 074-07 Perda dinâmica de conectividade

**Ferramentas necessárias:**

* [Documentação da XBOX Multiplayer Analysis Tool (XMAT)](https://github.com/microsoft/xbox-multiplayer-analysis-tool/blob/main/README.md) e a [versão mais recente da XMAT](https://github.com/microsoft/xbox-multiplayer-analysis-tool/releases).

**Configurar a XMAT para bloquear os serviços de parceiros**

Para obter instruções de instalação, configuração de captura e criação de scripts, consulte [Usar a XBOX Multiplayer Analysis Tool para inspecionar e modificar o tráfego de rede](/pt-BR/tools/tools-services/live-xbox-multiplayer-analysis-tool).

1. Inicie a XMAT como administrador e adicione uma captura **Web Proxy** para o dispositivo em teste.
   * Em um console de desenvolvimento XBOX, selecione **Enable XBOX Proxy** e aguarde até que o console seja reiniciado.
   * No Windows, selecione **Start Capture**.
2. Com a XMAT capturando, inicie o título e navegue por todos os menus, conclua uma sessão multijogador, carregue todos os modos de jogo e navegue por todas as áreas do título, incluindo:
   * Menus.
   * Placares de líderes.
   * Servidores (crie um e entre no de outra pessoa).
   * Listas de amigos.
   * Lojas no título.
   * Eventos por tempo limitado.
3. Use o filtro **Host** para identificar os hosts de serviços de parceiros contatados durante a jogabilidade normal. Confirme se os hosts selecionados não pertencem à Microsoft, ao XBOX ou ao PlayFab antes de bloqueá-los.
4. Abra o **Script Editor**, selecione o evento **SSL Connection Request** e crie um script que defina `Params.Continue` como `false` para cada host de serviço de parceiro.
5. Habilite o script e verifique se ele é compilado com êxito. Em seguida, desabilite o script para que os serviços de parceiros permaneçam disponíveis quando o teste começar. Mantenha a captura da XMAT em execução.

**Etapas de teste**

1. Com o script de bloqueio da XMAT desabilitado, entre em um perfil XBOX e inicie o título.
2. Navegue até um recurso do título que use um serviço hospedado por parceiro e confirme se o recurso está disponível.
3. Sem fechar o título, habilite o script de bloqueio da XMAT.
4. Continue pelo título e use todas as áreas aplicáveis, incluindo:
   * Menus
   * Placares de líderes
   * Servidores (crie um e entre no de outra pessoa)
   * Lista de Amigos
   * Loja no título
   * Eventos por tempo limitado
5. Verifique se o título não exibe uma mensagem de erro indicando um problema com a rede XBOX.

**Resultado esperado**<br />O título lida de forma adequada com desconexões de serviços que não são da Microsoft.

**Exemplos de aprovação**

1. O título não trava nem falha após a perda de conectividade com serviços hospedados por parceiros.

**Exemplos de falha**

1. A mensagem exibida sugere problemas com os serviços da Microsoft.
2. Uma mensagem de erro não descritiva é exibida.
3. O título falha, fica instável ou faz com que o console seja reinicializado.

### 074-08 Indisponibilidade antes da inicialização

**Ferramentas necessárias:**

* *xbstress.exe* do GDK/XDK
* [XBOX Multiplayer Analysis Tool (XMAT)](/pt-BR/tools/tools-services/live-xbox-multiplayer-analysis-tool) para Windows.

**Etapas de teste**

1. Em consoles, crie um canal de rede interrompido com *xbstress.exe* para o tráfego que não é da Microsoft usando o comando:

`xbstress set channel=0 network=broken addresses=[semicolon delimited list of addresses]`

2. Inicie a simulação de rede com o comando: `xbstress simulate network=channels`.
3. Se estiver testando no Windows, configure uma captura de proxy da Web da XMAT e habilite um script que bloqueie os hosts de serviços de parceiros aplicáveis antes de iniciar o título.
4. Entre em um perfil XBOX.
5. Inicie o título.
6. Acesse um recurso online que não seja da Microsoft.

**Resultado esperado**<br />Os títulos devem fornecer uma mensagem de erro amigável indicando que há um problema ao acessar o serviço que não é da Microsoft e devem oferecer a oportunidade de tentar a conexão novamente.

**Exemplos de aprovação**

1. O título não trava nem falha após a perda de conectividade com o serviço hospedado por parceiro.

**Exemplos de falha**

1. O erro exibido sugere problemas com o serviço da Microsoft.
2. Uma mensagem de erro não descritiva é exibida.
3. O título falha, fica instável ou faz com que o console seja reinicializado.


## Related topics

- [Requisitos do XBOX para jogos do XBOX](/pt-BR/publishing/certification/xbox-requirements.md)
- [Requisitos XBOX testados na certificação para jogos XBOX](/pt-BR/publishing/certification/console-cert-tested-requirements.md)
- [XR-045 Rede XBOX e privilégios de conta](/pt-BR/publishing/certification/xr/xr-045.md)
- [XR074 Perda de conectividade com os serviços do XBOX e de parceiros](/pt-BR/publishing/certification/fma/xr-074.md)
- [Conteúdo de suporte aos requisitos e políticas do XBOX](/pt-BR/publishing/certification/xr/overview.md)