À propos des paramètres du lecteur – Centre d'aide

En plus d'ajuster les paramètres d'intégration de votre vidéo sur site, vous pouvez ajouter des fonctionnalités au 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 (?).

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

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
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 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 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 ⚠️ Attention : la lecture automatique peut être bloquée dans certains environnements, tels qu'iOS, Chrome 66+ et Safari 11+. Dans ce cas, nous reviendrons à la lecture standard, obligeant les spectateurs à lancer la lecture.	Toutes les vidéos
background	true , false OU 1,0	false	Ajouter ce paramètre aura l'effet suivant : Tous les éléments et boutons de basculement du player seront éteints (y compris le bouton play/pause) La vidéo sera automatiquement lue en boucle La vidéo sera en lecture automatique La vidéo sera mise en sourdine Si vous préférez que votre vidéo ne soit pas en boucle ou lue automatiquement, consultez le paramètrecontrols=0 ci-dessous. Notez que la définition de ce paramètre ne désactivera 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.
byline	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'auteur de la vidéo (byline).	Toutes les vidéos (mais seulement si le propriétaire de la vidéo le permet)
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.	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	Ce paramètre masquera tous les éléments du lecteur (barre de lecture, boutons de partage, etc.) pour une expérience sans chrome. ⚠️ Avertissements : Lorsque vous utilisez ce paramètre, le bouton lecture/pause est masqué. Pour lancer la lecture pour vos spectateurs, vous devrez activer la lecture automatique, utiliser les commandes du clavier ou implémenter notre SDK de lecteur pour démarrer et contrôler la lecture. Notez que la définition de ce paramètre ne désactivera 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êchera le joueur de 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). ⚠️ Attention : Lorsque DNT est activé, certains cookies essentiels restent définis. Vous pouvez trouver une liste de ces cookies ici.	Toutes les vidéos
qualité_initiale	240p, 360p, 540p, 720p, 1080p, 2k, 4k	auto	La qualité vidéo est utilisée pendant les premières secondes de lecture, avant que le streaming à débit binaire adaptatif ne prenne le relais. Définir une qualité inférieure (par exemple, 360p) peut aider les vidéos à démarrer plus rapidement, tandis qu'une qualité supérieure (par exemple, 1080p ou 4K) garantit une haute résolution dès le départ. Les valeurs acceptables incluent toute option de qualité disponible dans le menu du lecteur, telle que 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.
keyboard	vrai, faux OU 1, 0	true	Permet la saisie au clavier pour déclencher des événements de joueur. Si faux, le joueur ignorera la saisie au clavier. La tabulation sera toujours prise en charge dans les deux modes.	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 : L'option de 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 possible vers laquelle le lecteur bascule automatiquement pendant la lecture vidéo. Le joueur détermine la meilleure qualité à laquelle jouer sans dépasser cette valeur maximale. La définition de ce paramètre peut aider à réduire l’utilisation de la bande passante. Ce champ peut prendre n'importe quelle valeur du menu de qualité du lecteur pour la vidéo. Les valeurs courantes sont 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 possible vers laquelle le lecteur bascule automatiquement pendant la lecture vidéo. Le joueur détermine la meilleure qualité à laquelle jouer sans descendre en dessous de cette valeur minimale. La définition de ce paramètre garantit que le spectateur reçoit une vidéo haute résolution tout en tenant compte de la bande passante. Ce champ peut prendre n'importe quelle valeur du menu de qualité du lecteur pour la vidéo. Les valeurs courantes sont 360p, 720p, 1080p, 2k ou 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.	Toutes les vidéos
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 (mais seulement si le propriétaire de la vidéo le permet)
précharge	métadonnées, métadonnées_au_survol, auto, auto_au_survol, aucun	métadonnées_ au_survol	Le comportement de chargement du lecteur avant le lancement de la lecture. Cela suit les principes de base de la propriété de préchargement native (https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/preload) de l'interface HTMLMediaElement, avec quelques valeurs supplémentaires : - Spécifiez « metadata » pour charger les métadonnées immédiatement. - Spécifiez « metadata_on_hover » pour charger les métadonnées de la vidéo uniquement lorsque l'utilisateur survole le lecteur. - Spécifiez « auto » pour charger immédiatement les métadonnées et les premières secondes de la vidéo. - Spécifiez « auto_on_hover » pour charger les métadonnées et les premières secondes de la vidéo uniquement lorsque l'utilisateur survole le lecteur. - Spécifiez « aucun » si vous ne chargez aucune donnée jusqu'au début de la lecture. Le préchargement de plus de données accélère le démarrage de la lecture. Par conséquent, l'utilisation des valeurs « auto » et « auto_on_hover » entraîne un démarrage plus rapide que les autres options, mais peut utiliser plus de bande passante puisque les segments vidéo sont chargés indépendamment de la façon dont l'utilisateur lit la vidéo. Pour en savoir plus sur les limites de bande passante de Vimeo, visitez notre centre d'aide (https://help.vimeo.com/hc/en-us/articles/12426275404305-Bandwidth-on-Vimeo).	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 sélectionne la meilleure qualité vidéo possible, en tenant compte de la bande passante du spectateur et d'autres facteurs dans 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 : - 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 est uniquement pris en charge pour les vidéos téléchargées 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.
sauter_en_avant	vrai, faux OU 1,0	true	Si les utilisateurs peuvent avancer rapidement dans le lecteur intégrable	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 commandes 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 ». 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 entrez une préférence de langue qui n'a pas encore été téléchargée pour votre vidéo particulière, le paramètre de piste de texte sera ignoré et votre vidéo intégrée peut se charger avec les sous-titres (CC) 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 (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 lecteur sur Vimeo est transparent. 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.

Paramètres du player pris en charge

Articles associés