Les instructions suivantes fournissent des conseils pour la mise en œuvre à l’aide des kits SDK 2.x.
Si vous mettez en œuvre une version 1.x du kit SDK, vous pouvez télécharger le Guide du développeur dans la rubrique Téléchargement des SDK.
Identifiez le moment où a lieu l’événement de début de chapitre et créez l’instance ChapterObject
à l’aide des informations de chapitre.
ChapterObject
référence de suivi de chapitre :
Ces variables ne sont nécessaires que si vous envisagez d’effectuer le suivi des chapitres.
Nom de variable | Description | Obligatoire |
---|---|---|
name |
Nom du chapitre | Oui |
position |
Position du chapitre | Oui |
length |
Durée du chapitre | Oui |
startTime |
Heure de début du chapitre | Oui |
Objet de chapitre :
chapterInfo =
adb_media_init_chapterinfo(<CHAPTER_NAME>,
<POSITION>,
<LENGTH>,
<START_TIME>);)
Si vous incluez des métadonnées personnalisées pour le chapitre, créez les variables de données contextuelles pour les métadonnées :
chapterContextData = {}
chapterContextData["seg_type"] = "seg_type"
chapterContextData["seg_name"] = "seg_name"
chapterContextData["seg_info"] = "seg_info"
Pour lancer le suivi de la lecture du chapitre, appelez l’événement ChapterStart
dans l’instance MediaHeartbeat
:
ADBMobile().mediaTrackEvent(MEDIA_CHAPTER_START, chapterInfo, chapterContextData)
Lorsque la lecture atteint la limite de fin du chapitre, comme défini par votre code personnalisé, appelez l’événement ChapterComplete
dans l’instance MediaHeartbeat
.
chapterContextData = {}
ADBMobile().mediaTrackEvent(MEDIA_CHAPTER_COMPLETE, chapterInfo, chapterContextData)
Si la lecture du chapitre ne s’est pas terminée car l’utilisateur a choisi d’ignorer le chapitre (par exemple, si l’utilisateur effectue une recherche en dehors de la limite du chapitre), appelez l’événement ChapterSkip
dans l’instance MediaHeartbeat.
chapterContextData = {}
ADBMobile().mediaTrackEvent(MEDIA_CHAPTER_SKIP, chapterInfo, chapterContextData)
S’il existe d’autres chapitres, répétez les étapes 1 à 5.