Agent média pour Shaka v4.0.3

Cette sortie introduit trois nouvelles métriques de débit binaire pour une observabilité granulaire de la lecture, la prise en charge de la QoE (Quality of Experience), et la compatibilité avec Shaka Player 5.x, tout en maintenant la rétrocompatibilité avec Shaka 4.x.

Nouvelles métriques de débit binaire

Trois nouveaux attributs sont désormais disponibles pour fournir des informations détaillées plus approfondies sur les performances de streaming :

Attribut	Source	Description
`contentManifestBitrate`	`stats.streamBandwidth`	Débit binaire total de la variante (vidéo + audio) tel que déclaré dans le manifeste (Débit binaire indiqué).
`contentMeasuredBitrate`	`stats.estimatedBandwidth`	Bande passante réseau estimée mesurée par l'algorithme ABR de Shaka (débit binaire observé).
`contentDownloadBitrate`	`(bytesDownloaded × 8) / playTime`	Débit de téléchargement effectif sur tous les médias téléchargés.

De plus, contentBitrate utilise track.videoBandwidth (débit binaire vidéo uniquement) pour le différencier des autres métriques qui indiquent la bande passante vidéo et audio combinée.

Prise en charge de la qualité d'expérience (QoE)

Les événements agrégés de QoE sont désormais pris en charge via video-core. Activez-les en définissant qoeAggregate: true dans la configuration :

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

const tracker = new ShakaTracker(player, options);

Les KPI suivants sont suivis automatiquement :

Indicateurs de performance clés	Description
`startupTime`	Temps entre la demande de contenu et le début du contenu (ms).
`peakBitrate`	`contentBitrate` maximum observé pendant la lecture.
`averageBitrate`	Débit binaire moyen pondéré sur l'ensemble de la session.
`hadStartupFailure`	`true` si une erreur de contenu s'est produite avant que le contenu ne commence.
`hadPlaybackFailure`	`true` si une erreur de contenu est survenue pendant la lecture.
`totalRebufferingTime`	Temps total passé en rebuffering (ms).
`rebufferingRatio`	Temps de re-mise en mémoire tampon en pourcentage du temps de lecture total.
`totalPlaytime`	Temps total de lecture du contenu (ms).
`numberOfErrors`	Nombre total d'erreurs pendant la session.

Compatibilité Shaka Player 5.x

Le tracker est désormais compatible avec Shaka Player 4.x et 5.x :

getPlayerVersion() résout la version sur les deux versions majeures.
onError() gère à la fois les erreurs du lecteur Shaka (e.detail) et les erreurs de l'élément vidéo HTML (e.target.error).
Fichiers d'exemple mis à jour pour Shaka 5.x (suppression de shaka.polyfill.installAll() obsolète, mise à jour de l'instanciation du lecteur).

Guide de mise à niveau

Exécutez ce qui suit pour mettre à jour :

bash

$npm install @newrelic/video-shaka@4.0.3

Pour activer la QoE, ajoutez qoeAggregate: true à vos options de configuration comme indiqué ci-dessus.

Dépendances

Nécessite @newrelic/video-core v4.1.1 ou une version ultérieure pour la prise en charge de la QoE.