Google for Developers

Cette page présente les fonctions de l'API Player YouTube. La taille de la fenêtre d'affichage des lecteurs intégrés doit être de 200 x 200 pixels minimum. Si les commandes sont définies pour s'afficher, le lecteur doit être assez grand pour les afficher sans réduire la fenêtre d'affichage en deçà de sa taille minimale. Les dimensions recommandées des lecteurs 16:9 sont de 480 pixels de large et de 270 pixels de haut.

Code d'intégration iFrame

Remarque : Le code d'intégration ci-dessus reflète les paramètres de contenu définis pour list ou playlist dans le formulaire des paramètres du lecteur. Vous devez supprimer ces valeurs si vous souhaitez que le code d'intégration utilise le contenu spécifié dans le formulaire Commandes du lecteur.

Contenu Vous pouvez choisir de charger ou d'ajouter à la file d'attente des contenus dans le lecteur. Si vous sélectionnez l'option permettant de charger du contenu, puis actualisez le lecteur, alors celui-ci lit le contenu spécifié au lieu de la vidéo, le cas échéant, déjà en cours de lecture. Si vous sélectionnez l'option pour ajouter à la file d'attente du contenu, puis actualisez le lecteur, alors celui-ci charge la vidéo, mais ne lance pas sa lecture. Pour lire la vidéo, vous devez cliquer sur le lien Lire dans la section des commandes du lecteur ou directement sur le lecteur vidéo. Selon l'option sélectionnée, la page appelle l'une des fonctions de l'API suivantes : loadVideoById loadVideoByUrl loadPlaylist cueVideoById cueVideoByUrl cuePlaylist	Début (nombre de secondes à partir du début de la vidéo) : Qualité recommandée :
Commandes Les commandes de cette section permettent de lire, de mettre en pause ou d'arrêter une vidéo. Pour atteindre un moment spécifique d'une vidéo, saisissez dans le champ Atteindre la valeur, en secondes, correspondant au temps à partir du début de la vidéo auquel la lecture doit être lancée.	Lire \| Mettre en pause \| Arrêter Atteindre : Précédente \| Suivante Accéder à (numéro d'index de la playlist) : Lire les vidéos en boucle : off\|on Lire les vidéos en mode aléatoire : lecture aléatoire \|
Volume Les commandes de désactivation et d'activation du son permettent de contrôler l'activation du son. Le champ Son activé/désactivé dans la section Données indique si le son du lecteur est coupé ou non. Vous pouvez régler le volume du lecteur en saisissant un nombre compris entre 0 et 100 dans le champ Régler le volume. Appuyez sur la touche de tabulation ou cliquez à l'extérieur du champ de saisie pour mettre à jour la valeur du volume.	Désactiver le son \| Activer le son Régler sur : (0-100) [ niveau actuel : --]
Qualité Utilisez ce menu déroulant pour appeler la fonction setPlaybackQuality() et modifier la qualité de la vidéo en cours de lecture. Lorsque vous modifiez la qualité, la lecture de la vidéo est interrompue, puis reprend depuis le début. Le champ Niveaux disponibles de la section Données répertorie les niveaux de qualité disponibles pour la vidéo. Si vous sélectionnez un niveau de qualité non disponible, YouTube sélectionne le niveau de qualité disponible le plus adapté. Par exemple, si vous choisissez le niveau de qualité faible, mais que les niveaux compatibles sont moyen et élevé, YouTube définit le niveau de qualité sur moyen.
Vitesse de lecture La vitesse de lecture détermine la vitesse à laquelle la vidéo est lue. La fonction `getAvailablePlaybackRates()` renvoie les vitesses de lecture disponibles pour la vidéo en cours. Dans cette démo, les vitesses de lecture disponibles s'affichent dans la section Données. La valeur `1` indique que la vidéo est lue à une vitesse normale.
Taille Cette section permet de modifier la taille du lecteur à l'aide de la fonction setSize(width, height). En général, cette fonction est utile uniquement dans les applications ActionScript. Dans une application JavaScript, le lecteur redimensionné est toujours inséré dans l'objet contenant le lecteur vidéo, même si cet objet est plus petit ou plus grand que le lecteur redimensionné.	Format : Dimensions : x 405
Historique Cette section appelle les fonctions getVideoUrl() et getEmbedCode() lorsque le lecteur est prêt à lire une vidéo. Ces fonctions sont appelées de nouveau si vous chargez une vidéo ou en ajoutez une à la file d'attente. Si vous appelez la fonction getVideoUrl() après qu'une vidéo a été lue pendant au moins 10 secondes, l'URL inclut un paramètre spécifiant le moment de la vidéo auquel le lecteur doit lancer la lecture.	(effacer) Erreurs Aucune pour l'instant. Événements et appels de fonctions Aucune pour l'instant.

Paramètres du lecteur

  • Case cochée = valeur 1 définie pour le paramètre
  • Case décochée = valeur 0 définie pour le paramètre
  • Utilisez le code d'intégration iFrame pour intégrer un lecteur avec les options sélectionnées.

Paramètre	Valeur
autoplay 1 : la lecture de la vidéo est lancée automatiquement lors du chargement du lecteur. 0 (par défaut) : la lecture de la vidéo n'est pas lancée automatiquement lors du chargement du lecteur.
cc_load_policy 1 : les sous-titres s'affichent par défaut, même si l'utilisateur les a désactivés. Le comportement par défaut correspond aux préférences définies par l'utilisateur.
color Ce paramètre détermine la couleur dans laquelle la barre de progression (qui indique la proportion de la vidéo déjà regardée) s'affiche dans le lecteur. La valeur par défaut est red (rouge).
controls 1 (par défaut) : les commandes du lecteur s'affichent. 0 : les commandes du lecteur ne s'affichent pas.
disablekb 1 : les raccourcis clavier permettant de contrôler le lecteur sont désactivés. 0 (par défaut) : les raccourcis clavier permettant de contrôler le lecteur sont activés. Ceux-ci sont les suivants : Barre d'espace : lecture/pause Flèche gauche : retour de quelques secondes dans la lecture de la vidéo Flèche droite : avance de quelques secondes dans la lecture de la vidéo Flèche vers le haut : augmentation du volume Flèche vers le bas : diminution du volume
enablejsapi 1 : l'API Player iFrame est activée pour le contrôle du lecteur. 0 (par défaut) : l'API n'est pas activée.
end Moment auquel le lecteur doit arrêter la lecture de la vidéo. La valeur doit être un entier positif et définit le nombre de secondes au bout desquelles le lecteur doit arrêter la lecture de la vidéo.
fs 1 (par défaut) : le lecteur présente un bouton permettant d'activer le mode plein écran. 0 : le lecteur ne présente pas ce bouton.
hl Ce paramètre permet de définir la langue de l'interface du lecteur. Sa valeur doit correspondre à un code de langue ISO 639-1 à deux lettres ou à un code de langue entièrement spécifié, tel que `fr` ou `fr-ca`. D'autres codes de langue, tels que les étiquettes d'identification de langues IETF (BCP 47), peuvent également fonctionner correctement. La langue de l'interface est appliquée aux info-bulles qui s'affichent dans le lecteur et à la piste de sous-titres par défaut.
iv_load_policy 1 (par défaut) : les annotations vidéo s'affichent. 3 : les annotations vidéo ne s'affichent pas.
list Associé au paramètre `list`, ce paramètre définit le contenu chargé dans le lecteur. playlist : la valeur du paramètre `list` spécifie l'ID d'une playlist YouTube. Assurez-vous que la valeur du paramètre commence par les lettres `PL`. search : la valeur du paramètre `list` spécifie les termes de la requête de recherche utilisés pour sélectionner le contenu à lire. user_uploads : la valeur du paramètre `list` définit la chaîne YouTube dont les vidéos mises en ligne sont chargées.
listType Associé au paramètre `list`, ce paramètre définit le contenu chargé dans le lecteur. search : la valeur du paramètre `list` spécifie les termes de la requête de recherche utilisés pour sélectionner le contenu à lire. user_uploads : la valeur du paramètre `list` définit la chaîne YouTube dont les vidéos mises en ligne sont chargées. playlist : le paramètre `list` spécifie l'ID d'une playlist YouTube. Assurez-vous que la valeur du paramètre commence par les lettres `PL`.
loop 1 : si le lecteur ne charge qu'une seule vidéo, la vidéo est lue indéfiniment. Si le lecteur charge une playlist, la playlist est lue dans son intégralité, puis la lecture reprend à partir de la première vidéo. 0 (par défaut) : la vidéo ou la playlist ne sont pas lues indéfiniment.
modestbranding 1 : le logo YouTube ne s'affiche pas dans la barre de commandes. Un texte ou un filigrane YouTube s'affichent tout de même lorsque l'utilisateur passe sa souris sur le lecteur. 0 : le logo YouTube s'affiche dans la barre de commandes du lecteur.
playlist Liste d'identifications vidéo séparées par une virgule à lire à la suite.
playsinline 1 : la lecture intégrée pour les objets `UIWebViews` créés avec la propriété `allowsInlineMediaPlayback` définie sur `TRUE` est activée. 0 (par défaut) : la lecture en mode plein écran est activée. Sachez que cette valeur par défaut est susceptible de changer.
start Moment auquel la lecture de la vidéo doit démarrer. La valeur doit être un entier positif. Elle correspond au moment (nombre de secondes depuis le début de la vidéo) auquel le lecteur doit lancer la lecture. Le lecteur recherche l'image clé la plus proche du moment spécifié, ou un peu avant.

Données

Durée : --:--
Position actuelle : --:--
État du lecteur : --
Nombre d'octets depuis le début : --
% de la vidéo chargé : --
Son (activé/désactivé) :
Vitesse de lecture : --
Vitesses disponibles :
Obsolète
Nombre d'octets chargés : --
Nombre total d'octets : --