Intégration et options du lecteur

Ouvrez l’onglet Embed & share d’une vidéo pour obtenir son code d’intégration. Vérifiez d’abord que la vidéo peut être lue sur votre site : voir Only play on my allowed domains.

Types d’intégration

• Responsive : occupe toute la largeur de son conteneur en conservant les proportions de la vidéo. Convient à presque tous les sites.
• Fixed size : une largeur fixe (Width (px)).
• Web component : une balise <pellio-player> et un script. Il envoie automatiquement les événements vidéo à Google Analytics et Tag Manager, et dispose d’une API JavaScript. Voir API du lecteur.
• Popover : affiche la miniature de la vidéo avec un bouton de lecture (ou votre propre lien ou bouton) et ouvre le lecteur dans une visionneuse.

Options de lecture

Les interrupteurs sous le type d’intégration définissent la lecture de la vidéo partout où elle est intégrée : Background video (vidéo d’arrière-plan muette, en boucle, sans commandes, pour les sections d’en-tête), Autoplay, Start muted, Loop, Captions on by default, Show controls et Start at (seconds). Chaque changement est enregistré sur la vidéo et s’applique immédiatement à toutes les intégrations, y compris celles déjà présentes sur vos pages et les intégrations WordPress : le code d’intégration n’a jamais besoin de changer. La page de partage de la vidéo affiche toujours un lecteur standard.

Lecture automatique muette, son au clic : activez Autoplay (les navigateurs n’autorisent la lecture automatique qu’en mode muet) et laissez Background video désactivé. La vidéo démarre sans le son, avec un bouton Click for sound par-dessus ; un clic sur le bouton ou sur la vidéo active le son et la relance depuis le début, pour que personne ne manque l’introduction. Les commandes restent disponibles si Show controls est activé. La vidéo d’arrière-plan est différente : elle reste muette, tourne en boucle et n’a ni commandes ni bouton de son. Activer les commandes ou le son désactive le mode arrière-plan.

Pour qu’une intégration se comporte différemment, ajoutez des paramètres à l’URL de son lecteur, par exemple …/v/VIDEO_ID?autoplay=0. Un paramètre remplace le réglage enregistré pour cette intégration uniquement :

Option	Effet
autoplay=1	Lance la lecture au chargement. Si le navigateur bloque le son, le lecteur démarre en mode muet. La lecture automatique muette affiche un bouton « Click for sound ».
muted=1	Démarre en mode muet.
loop=1	Reprend depuis le début à la fin de la vidéo.
start=90	Démarre à un moment précis, en secondes (ignoré s’il tombe dans les derniers 5 % de la vidéo).
captions=1	Active la première piste de sous-titres.
controls=0	Masque les commandes. Désactive aussi les raccourcis clavier et la diffusion sur un téléviseur.
background=1	Vidéo d’arrière-plan : lecture automatique muette, en boucle, sans commandes ni logo.
color=%23e8492f	Remplace la couleur du lecteur pour cette intégration (couleur hexadécimale encodée pour URL).
resume=1	Reprend là où le spectateur s’était arrêté sur cet appareil, et sur tous ses appareils pour les utilisateurs connectés d’un site WordPress relié.
seeklock=1	Interdit d’avancer : les spectateurs ne peuvent se déplacer que dans la partie déjà regardée.
email=	Identifie le spectateur dans les statistiques par son adresse e-mail (encodée pour URL).
preset=	Utilise un préréglage de lecteur précis pour cette intégration (son identifiant).
nostore=1	Visionnages anonymes : rien n’est stocké sur l’appareil du spectateur, chaque visite compte donc comme un nouveau spectateur.
dnt=1	Ne pas suivre : aucune statistique pour cette intégration.

Ce que les spectateurs obtiennent

• Une vitesse de lecture de 0,5× à 2×, et un choix de Quality (Auto, 1080p, 720p, 360p) dans le menu des paramètres.
• Des aperçus de la vidéo lorsqu’ils survolent la barre de progression.
• Le mode image dans l’image et le plein écran, AirPlay sur les appareils Apple, et la diffusion sur un téléviseur avec Chromecast.
• Une Transcript (transcription) dans le menu des paramètres quand la vidéo a des sous-titres : un panneau de recherche qui saute au moment cliqué.
• Les chapitres, si vous en avez ajouté, et Download si vous autorisez le téléchargement (dans la carte Privacy).

L’apparence du lecteur (couleur, commandes, logo, filigrane) dépend de son préréglage de lecteur.

Raccourcis clavier

Espace ou k lance et met en pause, j et l reculent et avancent de 10 secondes, les flèches gauche et droite de 5 secondes, les flèches haut et bas règlent le volume, m coupe le son, c active ou désactive les sous-titres, f bascule en plein écran, 0 à 9 sautent de 0 à 90 % de la vidéo, < et > changent la vitesse, et Échap ferme le menu des paramètres.

Adresses des pages dans les statistiques

Les codes d’intégration Pellio incluent referrerpolicy="no-referrer-when-downgrade" afin que les navigateurs transmettent à Pellio l’adresse complète de la page où la vidéo est regardée (pour les rapports Top pages et UTM). Sans cela, les navigateurs n’envoient que le domaine du site.

Pages de partage

Chaque vidéo dispose d’une page de partage à l’adresse pellio.io/v/VIDEO_ID. Ajoutez ?start=SECONDS pour la faire démarrer à un moment précis. Seules les pages de partage des vidéos publiques sont visibles par les moteurs de recherche, avec des données structurées pour la vidéo, ses chapitres et sa transcription. Quand une vidéo a des sous-titres, la page affiche sa transcription, avec Search the transcript.

Collée dans un éditeur compatible oEmbed, comme Workover, une page de partage se transforme en lecteur, sauf pour les vidéos privées. Le lecteur ainsi créé respecte les règles de domaine de la vidéo, comme toute intégration.