Show Menu
ARGOMENTI×

Tracciare capitoli e segmenti su Android

Le istruzioni seguenti forniscono indicazioni per l’implementazione mediante gli SDK 2.x. Se stai implementando una versione 1.x dell’SDK, puoi scaricare la Guida per gli sviluppatori qui: Scaricare gli SDK.

Implementare il tracciamento dei capitoli

  1. Identificare il momento in cui si verifica l’evento di inizio del capitolo e creare l’ ChapterObject istanza utilizzando le informazioni sul capitolo.
    ChapterObject riferimento tracciamento capitoli:
    Queste variabili sono necessarie solo se si prevede di tenere traccia dei capitoli.
    Nome della variabile
    Descrizione
    Obbligatorio
    name
    Nome del capitolo
    position
    Posizione del capitolo
    length
    Lunghezza capitolo
    startTime
    Ora inizio capitolo
    Oggetto Chapter:
    MediaObject chapterDataInfo =  
      MediaHeartbeat.createChapterObject(<CHAPTER_NAME>,  
                                         <POSITION>,  
                                         <LENGTH>,  
                                         <START_TIME>);
    
    
  2. Se includete metadati personalizzati per il capitolo, create 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 monitorare la riproduzione dei capitoli, chiamate l’ ChapterStart evento nell’ MediaHeartbeat istanza:
    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, chiamate l’ ChapterComplete evento nell’ MediaHeartbeat istanza:
    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 di uscire dal limite del capitolo), chiamate l’ ChapterSkip evento nell’istanza MediaHeartbeat:
    public void onChapterSkip(Observable observable, Object data) {  
        _heartbeat.trackEvent(MediaHeartbeat.Event.ChapterSkip, null, null); 
    }
    
    
  6. Se sono presenti altri capitoli, ripetete i punti da 1 a 5.