Rich Media

 

Avant-propos

Le SDK Internet vous permet de marquer les vidéos et médias audio joués par l’utilisateur durant l’utilisation de l’application.

 

Pour bien débuter

Une fois votre marqueur initialisé, vous pouvez débuter le marquage de vos vidéos et de vos médias audio.

Pour utiliser les classes et les méthodes du SDK, veillez à ajouter le namespace ATInternet dans votre Page.

 

Marquage

Le marquage RichMedia n’est pas pris en compte dans la mécanique du Dispatch !

Le tracker met à disposition un objet MediaPlayers. Cet objet expose les méthodes suivantes :

  • Add : Permet de renseigner un nouveau player et retourne un objet MediaPlayer
  • Remove : Supprime un player
  • RemoveAll : Supprime tous les players

Lors de la suppression d’un player, si un média est en cours de lecture, un hit sera automatiquement envoyé afin d’arrêter la mesure.

Une fois qu’un player est instancié, il est possible de marquer les vidéos et médias audio.

Tous les objets présentés ci-dessous expose les méthodes suivantes :

  • SendPlay() : Envoie un hit de lecture d’un média avec un hit de rafraîchissement envoyé automatiquement toutes les 5 secondes
  • SendPlay(int refreshDuration) : Idem sauf qu’il est possible de préciser la période de rafraîchissement (le paramètre renseigné ne peut être inférieur à 5 qui est la période minimale SAUF si le paramètre vaut 0 auquel cas le rafraîchissement n’est pas activé !)
  • SendPause : Envoie un hit de mise en pause du média
  • SendStop : Envoie un hit d’arrêt complet de la lecture du média
  • SendMove : Envoie un hit de déplacement du curseur de lecture du player
  •  

    Video

L’objet MediaPlayer met à disposition un objet Videos. Cet objet expose les méthodes suivantes :

  • Add : Permet d’ajouter une vidéo au player et retourne un objet Video
  • Remove : Supprime une vidéo
  • RemoveAll : Supprime toutes les vidéos
 

Exemples de marquage

  1. Marquage d’une lecture de vidéo sans rafraîchissement
  2. Marquage d’une lecture de vidéo avec rafraîchissement (la période de rafraîchissement ne peut pas être inférieure à 5s)
  3. Marquage d’une pause dans la vidéo
  4. Marquage d’un stop dans la vidéo
  5. Marquage d’une mouvement du curseur de la vidéo

     
  •  

    LiveVideo

L’objet MediaPlayer met à disposition un objet LiveVideos. Cet objet expose les méthodes suivantes :

  • Add : Permet d’ajouter une vidéo live au player et retourne un objet LiveVideo
  • Remove : Supprime une vidéo live
  • RemoveAll : Supprime toutes les vidéos live
 

Exemples de marquage

  1. Marquage d’une lecture de vidéo live sans rafraîchissement
  2. Marquage d’une lecture de vidéo live avec rafraîchissement (la période de rafraîchissement ne peut pas être inférieure à 5s)
  3. Marquage d’une pause dans la vidéo live
  4. Marquage d’un stop dans la vidéo live
  5. Marquage d’une mouvement du curseur de la vidéo live

 

  •  

    Audio

L’objet MediaPlayer met à disposition un objet Audios. Cet objet expose les méthodes suivantes :

  • Add : Permet d’ajouter un média audio au player et retourne un objet Audio
  • Remove : Supprime un média audio
  • RemoveAll : Supprime tous les médias audios
 

Exemples de marquage

  1. Marquage d’une lecture de média audio sans rafraîchissement
  2. Marquage d’une lecture de média audio avec rafraîchissement (la période de rafraîchissement ne peut pas être inférieure à 5s)
  3. Marquage d’une pause dans le média audio
  4. Marquage d’un stop dans le média audio
  5. Marquage d’une mouvement du curseur du média audio
  •  

    LiveAudio

L’objet MediaPlayer met à disposition un objet LiveAudios. Cet objet expose les méthodes suivantes :

  • Add : Permet d’ajouter un média audio live au player et retourne un objet LiveAudio
  • Remove : Supprime un média audio live
  • RemoveAll : Supprime tous les médias audio live
 

Exemples de marquage

  1. Marquage d’une lecture de média audio live sans rafraîchissement
  2. Marquage d’une lecture de média audio live avec rafraîchissement (la période de rafraîchissement ne peut pas être inférieure à 5s)
  3. Marquage d’une pause dans le média audio live
  4. Marquage d’un stop dans le média audio live
  5. Marquage d’une mouvement du curseur du média audio live
 

Classe MediaPlayer

 

Propriétés

Nom Type Valeur par défaut Description
PlayerId Int 1 Obtient ou définit l’identifiant du player
Videos Videos null Obtient l’instance permettant de gérer les vidéos
Audios Audios null Obtient l’instance permettant de gérer les médias audio
LiveVideos LiveVideos null Obtient l’instance permettant de gérer les vidéos live
LiveAudios LiveAudios null Obtient l’instance permettant de gérer les médias audio live

La gestion de l’identifiant du player est automatique mais vous pouvez cependant en spécifier un.

 

Propriétés communes

Nom Type Valeur par défaut Description
Name String Chaîne vide Obtient ou définit le nom du média visionné
Chapter1 String null Obtient ou définit le premier chapitre
Chapter2 String null Obtient ou définit le second chapitre
Chapter3 String null Obtient ou définit le troisième chapitre
Action Enum null Obtient ou définit le type d’action
Level2 Int -1 Obtient ou définit l’identifiant du niveau 2
IsBuffering Boolean false Indique si le média est en « buffering »
IsEmbedded Boolean false Indique si le média est externe à l’application
WebDomain String null Obtient ou définit le referrer du média
 

Classe Video

 

Propriétés

Nom Type Valeur par défaut Description
Duration Int 0 Obtient ou définit la durée total de la vidéo en seconde
 

Classe Audio

 

Propriétés

Nom Type Valeur par défaut Description
Duration Int 0 Obtient ou définit la durée total du média audio en seconde

 

 

Méthodes

Nom Type de retour Description
SendPlay() void Envoi du hit de lecture avec un rafraîchissement automatique de 5 secondes
SendPlay(int refreshDuration) void Envoi du hit de lecture avec un rafraîchissement automatique donné en paramètre (0 = désactivation du rafraîchissement)
SendPause void Envoi du hit de pause
SendStop void Envoi du hit de stop
SendMove void Envoi du hit de mouvement du curseur de lecture
Cet article vous a-t-il été utile ?
Oui
Non
Dernière mise à jour : 29/10/2015