Agente de mídia para Shaka v4.0.3

Esta versão introduz três novas métricas de taxa de bits para observabilidade granular de reprodução, suporte a QoE (Qualidade de Experiência) e compatibilidade com o Shaka Player 5.x, mantendo a retrocompatibilidade com o Shaka 4.x.

Novas métricas de taxa de bits

Três novos atributos agora estão disponíveis para fornecer insights mais profundos sobre o desempenho de streaming:

Atributo	Fonte	Descrição
`contentManifestBitrate`	`stats.streamBandwidth`	Taxa de bits total da variante (vídeo + áudio) conforme declarada no manifesto (Taxa de bits indicada).
`contentMeasuredBitrate`	`stats.estimatedBandwidth`	Largura de banda de rede estimada medida pelo algoritmo ABR do Shaka (Taxa de bits observada).
`contentDownloadBitrate`	`(bytesDownloaded × 8) / playTime`	Taxas de transferência de download efetivas em todas as mídias baixadas.

Além disso, contentBitrate usa track.videoBandwidth (taxa de bits apenas de vídeo) para diferenciá-lo de outras métricas que reportam a largura de banda combinada de vídeo e áudio.

Suporte à Qualidade de Experiência (QoE)

Eventos agregados de QoE agora são suportados via video-core. Habilite-os definindo qoeAggregate: true na configuração:

const options = {
  info: {
    beacon: 'xxxxxxxxxx',
    applicationID: 'xxxxxxx',
    licenseKey: 'xxxxxxxxxxx',
  },
  config: {
    qoeAggregate: true,
    qoeIntervalFactor: 2,
  },
};

const tracker = new ShakaTracker(player, options);

Os seguintes KPIs são rastreados automaticamente:

KPI	Descrição
`startupTime`	Tempo da solicitação de conteúdo até o início do conteúdo (ms).
`peakBitrate`	Máximo de `contentBitrate` observado durante a reprodução.
`averageBitrate`	Taxa de bits média ponderada em toda a sessão.
`hadStartupFailure`	`true` se um erro de conteúdo ocorreu antes de o conteúdo iniciar.
`hadPlaybackFailure`	`true` se um erro de conteúdo ocorreu durante a reprodução.
`totalRebufferingTime`	Tempo total gasto em rebufferização (ms).
`rebufferingRatio`	Tempo de rebuffering como um percentual do tempo total de reprodução.
`totalPlaytime`	Tempo total de reprodução de conteúdo (ms).
`numberOfErrors`	Número total de erros durante a sessão.

Compatibilidade com o Shaka Player 5.x

O tracker agora é compatível com o Shaka Player 4.x e 5.x:

getPlayerVersion() resolve a versão em ambas as versões principais.
onError() trata tanto os erros do Shaka player (e.detail) quanto os erros do elemento de vídeo HTML (e.target.error).
Arquivos de exemplo atualizados para o Shaka 5.x (removido shaka.polyfill.installAll() descontinuado, instanciação do player atualizada).

Guia de atualização

Execute o seguinte para atualizar:

bash

$npm install @newrelic/video-shaka@4.0.3

Para habilitar o QoE, adicione qoeAggregate: true às suas opções de configuração, conforme mostrado acima.

Dependência

Requer @newrelic/video-core v4.1.1 ou posterior para suporte a QoE.