Rich Media

  • iOS
  • watchOS
  • tvOS
 

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.

Dans le cas d’un projet Swift,
veillez à importer le module SmartTracker (ou tvOSTracker/watchOSTracker si votre target est une Apple TV ou une
Apple Watch) dans votre ViewController.

 

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 exposent 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 avec période de rafraîchissement (déprécié en version 2.9.0) :
    Envoie un hit de lecture d’un média avec une période de rafraîchissement personnalisée (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é !)
  • >= 2.9.0 :
    • sendPlay avec rafraîchissement dynamique : Envoie un hit de lecture d’un média avec des hits de
      rafraîchissement envoyés selon des paliers personnalisés
    • sendPlayWithoutRefresh() : Envoie un hit de lecture d’un média sans rafraichissement
    • sendResume : Envoie un hit de lecture en reprenant le rafraîchissement dynamique
  • 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
 

Refresh dynamique (>= 2.9.0)

La méthode sendPlay d’un média a été améliorée  pour optimiser un envoi de hit de refresh trop fréquent.
Désormais la méthode sendPlay prendra en paramètre un Dictionary<Int, Int> sous la
forme [0: 5, 2: 10, 3: 20] signifiant :

  • De 0 à 2 minutes de média consommé (non affecté par un sendMove), un hit de rafraîchissement sera
    envoyé toutes les 5 secondes.
  • De 2 à 3 minutes, un hit de rafraîchissement sera envoyé toutes les 10 secondes.
  • Au-delà de 3 minutes, un hit de rafraîchissement sera envoyé toutes les 20 secondes.

Dans le cas d’un sendPause(), la méthode sendResume() sera utilisée pour
reprendre et conserver la lecture et le rafraîchissement dynamique. Si un sendPlay(_) est appelé au
lieu d’un sendResume(), la configuration dynamique est réinitialisée et repart du début.

 

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 avec la période de rafraîchissement par défaut ( [0:5, 1:15, 5:30, 10:60] )

  2. Marquage d’une lecture de video avec rafraîchissement dynamique

  3. Marquage de video avec thèmes (ancien chapitre)

  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’autres actions 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 de la vidéo live

  6. Marquage d’autres actions 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 audio
 

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’autres actions 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 média audio live

  6. Marquage d’autres actions 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 media
 

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’autres actions du 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 Medium.
  • remove : Supprime un medium live
  • removeAll : Supprime tous les media 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