DocumentaçãoAnalyticsGuia do Media Analytics

Visão geral overview

Last update: Mon Jan 23 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • User
  • Admin
  • Developer

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.

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. Veja abaixo os principais elementos do rastreamento da qualidade da experiência:

Eventos do player player-events

Em qualquer alteração de métrica de QoS:

Crie ou atualize a instância do objeto QoS para a reprodução. Referência da API QoS

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

Chame trackEvent(Media.Heartbeat.Event.BitrateChange);

Implementação do QOS

  1. Identifique quando qualquer uma das métricas de QOS for alterada durante a reprodução da mídia, crie o MediaObject usando as informações de QoS e atualize as novas informações.

    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

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

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

    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.

O código de exemplo a seguir usa o SDK 2.x do JavaScript para um reprodutor de mídia HTML5. Você deve usar esse código com o código de reprodução de mídia principal.

var mediaDelegate = new MediaHeartbeatDelegate();
...

// This is called periodically by MediaHeartbeat instance
mediaDelegate.prototype.getQoSObject = function() {
    return this.qosInfo;
};

if (e.type == "qos_update") {
    var qosInfo = MediaHeartbeat.createQoSObject(<BITRATE>,<STARTUP_TIME>,<FPS>,<DROPPED_FRAMES>);
    mediaDelegate.qosInfo = qosInfo;
};

if (e.type == "bitrate_change") {
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.BitrateChange, qosObject);
};
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb