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

Rastrear a qualidade de experiência usando o JavaScript 2.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 1.x do SDK, você pode baixar os Guias dos desenvolvedores 1.x aqui: Baixar SDKs.

Implementar QOS

  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:

    code language-js 
    // Replace <bitrate>, <startuptime>, <fps> and
// <droppeFrames> with the current playback QoS values.
var qosObject = MediaHeartbeat.createQoSObject(<bitrate>,
                                               <startuptime>,
                                               <fps>,
                                               <droppedFrames>);

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

    code language-js 
    _onBitrateChange = function() {
    this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.BitrateChange, qosObject);
};
    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