Pular para o conteúdo principal
Às vezes, os títulos podem querer mostrar o quanto suas filas estão ativas, em um esforço para definir as expectativas dos usuários quanto aos tempos de espera. Eles podem recuperar essas estatísticas e exibi-las diretamente ao usuário ou, talvez, recuperá-las de um servidor para exibir ou coletar telemetria aproximada, como desejarem. Este tutorial mostra as etapas para recuperar essas estatísticas do matchmaking.

Configurar sua fila

Primeiro, decida se você deve configurar sua fila para permitir que as estatísticas sejam recuperadas pelos usuários. Os servidores sempre podem recuperar as estatísticas de cada fila. Os usuários só podem recuperar estatísticas se a configuração da fila tiver as opções Mostrar o número de jogadores em matchmaking e/ou Mostrar as estatísticas de tempo para formar a partida marcadas. Um exemplo de fila com essa configuração pode ser encontrado em Exemplos de configuração de matchmaking.

Recuperando estatísticas

Chame a API GetQueueStatistics para recuperar as estatísticas. Esses valores são agregados e atualizados ao longo do tempo. Por esse motivo, a API GetQueueStatistics deve ser chamada apenas de forma intermitente. Ela não se destina a fornecer o acompanhamento em tempo real das estatísticas de uma fila.
Última modificação em 8 de outubro de 2026