Tracciamento capitoli e segmenti su Android

Le istruzioni seguenti forniscono indicazioni per l'implementazione tramite SDK 2.x.

IMPORTANTE

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. Identificare quando si verifica l'evento di inizio del capitolo e creare l'istanza ChapterObject utilizzando le informazioni del capitolo.

    ChapterObject riferimento di tracciamento dei capitoli:

    NOTA

    Queste variabili sono necessarie solo se intendi tenere traccia dei capitoli.

    Nome variable Descrizione Obbligatorio
    name Nome del capitolo
    position Posizione del capitolo
    length Lunghezza del capitolo
    startTime Ora di inizio capitolo

    Oggetto capitolo:

    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:

    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:

    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, invoca l'evento ChapterComplete nell'istanza MediaHeartbeat:

    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 cerca fuori dal limite del capitolo), chiamare l'evento ChapterSkip nell'istanza MediaHeartbeat:

    public void onChapterSkip(Observable observable, Object data) {  
        _heartbeat.trackEvent(MediaHeartbeat.Event.ChapterSkip, null, null);
    }
    
  6. In caso di capitoli aggiuntivi, ripetere i punti da 1 a 5.

In questa pagina