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

Rastrear a qualidade da experiência usando o JavaScript 3.x track-quality-of-experience-on-javascript

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 anterior do SDK, você pode baixar os Guias dos desenvolvedores aqui: Baixar SDKs.

Implementar QOE

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

    Variáveis de QoEObject:

    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
    Variável Tipo Descrição
    bitrate number Taxa de bits atual
    startupTime number Tempo de inicialização
    fps number Valor do FPS
    droppedFrames number Número de quadros perdidos

    Criação do objeto de QoE:

    code language-js 
    // Replace <bitrate>, <startuptime>, <fps> and
// <droppeFrames> with the current playback QoE values.
var qoeObject = ADB.Media.createQoEObject(<bitrate>,
                                               <startuptime>,
                                               <fps>,
                                               <droppedFrames>);
tracker.updateQoEObject(qoeObject);

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

    code language-js 
    _onBitrateChange = function() {
    // If the new bitrate value is available provide it to the tracker.
    var qoeObject = ADB.Media.createQoEObject(1000000, 2.4, 25, 10);
    tracker.updateQoEObject(qoeObject);

    tracker.trackEvent(ADB.Media.Event.BitrateChange);
};
    note important
    IMPORTANT
    Atualize o objeto de QoE e chame o evento de alteração da taxa de bits a cada alteração. Isto fornece os dados de QoE mais precisos.

  3. Certifique-se de chamar o método updateQoEObject() para fornecer as informações de QoE mais atualizadas para o SDK.

  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