Tracciare capitoli e segmenti in Roku

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

Implementare metadati standard di annunci

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:

   NOTA

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

   Nome variabile	Descrizione	Obbligatorio
   name	Nome del capitolo	Sì
   position	Posizione del capitolo	Sì
   length	Durata capitolo	Sì
   startTime	Ora di inizio capitolo	Sì

   Oggetto capitolo:

   chapterInfo =
     adb_media_init_chapterinfo(<CHAPTER_NAME>,
                                <POSITION>,
                                <LENGTH>,
                                <START_TIME>);)
   

2. Se includi metadati personalizzati per il capitolo, crea le variabili di dati di contesto per i metadati:

   chapterContextData = {}
   chapterContextData["seg_type"] = "seg_type"
   chapterContextData["seg_name"] = "seg_name"
   chapterContextData["seg_info"] = "seg_info"
   

3. Per iniziare a tenere traccia della riproduzione del capitolo, chiama l’evento ChapterStart nell’istanza MediaHeartbeat.

   ADBMobile().mediaTrackEvent(MEDIA_CHAPTER_START, chapterInfo, chapterContextData)
   

4. Quando la riproduzione raggiunge il limite finale del capitolo, come definito dal codice personalizzato, chiama l’evento ChapterComplete nell’istanza MediaHeartbeat.

   chapterContextData = {}
   ADBMobile().mediaTrackEvent(MEDIA_CHAPTER_COMPLETE, chapterInfo, chapterContextData)
   

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), chiama l’evento ChapterSkip nell’istanza MediaHeartbeat.

   chapterContextData = {}
   ADBMobile().mediaTrackEvent(MEDIA_CHAPTER_SKIP, chapterInfo, chapterContextData)
   

6. Se ci sono capitoli aggiuntivi, ripeti i punti da 1 a 5.