Présentation de l’extension Adobe Media Analytics for Audio and Video

Créer une instance MediaHeartbeat  : window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat.getInstance

Paramètres  : un objet délégué valide exposant ces fonctions.

Valeur renvoyée  : une promesse qui est résolue avec une instance MediaHeartbeat ou rejetée avec un message d’erreur.

Accéder aux constantes MediaHeartbeat :  window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat

Cette opération expose toutes les constantes et les méthodes statiques de la classe MediaHeartbeat.

Vous pouvez obtenir l’exemple de lecteur ici : MA Sample Player. Le lecteur d’exemple fait office de référence pour expliquer comment utiliser l’extension MA pour prendre en charge directement Media Analytics à partir d’une application web.

Créez l’instance de suivi MediaHeartbeat comme suit :

var MediaHeartbeat = window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat;

var delegate = {
    getCurrentPlaybackTime: this._getCurrentPlaybackTime.bind(this),
    getQoSObject: this._getQoSObject.bind(this),
};

var config = {
    playerName: "Custom Player",
    ovp: "Custom OVP",
    channel: "Custom Channel"
};

var self = this;
MediaHeartbeat.getInstance(delegate, config).then(function(instance) {
    self._mediaHeartbeat = instance;
    // Do Tracking using the MediaHeartbeat instance.
}).catch(function(err){
    // Getting MediaHeartbeat instance failed.
});

Créer une instance MediaHeartbeat get-instance : module partagé

Paramètres  :

• Un objet délégué valide exposant ces fonctions :

  table 0-row-2 1-row-2 2-row-2 1-align-left 2-align-left 4-align-left 5-align-left 7-align-left 8-align-left
  Méthode	Description
  getQoSObject()	Retourne l’instance MediaObject contenant les informations actuelles sur la qualité de service QoS. Cette méthode est appelée à plusieurs reprises au cours d’une session de lecture. La mise en œuvre du lecteur doit toujours retourner les plus récentes données QoS disponibles.
  getCurrentPlaybackTime()	Renvoie la position actuelle du curseur de lecture. Pour le suivi VOD, la valeur est indiquée en secondes à partir du début de l’élément média. Pour le suivi LIVE/LIVE, la valeur est indiquée en secondes à partir du début du programme.

• Un objet de configuration facultatif exposant ces propriétés :

  table 0-row-3 1-row-3 2-row-3 3-row-3 1-align-left 2-align-left 3-align-left 5-align-left 6-align-left 7-align-left 9-align-left 10-align-left 11-align-left 13-align-left 14-align-left 15-align-left
  Propriété	Description	Obligatoire
  Online Video Provider	Nom de la plateforme vidéo en ligne sur laquelle le contenu est distribué.	Non. Le cas échéant, remplace la valeur définie pendant la configuration de l’extension.
  Nom du lecteur	Le nom du lecteur multimédia en cours d’utilisation (par exemple, « AVPlayer », « Lecteur HTML5 », « Mon lecteur personnalisé »)	Non. Le cas échéant, remplace la valeur définie pendant la configuration de l’extension.
  Canal	Propriété du nom de canal	Non. Le cas échéant, remplace la valeur définie pendant la configuration de l’extension.

Valeur renvoyée  : une promesse qui est résolue avec une instance MediaHeartbeat ou rejetée avec un message d’erreur.

Accéder aux constantes MediaHeartbeat media-heartbeat : module partagé

Ce module expose toutes les constantes et les méthodes statiques de cette classe : https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript/MediaHeartbeat.html.

Créez l’instance de suivi MediaHeartbeat comme suit :

var getMediaHeartbeatInstance =
  turbine.getSharedModule('adobe-video-analytics', 'get-instance');

var MediaHeartbeat =
  turbine.getSharedModule('adobe-video-analytics', 'media-heartbeat');
  ...

var delegate = {
    getCurrentPlaybackTime: this._getCurrentPlaybackTime.bind(this),
    getQoSObject: this._getQoSObject.bind(this),
}

var config = {
    playerName: "Custom Player",
    ovp: "Custom OVP",
    channel: "Custom Channel"
}
...

var self = this;
getMediaHeartbeatInstance(delegate, config).then(function(instance) {
    self._mediaHeartbeat = instance;
    ...
    // Do Tracking using the MediaHeartbeat instance.
}).catch(function(err){
    // Getting MediaHeartbeat instance failed.
});

...

À l’aide de l’instance Pulsations multimédia, consultez la documentation JS du SDK multimédia et la documentation de l’API JS pour mettre en œuvre le suivi multimédia.