Tracciare capitoli e segmenti su Android track-chapters-and-segments-on-android

Le istruzioni seguenti forniscono indicazioni per l’implementazione utilizzando gli SDK 2.x.

IMPORTANT
Se implementi una versione 1.x dell'SDK, puoi scaricare la Guida per gli sviluppatori qui: Scaricare gli SDK.

Implementare il tracciamento dei capitoli

  1. Identifica quando si verifica l’evento di inizio del capitolo e crea l’istanza ChapterObject utilizzando le informazioni sul capitolo.

    Riferimento di tracciamento dei capitoli ChapterObject:

    note note
    NOTE
    Queste variabili sono necessarie solo se intendi tenere traccia dei capitoli.
    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
    Nome variabile Descrizione Obbligatorio
    name Nome del capitolo
    position Posizione del capitolo
    length Durata capitolo
    startTime Ora di inizio capitolo

    Oggetto capitolo:

    code language-java
    MediaObject chapterDataInfo =
      MediaHeartbeat.createChapterObject(<CHAPTER_NAME>,
                                         <POSITION>,
                                         <LENGTH>,
                                         <START_TIME>);
    
  2. Se includi metadati personalizzati per il capitolo, crea le variabili di dati di contesto per i metadati:

    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. Per iniziare a tenere traccia della riproduzione del capitolo, chiama l’evento ChapterStart nell’istanza MediaHeartbeat.

    code language-java
    public void onChapterStart(Observable observable, Object data) {
        _heartbeat.trackEvent(MediaHeartbeat.Event.ChapterStart,
                              chapterDataInfo,
                              chapterMetadata);
    }
    
  4. Quando la riproduzione raggiunge il limite finale del capitolo, come definito dal codice personalizzato, chiama l’evento ChapterComplete nell’istanza MediaHeartbeat.

    code language-java
    public void onChapterComplete(Observable observable, Object data) {
        _heartbeat.trackEvent(MediaHeartbeat.Event.ChapterComplete, null, null);
    }
    
  5. Se la riproduzione del capitolo non è stata completata perché l’utente ha scelto di saltare il capitolo (ad esempio, se l’utente effettua una ricerca fuori dal limite del capitolo), chiama l’evento ChapterSkip nell’istanza MediaHeartbeat:

    code language-java
    public void onChapterSkip(Observable observable, Object data) {
        _heartbeat.trackEvent(MediaHeartbeat.Event.ChapterSkip, null, null);
    }
    
  6. Se ci sono capitoli aggiuntivi, ripeti i punti da 1 a 5.

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