API du lecteur et intégrations

Ce que vous pouvez faire

• Intégrer en mode adaptatif, en taille fixe, dans une visionneuse en fenêtre contextuelle ou avec le composant web <pellio-player>.
• Appeler play(), pause(), seek(seconds), mute(), volume(), rate() et identify(email).
• Écouter des événements comme play, progress, complete, lead, chapter et interaction.
• Définir des options dans l’URL du lecteur, comme autoplay, start, captions, background, resume, seeklock et dnt.

Mise en place

1. Ouvrez une vidéo dans Pellio et allez dans son onglet Embed & share.
2. Choisissez Web component, ou Responsive pour une iframe, et réglez les options de lecture.
3. Copiez le code dans votre page. Pour le composant web, il ressemble à <script src="https://play.pellio.io/assets/embed.js" async></script> plus <pellio-player video="VIDEO_ID"></pellio-player>.
4. Écoutez les événements sur l’élément, par exemple player.addEventListener('pellio:progress', …).
5. Avec une iframe, envoyez des commandes avec postMessage({ pellio: true, method: 'play' }, '*') et écoutez les événements message du lecteur.

Bon à savoir

• Le composant web se charge lorsqu’il apparaît à l’écran. Ajoutez eager pour le charger immédiatement.
• Il envoie aussi automatiquement les événements vidéo à Google Analytics et Tag Manager.
• L’événement progress correspond à la position de la tête de lecture, pas aux secondes uniques regardées.
• Utilisez identify ou l’option email= pour identifier les spectateurs dans les statistiques et leur éviter les formulaires d’e-mail.
• Vérifiez d’abord que la vidéo peut être lue sur votre domaine : voir Only play on my allowed domains.

Guides complets : API du lecteur et Intégration et options du lecteur.