DocumentaçãoAnalyticsGuia de serviços para mídia de streaming

Rastrear a qualidade da experiência no Chromecast track-quality-of-experience-on-chromecast

Last update: Fri Oct 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Usuário
  • Administrador
  • Desenvolvedor

As instruções a seguir fornecem orientação para a implementação em todos os SDKs 2.x.

IMPORTANT
Se estiver implementando uma versão 1.x do SDK, você pode baixar os Guias dos desenvolvedores 1.x aqui: Baixar SDKs.

Visão geral overview

O rastreamento da qualidade da experiência inclui qualidade do serviço (QoS) e rastreamento de erros; ambos são elementos opcionais e não são necessários para implementações de rastreamento de mídia principal. Você pode usar a API do reprodutor de mídia para identificar as variáveis relacionadas ao rastreamento de erros e QoS.

Eventos do player player-events

Em todos os eventos de alteração da taxa de bits

  • Criar/atualizar a instância do objeto QoS para a reprodução, qosObject
  • Chame trackEvent(Media.Heartbeat.Event.BitrateChange, qosObject);

Quando ocorrem erros no reprodutor

Chame trackError("media error id");

Implementar implement

  1. Identifique quando a taxa de bits for alterada durante a reprodução de mídia e crie a instância MediaObject usando as informações de QoS.

    Variáveis de QoSObject:

    note tip
    TIP
    Essas variáveis somente são necessárias se você estiver planejando rastrear QoS.
    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center
    Variável Descrição Obrigatório
    bitrate Taxa de bits atual Sim
    startupTime Tempo de inicialização Sim
    fps Valor do FPS Sim
    droppedFrames Número de quadros perdidos Sim

    Criação do objeto de QoS: createQoSObject

    code language-none 
    qosInfo = ADBMobile.media.createQoSObject(50000, 0, 24, 10);

  2. Quando a reprodução alterar as taxas de bits, chame o evento BitrateChange na instância do heartbeat de mídia: trackEvent

    code language-none 
    ADBMobile.media.trackEvent(ADBMobile.media.Event.BitrateChange);
    note important
    IMPORTANT
    Atualize o objeto de QoS e chame o evento de alteração na taxa de bits em cada alteração na taxa de bits. Isso fornece os dados de QoS mais precisos.

  3. Verifique se o método getQoSObject() retorna as informações de QoS mais atualizadas.

  4. Quando o reprodutor de mídia encontra um erro e o evento de erro está disponível para a API do reprodutor, use trackError() para capturar as informações do erro. (Consulte Visão geral.)

    note tip
    TIP
    O rastreamento de erros do reprodutor de mídia não interrompe a sessão de rastreamento de mídia. Se o erro do reprodutor de mídia estiver impedindo o andamento da reprodução, certifique-se de que a sessão de monitoramento de mídia está fechada, chamando trackSessionEnd() após chamar trackError().
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb