L'article explique comment personnaliser le lecteur Vimeo en utilisant des paramètres d'URL dans le code d'intégration pour ajouter des fonctionnalités spécifiques à cette vidéo.
Outre le réglage des paramètres d'intégration de votre vidéo sur le site, vous pouvez également améliorer les fonctionnalités du lecteur Vimeo en ajoutant divers paramètres d'URL à la fin de l'URL du lecteur dans votre code d'intégration.
Lesparamètres d'URL commencent par un point d'interrogation (?).
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
Veuillez vous référer au tableau ci-dessous pour un résumé des paramètres de lecteur pris en charge.
Paramètre | Valeurs prises en charge | Valeur par défaut | Description | Vidéos prises en charge |
AirPlay |
true , false OU 1,0 |
true | Si AirPlay est activé. | La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. ⚠️Remarque : AirPlay n’est pris en charge que sur Safari. |
ask_ai | autopause | true | Si la fonctionnalité Ask AI est activée. | Vidéos hébergées par un compte Entreprise éligibles à la fonctionnalité Ask AI. |
piste audio |
true , false OU 1,0 |
true | Si le menu audio apparaît. | La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. |
piste audio |
un code de langue en minuscules, ou « principal » si vous souhaitez que la vidéo soit par défaut sur la piste audio principale
|
false | Affiche une piste audio donnée par défaut dans le lecteur (en attendant que la piste audio soit disponible) | Toutes les vidéos où plusieurs pistes audio ont été téléchargées |
autopause |
true , false OU 1,0 |
true |
Le lecteur Vimeo ne lit qu'une seule vidéo à la fois. Pour avoir plusieurs vidéos sur la même page, vous devez ajouter un paramètre spécifique à chacune d'elles. ⚠️ Remarque : pour que la mise en pause automatique fonctionne, vous devez avoir les cookies activés dans votre navigateur. |
Toutes les vidéos |
autoplay |
true , false OU 1,0 |
false | Commencer automatiquement la lecture de la vidéo | Toutes les vidéos |
background |
true , false OU 1,0 |
false |
L'ajout de ce paramètre entraînera :
Pour éviter la boucle ou la lecture automatique, utilisez le paramètre controls=0. La définition de ce paramètre ne désactivera pasles commandes du clavier. |
La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. |
Badge |
true , false OU 1,0 |
true | Afficher le badge de la vidéo (par exemple (Badge de sélection du personnel). | Toutes les vidéos |
byline |
true , false OU 1,0 |
Valeur spécifiée dans les paramètres d'intégration de la vidéo sur le site |
Montrer l'auteur de la vidéo (signature). | Toutes les vidéos |
CC |
true , false OU 1,0 |
true | Si le bouton de sous-titres est activé. | La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. |
Chapitres |
true , false OU 1,0 |
true | Si le bouton des chapitres apparaît. | La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. |
Chromecast |
true , false OU 1,0 |
true | Si le bouton Chromecast apparaît. |
La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. ⚠️Remarque : Chromecast n'est pas pris en charge sur iOS |
color | [hex code] | Vimeo bleu- 00adef |
Spécifiez la couleur des commandes vidéo. Les couleurs peuvent être remplacées par les paramètres intégrés de la vidéo. Si la couleur n'est pas définie via un paramètre ou un réglage, le paramètretransparent s'activera. |
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 Couleur 2 - Accent : #00adef Couleur 3 - Icône et texte : #ffffff Couleur 4 - Arrière-plan : #000000 |
Spécifiez les couleurs du lecteur. Les couleurs peuvent être remplacées par les paramètres intégrés de la vidéo. |
La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. |
Contrôles |
true , false OU 1,0 |
true | Masque ou révèle tous les éléments du lecteur, tels que la barre de lecture et les boutons de partage, pour créer une expérience sans chrome. Remarque : lorsqu'il est activé, le bouton lecture/pause est masqué. Les spectateurs doivent utiliser la lecture automatique, les commandes du clavier ou notre SDK de lecteur pour démarrer et contrôler la lecture. Ce paramètre ne désactive pas les commandes du 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 |
La définition de ce paramètre sur « true » empêche le joueur de collecter des données de session et des analyses, de la même manière que l'activation d'une fonction « Ne pas suivre » dans votre navigateur. ⚠️ Remarque : lorsque DNT est actif, certains cookies essentiels seront toujours actifs. Visitez Vimeo Player Cookies pour voir cette liste. |
Toutes les vidéos |
Plein écran |
true , false OU 1,0 |
true | Si le bouton plein écran apparaît. | La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. |
qualité_initiale | 240p, 360p, 540p, 720p, 1080p, 2k, 4k | auto |
La qualité vidéo initiale, affichée brièvement avant le début du streaming adaptatif. Ceci est réglable pour un chargement plus rapide ou une meilleure clarté. Une qualité inférieure, comme 360p, se charge plus rapidement ; une qualité supérieure, comme 1080p ou 4K, offre une meilleure résolution immédiatement. |
La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. |
paramètres_interactifs | Paires clé-valeur séparées par des virgules | Aucun | Paires clé-valeur représentant des paramètres dynamiques utilisés sur des vidéos interactives avec des éléments dynamiques, tels que title=my-video , subtitle=interactive | Vidéos interactives |
marqueurs_interactifs |
true , false OU 1,0 |
true | S'il faut afficher des marqueurs représentant l'horodatage où les points d'accès apparaissent sur une vidéo interactive. | Vidéos interactives |
keyboard |
true , false OU 1,0 |
true | Permet aux saisies du clavier de déclencher des événements dans le player. Si la valeur est « false », le player ignorera la saisie du clavier. La fonction de tabulation sera toujours prise en charge, quel que soit le 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. 💡Astuce : L'optionde boucle peut également être sélectionnée comme écran de fin d'une vidéo dans les paramètres d'intégration. Pour en savoir plus, consultez la page À propos des écrans de fin. |
Toutes les vidéos |
qualité_max | 240p, 360p, 540p, 720p, 1080p, 2k, 4k | auto |
La qualité la plus élevée que le lecteur sélectionnera automatiquement pendant la lecture vidéo. Le joueur choisit la meilleure qualité jusqu'à cette valeur sans la dépasser. Ce paramètre peut aider à réduire la consommation de bande passante. Vous pouvez sélectionner n'importe quelle valeur dans le menu de qualité du lecteur vidéo, notamment 360p, 720p, 1080p, 2K et 4K. |
La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. |
qualité_min | 240p, 360p, 540p, 720p, 1080p, 2k, 4k | auto |
La qualité la plus basse vers laquelle le lecteur basculera automatiquement pendant la lecture vidéo. Le joueur sélectionne la qualité optimale sans pour autant descendre en dessous de ce seuil. La définition de ce paramètre permet de garantir que les spectateurs reçoivent une vidéo haute résolution tout en tenant compte des contraintes de bande passante. Vous pouvez sélectionner n'importe quelle option de qualité disponible dans le lecteur, notamment 360p, 720p, 1080p, 2K et 4K. |
La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. |
muted |
true , false OU 1,0 |
false |
Réglez la vidéo pour qu'elle soit muette au chargement. Les téléspectateurs peuvent toujours ajuster les préférences de volume dans le lecteur. Peut être utilisé pour réactiver le son des vidéos d'arrière-plan ou contourner les limitations de lecture automatique dans certains navigateurs, tels que Chrome et Safari. |
Toutes les vidéos |
pépin |
true , false OU 1,0 |
false | Afficher le bouton Incrustation dans la barre de contrôle et activer l'API d'incrustation. | La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise |
position_du_bouton_de_lecture | auto, bas ou centre | auto | Où le bouton de lecture est positionné sur le lecteur. Lorsque le mode est défini sur Auto, le bouton de lecture apparaît dans la barre de contrôle avant de se déplacer vers le centre du lecteur sur des points d'arrêt plus petits. | La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise |
playsinline |
true , false OU 1,0 |
true | Lisez la vidéo en ligne sur les appareils mobiles au lieu de passer automatiquement en mode plein écran. La lecture en ligne est activée par défaut pour toutes les vidéos. | Toutes les vidéos |
portrait |
true , false OU 1,0 |
Valeur spécifiée dans les paramètres d'intégration de la vidéo sur le site |
Afficher l'image de profil de l'auteur (portrait). | Toutes les vidéos |
précharge | métadonnées, métadonnées_au_survol, auto, auto_au_survol, aucun |
métadonnées_ au_survol |
Le comportement de chargement avant la lecture du lecteur s'aligne sur la propriété de préchargement native de l'interface HTMLMediaElement, avec quelques options supplémentaires :
Le préchargement de plus de données permet à la vidéo de démarrer plus rapidement. Par conséquent, « auto » et « auto_on_hover » conduisent à un démarrage plus rapide, mais ils nécessitent plus de bande passante puisque les segments vidéo se chargent, que l'utilisateur lise la vidéo ou non. Pour plus de détails sur les limites de bande passante de Vimeo, visitez Bande passante sur Vimeo. |
La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. |
barre de progression |
true , false OU 1,0 |
true | Si la barre de progression apparaît. | La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. |
quality | 240p, 360p, 540p, 720p, 1080p, 2k, 4k | auto |
Par défaut, le lecteur Vimeo est réglé sur le mode «Auto », ce qui signifie qu'il choisit la qualité vidéo la plus élevée possible en fonction de la bande passante du spectateur et d'autres facteurs dans l'environnement de lecture. La qualité vous permet de spécifier la résolution de lecture par défaut pour votre vidéo intégrée. Si vous sélectionnez une qualité qui n'est pas disponible, le paramètre sera ignoré et l'intégration sera définie par défaut sur Auto. 💡Conseil : choisir un paramètre de qualité supérieure (comme 4K) peut entraîner une mise en mémoire tampon excessive et une lecture saccadée pour les spectateurs. |
La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. Disponible pour les vidéos téléchargées et les événements archivés. Il ne prend pas en charge les événements en direct. |
sélecteur_de_qualité |
true , false OU 1,0 |
true | Si le menu de sélection de qualité apparaît. | La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. |
sauter_en_avant |
true , false OU 1,0 |
true | Si l'utilisateur est autorisé à avancer pendant la lecture. | 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 taux de lecture. (en savoir plus sur notre API de lecteur sur 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 (0m) |
Permet de démarrer automatiquement la lecture à un instant précis. Pour en savoir plus, consultez « Démarrer la lecture à un timecode spécifique ». 💡Astuce : ce paramètre ne nécessite pas de point d’interrogation préfixé comme tous les autres. |
Toutes les vidéos |
texttrack |
Un code de langue en minuscules et éventuellement les paramètres régionaux et le type de piste de texte. (Par ex. : "en", "en-US", "en.captions", "en.subtitles") |
false |
Affiche une piste cc/sous-titres spécifiée par défaut dans le lecteur, si disponible. Si vous sélectionnez 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 la vidéo intégrée peut se charger avec les légendes ou les sous-titres désactivés par défaut. |
Toutes les vidéos avec légendes ou sous-titres sont disponibles (Remarque : les légendes et les sous-titres doivent être téléchargés par le propriétaire de la vidéo. En savoir plus sur Légendes et sous-titres) |
thumbnail_id | L'ID de la miniature à charger à partir de l'ensemble de miniatures disponibles de la vidéo. | Aucun | Affiche l'ID de la miniature à charger à partir de l'ensemble de miniatures disponibles de la vidéo. | La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. |
title |
true , false OU 1,0 |
Valeur spécifiée dans les paramètres d'intégration de la vidéo sur le site |
Afficher le titre de la vidéo. | Toutes les vidéos |
transparent |
true , false OU 1,0 |
true |
Le paramètre transparent est actif si la couleur n'a pas été spécifiée via un paramètre ou un réglage. En règle générale, l'arrière-plan iframe du lecteur Vimeo est transparent par défaut. Si cette option est désactivée, l'arrière-plan deviendra noir. Des barres noires seront visibles sur le lecteur lorsque la hauteur et la largeur de l'iframe ne correspondent pas au rapport hauteur/largeur d'origine de la vidéo, par exemple en définissant l'iframe sur 4:3 alors que la vidéo d'origine est en 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. | La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. |
bouton de désactivation du son |
true , false OU 1,0 |
true | Si le bouton de désactivation du son apparaît. | La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. |
vimeo_logo |
true , false OU 1,0 |
true | Si le logo Vimeo apparaît. | La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. |
Volume |
true , false OU 1,0 |
true | Si le contrôle du volume apparaît. | La vidéo doit être hébergée par un compte Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Entreprise. |
regarder_la_vidéo_complète |
true , false OU 1,0 |
true | Si le bouton Regarder la vidéo complète apparaît sur les vidéos en mode de lecture segmentée. | Toutes les vidéos en mode de lecture segmentée. |