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

# Usar a XBOX Multiplayer Analysis Tool para inspecionar e modificar o tráfego de rede

> Use o XMAT para capturar, inspecionar, analisar e modificar o tráfego de rede de consoles de desenvolvimento XBOX e PCs com Windows.

A [XBOX Multiplayer Analysis Tool (XMAT)](https://github.com/microsoft/xbox-multiplayer-analysis-tool/blob/main/README.md) captura, inspeciona e modifica o tráfego de rede de consoles de desenvolvimento XBOX e PCs com Windows. Baixe a [versão mais recente do XMAT](https://github.com/microsoft/xbox-multiplayer-analysis-tool/releases).

O XMAT pode:

* Fazer proxy de tráfego HTTP e HTTPS.
* Descriptografar e exibir dados de solicitações e respostas.
* Filtrar o tráfego capturado por host, código de status e método.
* Executar scripts C# que modificam ou encerram solicitações e respostas.
* Capturar e analisar o tráfego de rede de baixo nível de um console de desenvolvimento XBOX.
* Analisar capturas ao vivo ou salvas em busca de padrões problemáticos de chamadas aos serviços XBOX.

## Requisitos

O XMAT requer:

* Um PC de desenvolvimento executando o Windows 10, versão 1809 (build 17763) ou posterior, ou o Windows 11.
* Permissões de administrador no PC de desenvolvimento.
* O [.NET 10 Desktop Runtime e o ASP.NET Core Runtime para Windows x64](https://dotnet.microsoft.com/download/dotnet/10.0), ou o .NET 10 SDK para Windows x64.
* Para captura no console, um console de desenvolvimento XBOX executando a recovery 2106 ou posterior.
* GDK Extensions for XBOX para os recursos do XMAT que se conectam a um console de desenvolvimento XBOX.

## Instalar o XMAT

1. Baixe o arquivo ZIP atual em [versões do XMAT](https://github.com/microsoft/xbox-multiplayer-analysis-tool/releases).
2. Extraia o arquivo ZIP para uma pasta local.
3. Execute o XMAT como administrador.
4. Quando solicitado, instale o certificado raiz do XMAT e confie nele. O XMAT usa esse certificado para descriptografar o tráfego HTTPS.

## Capturar tráfego da web

1. No XMAT, selecione a guia **+**.
2. Selecione o dispositivo que executa o título:
   * Para o console de desenvolvimento XBOX padrão, selecione **Default XBOX Console**.
   * Para outro console de desenvolvimento XBOX, selecione **XBOX Console at IP or Hostname**.
   * Para um título no PC de desenvolvimento, selecione **Local PC**.
3. Selecione **Web Proxy** e, em seguida, selecione **Add Capture**.
4. Inicie o proxy:
   * Para um console de desenvolvimento XBOX, selecione **Enable XBOX Proxy**. O console é reiniciado e começa a enviar o tráfego da web pelo XMAT.
   * Para um PC com Windows, selecione **Start Capture**.
5. Inicie o título e execute os cenários que você deseja inspecionar.
6. Selecione uma conexão para inspecionar os cabeçalhos e o corpo da solicitação e da resposta.

Use os filtros **Host**, **Status** e **Method** para isolar o tráfego relevante. Selecione **Save Captures** no menu **File** para salvar a captura como um arquivo XMATCAP.

> [!IMPORTANT]
>
> Se um console de desenvolvimento XBOX permanecer configurado para usar o proxy do XMAT quando o XMAT não estiver capturando, as verificações dos serviços XBOX e outras solicitações de rede podem falhar. Selecione **Disable XBOX Proxy** quando os testes forem concluídos. O console é reiniciado para aplicar a alteração.

## Identificar os hosts de serviços de parceiros

Antes de simular uma interrupção de serviço, capture o tráfego normal do título:

1. Inicie uma captura de proxy da web no XMAT.
2. Inicie o título e execute todos os recursos que usam um serviço online, incluindo:
   * Menus e leaderboards.
   * Criação e entrada em sessões multijogador.
   * Amigos e recursos sociais.
   * Lojas no título.
   * Eventos por tempo limitado.
3. Use o filtro **Host** para revisar todos os hosts com os quais o título se comunica.
4. Compare os hosts capturados com o inventário de serviços do título e identifique os serviços hospedados por parceiros a serem testados.

Não bloqueie hosts de serviços da Microsoft, do XBOX ou do PlayFab ao testar a conectividade de serviços de parceiros. Confirme a propriedade de cada host em vez de se basear apenas em uma substring em seu nome.

## Bloquear um serviço de parceiro

Os scripts do XMAT podem encerrar solicitações para hosts selecionados enquanto mantêm o restante do tráfego disponível.

1. Abra o **Script Editor** na captura de proxy da web ativa.

2. Selecione o evento **SSL Connection Request**.

3. Substitua o host de exemplo por cada host de serviço de parceiro que você deseja bloquear. Por exemplo:

   ```csharp theme={null}
   string host = Params.Request.Host.ToLowerInvariant();

   if (host == "api.publisher.example" ||
       host.EndsWith(".api.publisher.example"))
   {
       Params.Continue = false;
   }
   ```

4. Selecione **Enable**. Verifique se o script é compilado com êxito.

5. Execute o recurso afetado do título e verifique se as solicitações para os hosts selecionados falham enquanto os serviços da Microsoft, do XBOX e do PlayFab permanecem disponíveis.

O evento **SSL Connection Request** bloqueia conexões HTTPS. Se o serviço do parceiro usar HTTP não criptografado, aplique a mesma condição de host ao evento **Web Request** e defina `Params.Continue` como `false`.

Para simular um serviço que fica indisponível antes de o título iniciar, ative o script de bloqueio antes de iniciar o título.

> [!CAUTION]
>
> Os scripts do XMAT afetam o tráfego ao vivo do dispositivo selecionado. Limite um script de bloqueio aos hosts de parceiros específicos necessários para o teste e desative o script quando o teste for concluído.

## Parar a captura

1. Desative todos os scripts ativos.
2. Selecione **Stop Capture**.
3. Se um console de desenvolvimento XBOX estiver usando o proxy, selecione **Disable XBOX Proxy** e aguarde a reinicialização do console.

Para problemas conhecidos e opções de suporte, veja a [documentação do projeto XMAT](https://github.com/microsoft/xbox-multiplayer-analysis-tool/blob/main/README.md#known-issues) e a [política de suporte do XMAT](https://github.com/microsoft/xbox-multiplayer-analysis-tool/blob/main/SUPPORT.md).


## Related topics

- [Depuração de pilhas HTTP personalizadas](https://docs.xbox.com/pt-BR/build/console-features/networking/web-requests/debugging-custom-http-stacks.md)
- [Requisitos XBOX testados na certificação para jogos XBOX](https://docs.xbox.com/pt-BR/publishing/certification/console-cert-tested-requirements.md)
- [XR-074 Perda de conectividade com os serviços XBOX e de parceiros](https://docs.xbox.com/pt-BR/publishing/certification/xr/xr-074.md)
- [Usar o Fiddler para inspecionar chamadas de serviços web](https://docs.xbox.com/pt-BR/tools/tools-services/live-fiddler-inspect-web-calls.md)
- [Captura de rede do Xbox One](https://docs.xbox.com/pt-BR/build/console-features/networking/tools/netcap-networking.md)