Suivre la lecture principale sur iOS track-core-playback-on-ios

Configuration initiale du suivi

Déterminez le moment où l’utilisateur déclenche l’intention de lecture (l’utilisateur clique sur le bouton de lecture et/ou la lecture automatique est activée) et créez une instance MediaObject.

API createMediaObjectWithName

StreamTypeConstantes :

MediaTypeConstantes :

Format général pour la création de MediaObject :

ADBMediaObject *mediaObject =
  [ADBMediaHeartbeat createMediaObjectWithName:<MEDIA_NAME>
                                       mediaId:<MEDIA_ID>
                                        length:<MEDIA_LENGTH>
                                    streamType:<STREAM_TYPE>
                                     mediaType: <MEDIA_TYPE>];

Ajout de métadonnées vidéo

Vous pouvez joindre des objets de métadonnées vidéo standard et/ou personnalisés à la session de suivi vidéo par le biais de variables de données contextuelles.

• Métadonnées vidéo standard

  • Mise en œuvre de métadonnées standard sur iOS

  • Clés de métadonnées vidéo
    Clés de métadonnées iOS

  • Consultez la liste complète des métadonnées vidéo dans la rubrique Paramètres audio et vidéo.

  note note
  NOTE
  Il est facultatif de joindre un objet de métadonnées vidéo standard à l’objet multimédia.

• Métadonnées personnalisées

  Créez un objet de variable pour les variables personnalisées et renseignez les données de cette vidéo. Par exemple :

  code language-none
  NSMutableDictionary *videoMetadata = [[NSMutableDictionary alloc] init]; [videoMetadata setObject:@"false" forKey:@"isUserLoggedIn"]; [videoMetadata setObject:@"Sample TV station" forKey:@"tvStation"];

Suivi de l’intention de démarrer la lecture

Pour commencer le suivi d’une session multimédia, appelez trackSessionStart sur l’instance Media Heartbeat.

- (void)onMainVideoLoaded:(NSNotification *)notification {
//    [_mediaHeartbeat trackSessionStart:mediaObject data:nil];
    [_mediaHeartbeat trackSessionStart:mediaObject data:videoMetadata];
}

Suivi du début réel de la lecture

Identifiez l’événement du lecteur vidéo correspondant au début de la lecture vidéo, où la première image de la vidéo s’affiche à l’écran, et appelez trackPlay :

- (void)onVideoPlay:(NSNotification *)notification {
    [_mediaHeartbeat trackPlay];
}

Suivi de la fin de la lecture

Identifiez l’événement du lecteur vidéo correspondant à la fin de la lecture vidéo, où l’utilisateur a visionné le contenu jusqu’à la fin, et appelez trackComplete :

- (void)onVideoComplete:(NSNotification *)notification {
    [_mediaHeartbeat trackComplete];
}

Suivi de la fin de la session

Identifiez l’événement du lecteur vidéo correspondant au déchargement/à la fermeture de la lecture vidéo, où l’utilisateur ferme la vidéo et/ou la vidéo est terminée et déchargée, et appelez trackSessionEnd :

- void)onMainVideoUnloaded:(NSNotification *)notification {
    [_mediaHeartbeat trackSessionEnd];
}

Suivi de tous les scénarios de mise en pause possibles

Identifiez l’événement du lecteur vidéo correspondant à l’interruption de la vidéo et appelez trackPause :

- (void)onVideoPause:(NSNotification *)notification {
    [_mediaHeartbeat trackPause];
}

Scénarios de mise en pause

Identifiez tous les scénarios dans lesquels le lecteur vidéo sera interrompu et assurez-vous que trackPause est correctement appelé. Les scénarios suivants exigent tous que votre application appelle trackPause() :

• L’utilisateur appuie délibérément sur pause dans l’application.
• Le lecteur se met en pause.
• (Applications mobiles) : l’utilisateur place l’application en arrière-plan, mais vous souhaitez que l’application conserve la session ouverte.
• (Applications mobiles) : tout type d’interruption système qui entraîne la mise en arrière-plan d’une application. Par exemple, l’utilisateur reçoit un appel ou une fenêtre contextuelle d’une autre application apparaît, mais vous souhaitez que l’application maintienne la session active afin que l’utilisateur ait l’opportunité de reprendre la vidéo à partir du point d’interruption.

Identifiez l’événement du lecteur correspondant à la lecture vidéo et/ou à la reprise vidéo après une interruption et appelez trackPlay :

- (void)onVideoPlay:(NSNotification *)notification {
    [_mediaHeartbeat trackPlay];
}