Tracciare capitoli e segmenti in Roku track-chapters-and-segments-on-roku

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 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:

    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-none
    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:

    code language-none
    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.

    code language-none
    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.

    code language-none
    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.

    code language-none
    chapterContextData = {}
    ADBMobile().mediaTrackEvent(MEDIA_CHAPTER_SKIP, chapterInfo, chapterContextData)
    
  6. Se ci sono capitoli aggiuntivi, ripeti i punti da 1 a 5.

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