DocumentationAnalyticsGuide des services des médias en streaming

Suivre les chapitres et les segments sur Android track-chapters-and-segments-on-android

Last update: Mon Jul 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Utilisateur ou utilisatrice
  • Administration
  • Développeur

Les instructions suivantes fournissent des conseils pour la mise en œuvre à l’aide des kits SDK 2.x.

IMPORTANT
Si vous mettez en œuvre une version 1.x du kit SDK, vous pouvez télécharger le Guide du développeur dans la rubrique Téléchargement des SDK.

Mise en œuvre du suivi des chapitres

  1. Identifiez le moment où a lieu l’événement de début de chapitre et créez l’instance ChapterObject à l’aide des informations de chapitre.

    ChapterObject référence de suivi de chapitre :

    note note
    NOTE
    Ces variables ne sont nécessaires que si vous envisagez d’effectuer le suivi des chapitres.
    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center
    Nom de variable Description Obligatoire
    name Nom du chapitre Oui
    position Position du chapitre Oui
    length Durée du chapitre Oui
    startTime Heure de début du chapitre Oui

    Objet de chapitre :

    code language-java 
    MediaObject chapterDataInfo =
  MediaHeartbeat.createChapterObject(<CHAPTER_NAME>,
                                     <POSITION>,
                                     <LENGTH>,
                                     <START_TIME>);

  2. Si vous incluez des métadonnées personnalisées pour le chapitre, créez les variables de données contextuelles pour les métadonnées :

    code language-java 
    HashMap<String, String> chapterMetadata =
  new HashMap<String,String>();
chapterMetadata.put("segmentType", "Sample Segment Type");
chapterMetadata.put("segmentName", "Sample Segment Name");
chapterMetadata.put("segmentInfo", "Sample Segment Info");

  3. Pour lancer le suivi de la lecture du chapitre, appelez l’événement ChapterStart dans l’instance MediaHeartbeat :

    code language-java 
    public void onChapterStart(Observable observable, Object data) {
    _heartbeat.trackEvent(MediaHeartbeat.Event.ChapterStart,
                          chapterDataInfo,
                          chapterMetadata);
}

  4. Lorsque la lecture atteint la limite de fin du chapitre, comme défini par votre code personnalisé, appelez l’événement ChapterComplete dans l’instance MediaHeartbeat :

    code language-java 
    public void onChapterComplete(Observable observable, Object data) {
    _heartbeat.trackEvent(MediaHeartbeat.Event.ChapterComplete, null, null);
}

  5. Si la lecture du chapitre ne s’est pas terminée car l’utilisateur a choisi d’ignorer le chapitre (par exemple, si l’utilisateur effectue une recherche en dehors de la limite du chapitre), appelez l’événement ChapterSkip dans l’instance MediaHeartbeat :

    code language-java 
    public void onChapterSkip(Observable observable, Object data) {
    _heartbeat.trackEvent(MediaHeartbeat.Event.ChapterSkip, null, null);
}

  6. S’il existe d’autres chapitres, répétez les étapes 1 à 5.

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb