En plus de pouvoir ajuster les paramètres d'intégration de votre vidéo sur place, vous pouvez ajouter des fonctionnalités au player Vimeo en ajoutant divers paramètres URL à la fin de l'URL du player dans votre code d'intégration.
Les paramètres URL commencent avec un point d'interrogation (?), Par exemple :
<iframe src="https://player.vimeo.com/video/76979871?embedparameter=value" width="640" height="360" frameborder="0" allowfullscreen></iframe>
Les paramètres URL ne s'appliquent qu'au code d'intégration spécifique où le paramètre est ajouté.
Paramètres du player pris en charge
Paramètre | Valeurs prises en charge | Valeur par défaut | Description | Vidéos prises en charge |
---|---|---|---|---|
autopause |
true , false Ou 1,0 |
true |
Le player Vimeo est conçu pour lire seulement une vidéo à la fois. Donc, vous aurez besoin d'ajouter ce paramètre à chaque vidéo si vous souhaitez avoir plus d'une vidéo de Vimeo en lecture sur la même page. ⚠️ Avertissements : - La fonctionnalité autopause n'est pas prise en charge dans Internet Explorer 11 et ses versions plus anciennes. - Pour que la fonctionnalité autopause fonctionne, vous devez autoriser les cookies dans votre navigateur. |
Toutes les vidéos |
autoplay |
true , false OU 1,0 |
false |
Commencer automatiquement la lecture de la vidéo ⚠️ Avertissement : La lecture automatique peut être bloquée dans certains environnements tels que IOS, Chrome 66+, et Safari 11+. Le cas échéant, nous repasserons à la lecture standard où les spectateurs doivent eux-même commencer la lecture. |
Toutes les vidéos |
background |
true , false OU 1,0 |
false |
Ajouter ce paramètre aura l'effet suivant :
Si vous préférez que votre vidéo ne soit pas en boucle ou en lecture automatique, consultez le paramètre controls=0 ci-dessous. Notez que le réglage de ce paramètre ne désactivera pas les commandes clavier. |
La vidéo doit être hébergée par un Compte Plus ou supérieur. |
byline |
true , false OU 1,0 |
Valeur spécifiée |
Montrer l'auteur de la vidéo (signature). |
Toutes les vidéos (mais seulement si le propriétaire de la vidéo le permet) |
color |
[hex code] |
Vimeo blue- |
Spécifier la couleur des contrôles vidéo. Les couleurs peuvent êtres annulées par les paramètres d'intégration de la vidéo. |
La vidéo doit être hébergée par un Compte Plus ou supérieur. |
controls |
true , false OU 1,0 |
true |
Ce paramètre permet de masquer tous les éléments du player (barre de lecture, boutons de partage, etc.) pour une expérience chromeless.
⚠️ Avertissements : Lorsque vous utilisez ce paramètre, le bouton lecture/pause est masqué. Pour lancer la lecture pour vos spectateurs, vous devez soit activer la lecture automatique, soit utiliser les commandes du clavier, soit exécuter notre player SDK pour démarrer et contrôler la lecture. Notez que le réglage de ce paramètre ne désactivera pas les commandes clavier. |
La vidéo doit être hébergée par un compte Plus ou supérieur. |
dnt |
true , false OU 1,0 |
false |
Si vous réglez ce paramètre sur « true », le lecteur ne pourra pas suivre les données de session, y compris tous les cookies et analyses. (Cette action aura le même effet que d'activer un paramètre Ne pas me pister dans votre navigateur.) |
Toutes les vidéos |
loop |
true , false OU 1,0 |
false |
Lire à nouveau la vidéo lorsqu'elle a fini de jouer, à l'infini. Remarque : La lecture en boucle peut aussi être choisie pour un écran de fin dans la page des paramètres d'intégration. En savoir plus ici. |
Toutes les vidéos |
muted |
true , false OU 1,0 |
false |
Paramétrer la vidéo en sourdine au chargement. Les spectateurs peuvent quand même ajuster les préférences de volume dans le player. Peut être utilisé pour les vidéos d'arrière-plan qui ne sont pas mises en sourdine, ou passer outre certaines limitations de lecture automatique dans certains navigateurs, tels que Chrome et Safari. |
Toutes les vidéos |
pip
|
true , false OU 1,0 |
false |
Afficher le bouton Incrustation dans la barre de contrôle et activer l'API d'incrustation. |
Toutes les vidéos |
playsinline |
true , false OU 1,0 |
true |
Lire une vidéo en lecture intégrée sur les appareils mobiles plutôt que de passer automatiquement en lecture plein écran. La lecture intégrée est activée pour toutes les vidéos par défaut. |
Toutes les vidéos |
portrait |
true , false OU 1,0 |
Valeur spécifiée |
Afficher l'image de profil de l'auteur (portrait) |
Toutes les vidéos (mais seulement si le propriétaire de la vidéo le permet) |
quality |
240p, 360p, 540p, 720p, 1080p, 2k, 4k |
auto |
Par défaut, le player Vimeo est paramétrée en mode "auto", ce qui signifie qu'il choisira la vidéo de la plus haute qualité possible selon la bande passante de l'utilisateur et d'autres facteurs de l'environnement de lecture. Le paramètre de qualité vous permet de spécifier la qualité de lecture par défaut de votre vidéo intégrée. Si vous sélectionnez une résolution qui n'existe pas pour la vidéo choisie, le paramètre de qualité sera ignoré et la vidéo intégrée lue en mode Auto. ⚠️ Avertissements : - Ce paramètre n'est pas pris en charge sur les appareils mobiles ou les tablettes. - Veuillez faire preuve de prudence lors de la mise en œuvre de ce paramètre. Le fait de choisir par défaut une qualité supérieure (comme 4K) peut entraîner une mise en mémoire tampon excessive et une lecture hachée pour vos spectateurs. - Ce paramètre n'est pris en charge que pour les vidéos en ligne et les événements archivés qui sont intégrés. Il n'est pas pris en charge pour les événements en direct. |
La vidéo doit être hébergée par un Compte Plus ou supérieur. |
speed |
true , false OU 1,0 |
false |
Afficher les contrôles de vitesse dans le menu préférences du player et activer l'API de la vitesse de lecture. (en savoir plus sur l'API de notre playerici) |
La vidéo doit être hébergée par un Compte Pro ou supérieur. |
#t |
Le temps affiché en minutes et/ou secondes (par exemple, #t=1m2s) |
Début de la vidéo |
Sert à lancer automatiquement la lecture à un moment précis. Pour en savoir plus, consultez cette page. Remarque : Ce paramètre ne requiert pas un préfixe en point d'interrogation, ce qui est le cas pour tous les autres. |
Toutes les vidéos |
texttrack |
Code de langue en minuscules et, éventuellement, paramètre régional et type de piste texte. (Par ex. : "en", "en-US", "en.captions", "en.subtitles") |
false |
Affiche une piste cc/sous-titres par défaut dans le lecteur (en attendant que la piste cc/sous-titres soit disponible).
Si vous saisissez une préférence de langue qui n'a pas encore été téléchargée pour votre vidéo, le paramètre de piste de texte sera ignoré et votre vidéo intégrée pourra être mise en ligne avec CC ou sous-titres désactivés par défaut. |
Toutes les vidéos avec des sous-titres ou des légendes disponibles (remarque : les sous-titres et les légendes doivent être importés par le propriétaire de la vidéo) |
title |
true , false OU 1,0 |
Valeur spécifiée |
Afficher le titre de la vidéo. |
Toutes les vidéos (mais seulement si le propriétaire de la vidéo le permet) |
transparent |
true , false OU 1,0 |
true |
Par défaut, l'arrière-plan de l'iframe du player est transparente sur Vimeo. Lorsqu'il est désactivé, l'arrière-plan de l'iframe sera noir. Des barres noires seront appliquées au player lorsque les dimensions de hauteur et de largeur du player intégré ne correspondent pas au rapport d'aspect original d'une vidéo-- par ex., les dimensions de l'iframe sont paramétrées au format carré 4/3, mais la vidéo originale est de largeur 16/9. |
Toutes les vidéos |
Utiliser plusieurs paramètres d'intégration
Si vous ajoutez de multiples paramètres au même code d'intégration, vous devrez les séparer par des sigles "&". Par exemple :
<iframesrc="https://player.vimeo.com/video/76979871?autoplay=1&loop=1&muted=1" width="640" height="360" frameborder="0"webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>
Appliquer des paramètres d'intégration à l'URL Vimeo.com
Si vous utilisez une application qui vous demande d'insérer un URL Vimeo.com (par ex. https://vimeo.com/
Par exemple, cette méthode n'est pas prise en charge :
https://vimeo.com/76979871?
Mais cela est pris en charge :
<iframe src="https://player.vimeo.com/
Des exemples d'applications ne prenant en charge seulement les URLs de Vimeo incluent les publications sur les réseaux sociaux, les thèmes et plug-ins de Wordpress, les plug-ins de Wix et Squarespace, et divers autres outils d'intégration vidéo de constructeurs de site Web.La bonne nouvelle, c'est que certains outils peuvent vous permettre d'ajuster les préférences du player ( , par exemple, la lecture automatique) directement dans leur propre interface utilisateur.