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é.
Sommaire de l'article :
- Paramètres du player pris en charge
- Utiliser plusieurs paramètres d'intégration
- Appliquer des paramètres d'intégration à l'URL Vimeo.com
Paramètres du player pris en charge
Veuillez consulter le tableau ci-dessous pour un récapitulatif des paramètres de 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. - 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 Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. |
|
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écifiez la couleur des contrôles vidéo. |
La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. |
|
Couleurs
|
1-4 [codes hexagonaux] - séparés par des virgules. (Example: colors=000000,00adef, ffffff,000000) |
Couleur 1- Primaire : #000000 |
Spécifiez les couleurs du lecteur. Les couleurs peuvent être remplacées par les paramètres d'intégration de la vidéo. |
La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
|
Contrôles |
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 Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. |
|
dnt |
true , false OU 1,0 |
false |
Si vous attribuez à ce paramètre la valeur "true", le lecteur ne pourra pas suivre les données de session et les analyses. (Cela aura le même effet que d'activer un paramètre "Do Not Track" dans votre navigateur). ⚠️ Avertissements : Lorsque le DNT est activé, Vimeo déploie un cookie essentiel via le lecteur incorporable :
|
Toutes les vidéos |
|
keyboard |
true, false |
true |
Permet à la saisie au clavier de déclencher des événements pour le lecteur. Si elle est fausse, le lecteur ignorera la saisie au clavier. La navigation par onglets sera toujours possible dans l'un ou l'autre mode. |
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 : laboucle peut également être choisie comme écran de fin d'une vidéo dans la page des paramètres d'intégration. Pour en savoir plus ,cliquez 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 Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. |
|
speed |
true , false OU 1,0 |
false |
Affichez les contrôles de vitesse dans le menu des préférences du lecteur et activez l'API de vitesse de lecture. (Pour en savoir plus sur l'API de notre lecteur, consultez le site Vimeo Developer : API ) |
La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. |
|
#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 la page « Démarrer la lecture à un timecode spécifique ». 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. Pour en savoir plus, consultez la page Sous-titres et légendes.) |
|
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 |
|
Transcription |
true , false OU 1,0
|
true |
Affichez le bouton de transcription dans la barre de contrôle et activez les contrôles de transcription. |
Toutes les vidéos sont accompagnées de textes. |
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 oblige à insérer une URL Vimeo.com( par exemple 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/video/76979871?quality=720p" width="640" height="360" frameborder="0"
webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>
Des exemples d'applications 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.
Dépannage des paramètres du lecteur
Si vous rencontrez des difficultés pour ajouter un paramètre de lecteur, veuillez nous contacter pour obtenir de l'aide et fournir le code d'intégration que vous utilisez pour un dépannage plus rapide.