Skip to main content
Versão 1.2, 11/01/2025 Os títulos que excederem os limites baseados em título e em usuário ao chamar os serviços da rede XBOX ou que não seguirem as políticas de repetição dos serviços da rede XBOX poderão estar sujeitos à limitação de taxa, o que pode resultar em interrupção ou descontinuação do serviço. O não cumprimento dos limites especificados pode impedir o lançamento de um título, e problemas em produção com títulos lançados podem resultar na suspensão dos serviços da rede XBOX, podendo chegar inclusive à remoção do título.
[!NOTE] Embora o XR-132 seja voltado para jogos multijogador, ele também pode se aplicar a jogos de um jogador caso eles acessem os serviços da rede XBOX. Por exemplo, se um jogo de um jogador usar salvamentos na nuvem, conquistas ou outros recursos da rede XBOX, ele deverá seguir as diretrizes do XR-132.

Casos de teste de certificação

132-01 Limitações de acesso aos serviços

Ferramentas necessárias

Etapas de teste

Usando o Fiddler Classic:
  1. Antes de iniciar o título, inicie o Fiddler Classic e verifique se ele está configurado para capturar o tráfego de rede do console ou do PC com Windows 10 (onde quer que o título em questão esteja sendo executado).
  2. Com o Fiddler Classic em execução e capturando o tráfego de rede, inicie o título e percorra todas as áreas, incluindo, entre outras, as seguintes:
    • Criar um jogo salvo, reinicializar o console e carregar o jogo salvo
    • Alterar os estados de presença avançada em rápida sucessão (se possível)
    • Desbloquear conquistas
    • Publicar em todos os placares de líderes e exibir todos os placares de líderes usando todos os filtros
    • Exibir a Lista de Amigos no jogo (incluindo um amigo com a presença bloqueada) e alternar entre as páginas rapidamente
    • Usar o matchmaking em todos os modos online, incluindo não conseguir encontrar uma sessão disponível (se possível), e gerar tráfego de voz
    • Acessar a loja no jogo (se aplicável)
  3. Quando o teste for concluído, salve a captura do Fiddler em um diretório local.
  4. No prompt de comando do GDK/XDK, execute XblTraceAnalyzer -data filepath -outputdir filepath
  5. Abra o diretório de saída da etapa 4 e abra o arquivo ‘index’ (selecione ‘Permitir conteúdo bloqueado’ se solicitado).
Usando o xbtrace.exe Observe que o xbtrace.exe não pode ser iniciado até que o título seja iniciado, mas deve ser iniciado o mais rápido possível para capturar todas as chamadas de serviço XBOX que o título faz durante a inicialização. Por isso, o método preferencial para capturar o tráfego do título é o Fiddler Classic, pois ele pode ser iniciado antes do título.
  1. Com o título em execução, execute xbtrace start xboxliveservices e percorra todas as áreas do título, incluindo, entre outras, as seguintes:
    • Criar um jogo salvo, reinicializar o console e carregar o jogo salvo
    • Alterar os estados de presença avançada em rápida sucessão (se possível)
    • Desbloquear conquistas
    • Publicar em todos os placares de líderes e exibir todos os placares de líderes usando todos os filtros
    • Exibir a Lista de Amigos no jogo (incluindo um amigo com a presença bloqueada) e alternar entre as páginas rapidamente
    • Usar o matchmaking em todos os modos online, incluindo não conseguir encontrar uma sessão disponível (se possível), e gerar tráfego de voz
    • Acessar a loja no jogo (se aplicável)
  2. Quando o teste for concluído, execute xbtrace stop duas vezes.
  3. Navegue pelos arquivos do console e, em SystemScratch > xbtrace, você encontrará o csv. Verifique o carimbo de data/hora para garantir que ele registre o horário em que você parou a gravação. Copie-o localmente.
  4. No prompt de comando do XDK, execute Xbltraceanalyzer -data filepath -outputdir filepath.
  5. Abra o diretório de saída da etapa 4 e abra o arquivo ‘index’ (selecione ‘Permitir conteúdo bloqueado’ se solicitado).

Resultado esperado

Os títulos devem garantir que mantenham suas chamadas de serviço para os pontos de extremidade XBOX abaixo dos limites de pico e de manutenção especificados e não tenham nenhum resultado vermelho no relatório do XBOX services Trace Analyzer. A ferramenta XBOX services Trace Analyzer gera um arquivo report.txt que indica as regras que encontraram violações, juntamente com os detalhes dessas violações.
[!Tip] Interpretação do relatório do XBOX services Trace Analyzer
  • Vermelho - Indica um problema que excede em 10 vezes o ponto em que a limitação de taxa refinada entra em vigor. Esse é um problema grave na certificação.
  • Amarelo - Indica que o serviço está sofrendo limitação de taxa porque o título excede a frequência com que as chamadas ao serviço são permitidas, mas não excede o limite que seria um problema grave na certificação. Os títulos devem procurar resolver esses problemas.
  • Verde - Indica que o título está fazendo chamadas aos serviços XBOX abaixo da frequência em que a limitação de taxa entraria em vigor.
Exemplos de aprovação
  1. O título não excede o limite de manutenção ao chamar os serviços XBOX.
  2. O relatório do XBOX services Trace Analyzer contém apenas resultados amarelos e/ou verdes.
Exemplos de falha
  1. O título excede em 10 vezes o limite de manutenção (limite a partir do qual a limitação de taxa entra em vigor). Por exemplo, se o limite de manutenção a partir do qual a limitação de taxa refinada entra em vigor for definido como 300 chamadas em 300 segundos, os títulos com 3000 ou mais chamadas em 300 segundos falharão.
  2. O relatório do XBOX services Trace Analyzer contém um ou mais resultados vermelhos.

132-02 Limitações de eventos de jogo

Etapas de teste

  1. Instale o título e, com o título em execução, navegue por todas as áreas do título, incluindo, entre outras, as seguintes:
    • Criar um jogo salvo, reinicializar o console e carregar o jogo salvo
    • Alterar os estados de presença avançada em rápida sucessão (se possível)
    • Desbloquear conquistas
    • Publicar em todos os placares de líderes e exibir todos os placares de líderes usando todos os filtros
    • Exibir a Lista de Amigos no jogo (incluindo um amigo com a presença bloqueada) e alternar entre as páginas rapidamente
    • Usar o matchmaking em todos os modos online, incluindo não conseguir encontrar uma sessão disponível (se possível), e gerar tráfego de voz
    • Acessar a loja no jogo (se aplicável)
  2. Durante o teste, observe o título para ver se a notificação do sistema de Limitações de eventos de jogo é exibida.
Imagem da notificação do sistema de Limitações de eventos de jogo

Resultado esperado

Os jogos não devem disparar a notificação do sistema de Limitações de eventos de jogo. Exemplos de aprovação
  1. O título não dispara a notificação do sistema de Limitações de eventos de jogo.
Exemplos de falha
  1. O título dispara a notificação do sistema de Limitações de eventos de jogo.
Última modificação em 8 de outubro de 2026