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édia audio.

Dans le cas où vous utilisez
des variables, veillez à importer les classes ATInternet, Tracker, MediaPlayer, Video, Audio, LiveVideo, LiveAudio,
Medium et LiveMedium dans votre Activity.

 

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édia audio.

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

  • sendPlay() :
    • < 2.9.0 : Envoie un hit de lecture d’un média avec un hit de rafraîchissement
      envoyé automatiquement toutes les 5 secondes
    • >= 2.9.0 : Envoie un hit de lecture d’un média avec un hit de rafraîchissement
      envoyé automatiquement en suivant la définition des paliers suivants:

      • Toutes les 5 secondes pendant la première minute
      • Toutes les 15 secondes entre la seconde et la cinquième minute
      • Toutes les 30 secondes entre la sixième et la dixième minute
      • Toutes les minutes à partir d’une durée de lecture > 10 minutes
  • sendPlay(int refreshDuration) (déprecié en version 2.9.0) : 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
  • >= 2.9.0 :
    • sendPlay(SparseIntArray refreshDurations) : Donne la possibilité de définir les paliers de
      rafraichissement
    • sendPlayWithoutRefresh() : Envoie un hit de lecture d’un média sans rafraichissement
    • sendResume() : Permet de reprendre la lecture d’un média mis en pause en conservant les paliers de
      rafraichissement actualisés
  •  

    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 lecture de vidéo avec l’ensemble de ses informations
  4. Marquage d’une pause dans la vidéo
  5. Marquage d’un stop dans la vidéo
  6. Marquage d’information de la vidéo
  7. Marquage d’une autre action 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’information sur une vidéo live
  6. Marquage d’une autre action sur une 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’information du média audio
  6. Marquage d’une autre action 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’information du live audio
  6. Marquage d’une autre action du média audio live
  •  

    Medium

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

  • add : Permet d’ajouter un medium au player et retourne un objet Medium
  • remove : Supprime un medium
  • removeAll : Supprime tous les média
 

Exemples de marquage

  1. Marquage d’une lecture de medium sans rafraîchissement
  2. Marquage d’une lecture de medium avec rafraîchissement (la période de rafraîchissement ne peut pas être
    inférieure à 5s)
  3. Marquage d’une pause dans le medium
  4. Marquage d’un stop dans le medium
  5. Marquage d’information du medium
  6. Marquage d’une autre action sur un medium
  •  

    LiveMedium

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

  • add : Permet d’ajouter un medium live au player et retourne un objet LiveMedium
  • remove : Supprime un medium live
  • removeAll : Supprime tous les média live
 

Exemples de marquage

  1. Marquage d’une lecture de medium live sans rafraîchissement
  2. Marquage d’une lecture de medium live avec rafraîchissement (la période de rafraîchissement ne peut pas être
    inférieure à 5s)
  3. Marquage d’une pause dans le medium live
  4. Marquage d’un stop dans le medium live
  5. Marquage d’information du medium live
  6. Marquage d’une autre action du medium live
  •  

    Gestion de la mise en cache (buffering) (>= 2.10.0)

Depuis la version 2.10.0, il est désormais possible de mesurer le temps de mise en cache (buffering) d’un média quel qu’il soit.

 

Exemples de marquage

  1. Lancement d’une lecture sans mise en cache
  2. Lancement d’une lecture avec mise en cache
  3. Reprise de la lecture suite à une mise en cache
  4. Mise en cache pour une lecture en cours
 

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
Media (>= 2.10.0) Media null Obtient l’instance permettant de gérer les média
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
LiveMedia (>= 2.10.0) LiveMedia null Obtient l’instance permettant de gérer les média 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
mediaLabel String Chaîne vide Obtient ou définit le label du média visionné
mediaTheme1 String null Obtient ou définit le premier thème
mediaTheme2 String null Obtient ou définit le second thème
mediaTheme3 String null Obtient ou définit le troisième thème
mediaLevel2 Int -1 Obtient ou définit l’identifiant du niveau 2
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
 

Classe Medium

 

Propriétés

Nom Type Valeur par défaut Description
duration Int 0 Obtient ou définit la durée total du medium en seconde

 

 

Méthodes

sendInfo(boolean isBuffering)voidEnvoi du hit d’information de lecture en spécifiant s’il y a du buffering

 

Nom Type de retour Description
sendPlay() (< 2.9.0) void Envoi du hit de lecture avec un rafraîchissement automatique de 5 secondes
sendPlay() (>=2.9.0) void Envoi du hit de lecture avec un rafraîchissement automatique définit par paliers (voir plus haut)
sendPlay(boolean isBuffering) (>= 2.10.0) void Envoi du hit de lecture avec un rafraîchissement automatique définit par paliers (voir plus haut) en
spécifiant s’il y a du buffering
sendPlay(int refreshDuration) (déprécié en 2.9.0) void Envoi du hit de lecture avec un rafraîchissement automatique donné en paramètre (0 = désactivation du
rafraîchissement)
sendPlay(SparseIntArray refreshDurations) (>= 2.9.0) void Envoi du hit de lecture avec un rafraîchissement automatique en respectant les paliers définit en
paramètre
sendPlay(SparseIntArray refreshDurations) (>= 2.10.0) void Envoi du hit de lecture avec un rafraîchissement automatique en respectant les paliers définit en
paramètre en spécifiant s’il y a du buffering
sendPlayWithoutRefresh() (>= 2.9.0) void Envoi du hit de lecture sans rafraîchissement
sendPlayWithoutRefresh(boolean isBuffering) (>= 2.10.0) void Envoi du hit de lecture sans rafraîchissement en spécifiant s’il y a du buffering
sendResume() (>= 2.9.0) void Reprise de la mesure de la lecture en l’état
sendResume(boolean isBuffering) (>= 2.10.0) void Reprise de la mesure de la lecture en l’état en spécifiant s’il y a du buffering
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
sendInfo() (>= 2.10.0) void Envoi du hit d’information de lecture
sendInfo(boolean isBuffering) (>= 2.10.0) void Envoi du hit d’information de lecture en spécifiant s’il y a du buffering
sendShare (>= 2.10.0) void Envoi du hit de partage
sendEmail (>= 2.10.0) void Envoi du hit d’email
sendFavor (>= 2.10.0) void Envoi du hit de mise en favori
sendDownload (>= 2.10.0) void Envoi du hit de téléchargement
Cet article vous a-t-il été utile ?
Oui
Non
Dernière mise à jour : 28/09/2018