En esta página se muestran las funciones de la API del reproductor de YouTube. Los reproductores insertados deben tener una ventana gráfica de al menos 200px por 200px. Si el reproductor muestra controles, debe tener el tamaño suficiente para mostrar los controles por complete, sin reducir la ventana gráfica por debajo del tamaño mínimo. Recomendamos que los reproductores de 16:9 tengan al menos 480 píxeles de ancho y 270 píxeles de alto.

Código de incorporación de IFrame

Contenido Puedes cargar o posicionar contenido en el reproductor. Si seleccionas una opción para cargar contenido y actualizas el reproductor, este mostrará el contenido especificado en lugar de cualquier video que se esté reproduciendo (si los hay).

Si seleccionas una opción para posicionar contenido y actualizas el reproductor, este carga el video, pero no lo reproduce. Para hacerlo, debes hacer clic en el vínculo Reproducir que se encuentra en la sección de controles del reproductor o en el mismo reproductor.

Según la selección que realices, la página invoca una de las siguientes funciones de la API:
  • loadVideoById
  • loadVideoByUrl
  • loadPlaylist
  • cueVideoById
  • cueVideoByUrl
  • cuePlaylist

 
Controles Los controles de esta sección te permiten reproducir, pausar o parar un video.

Para ir a un punto específico del video, ingresa un número en el campo Ir a, el cual especifica el tiempo de desfase, en segundos (desde el comienzo del video), en el que debe comenzar la reproducción.
   
Volumen Los controles Silenciar y Activar sonido te permiten habilitar o inhabilitar el volumen. El campo Encender/apagar volumen de la sección Estadísticas indica si el reproductor está en silencio.

Puedes ajustar el volumen del reproductor ingresando un número entre cero y cien en el campo Establecer volumen. Tabula o haz clic fuera del cuadro de entrada para actualizar el volumen.
Silenciar | Activar sonido | Establecer   (0-100) [ Nivel actual:  --]
Calidad Usa esta herramienta desplegable para invocar la función setPlaybackQuality() y cambiar la calidad del video que se está reproduciendo. Cuando cambias la calidad, el video se detiene y vuelve a comenzar desde el principio.

El campo Niveles disponibles de la sección Estadísticas enumera los niveles de calidad disponibles para el video.

Si seleccionas un nivel de calidad que no esté disponible, YouTube elegirá el nivel más apropiado disponible. Por ejemplo, si configuras la calidad en baja, pero los niveles compatibles son media y alta, YouTube configura el nivel de calidad en media.
Calificar La velocidad de reproducción señala cuán rápido se está reproduciendo un video. La función getAvailablePlaybackRates() restablece el conjunto de velocidades de reproducción en las que está disponible el video actual. En esta demostración, las velocidades de reproducción disponibles aparecen en la sección Estadísticas.

Un valor de 1 indica que el video se está reproduciendo a velocidad normal.
   
Tamaño Esta sección te permite modificar el tamaño del reproductor con la función setSize(width, height). Esta función, por lo general, solo serviría con una aplicación ActionScript. En el caso de una aplicación de JavaScript, el reproductor con tamaño modificado sigue inserto en el objeto que lo contiene, incluso si este es más grande o más pequeño que el reproductor.
 x 405   
Historial Esta página invoca las funciones getVideoUrl() y getEmbedCode() cuando el reproductor está listo para mostrar el video. Estas funciones se vuelven a invocar si cargas o posicionas un video.

Si invocas getVideoUrl() después de que un video se haya reproducido por al menos diez segundos, la URL incluirá un parámetro que especifica el tiempo de desfase en el cual el reproductor debería comenzar a mostrar el video.
(borrar)
Errores
Ninguno por el momento.

Eventos e invocaciones de función
Ninguno por el momento.

Parámetros del reproductor
  • cuadro marcado = valor de parámetro 1
  • cuadro sin marcar = valor de parámetro 0
  • Utiliza el código de incorporación de IFrame para incorporar un reproductor con las opciones seleccionadas.

Parámetro Valor
autoplay  1: comienza a reproducir el video automáticamente cuando carga el reproductor.

0 (predeterminado): no reproduce automáticamente el video cuando carga el reproductor.
cc_load_policy  1: hace que los subtítulos aparezcan de forma predeterminada, aun si el usuario los desactivó. El comportamiento predeterminado se basa en la preferencia del usuario.
color Este parámetro especifica el color utilizado en la barra de progreso del video para mostrar la porción del video que el espectador ya vio. El valor predeterminado es rojo.
controls  1 (predeterminado): muestra los controles del reproductor en el reproductor de video.

0: no muestra los controles del reproductor en el reproductor de video.
disablekb  1: inhabilita los controles de teclado del reproductor.

0 (predeterminado): habilita los controles de teclado del reproductor. Estos son:
  • Barra espaciadora: permite reproducir/pausar.
  • Flecha izquierda: retrocede unos segundos del video actual.
  • Flecha derecha: avanza unos segundos del video actual.
  • Flecha arriba: sube el volumen.
  • Flecha abajo: baja el volumen.
enablejsapi  1: habilita el control del reproductor con la API del reproductor IFrame.

0 (predeterminado): no habilita la API.
end  El tiempo de desfase en el cual el video debe detener la reproducción. El valor es un número entero positivo que especifica la cantidad de segundos en el video en que la reproducción se detiene.
fs  1 (predeterminado): el reproductor muestra un botón para ver en pantalla completa.

0: el reproductor no muestra el botón.
hl  Configura el idioma de la interfaz del reproductor. El valor del parámetro es un código de idioma de dos letras ISO 639-1 o una región específica, como fr o fr-ca. También se pueden manejar de forma adecuada otros códigos de entrada de idioma, como las etiquetas de idioma IEFT (BCP 47).

El idioma de la interfaz se usa para la información sobre la herramienta del reproductor y también afecta la pista de subtítulos predeterminada.
iv_load_policy 1 (predeterminado): muestra las anotaciones del video. 3: no muestra las anotaciones del video.
list  Junto con list, este parámetro identifica el contenido que se carga en el reproductor.
  • playlist: el parámetro list especifica una identificación de lista de reproducción de YouTube. Asegúrate de que su valor comience con las letras PL.
  • search: el parámetro list especifica el término de la consulta de búsqueda utilizado para seleccionar el contenido a reproducir.
  • user_uploads: el parámetro list especifica de qué canal de YouTube son los videos que se cargaron en el reproductor.
listType Junto con list, este parámetro identifica el contenido que carga en el reproductor.
  • search: el parámetro list especifica el término de la consulta de búsqueda utilizado para seleccionar el contenido a reproducir.
  • user_uploads: el parámetro list especifica de qué canal de YouTube son los videos que se cargaron en el reproductor.
  • playlist: el parámetro list especifica una identificación de lista de reproducción de YouTube. Asegúrate de que su valor comience con las letras PL.
loop  1: si el reproductor está cargando un solo video, este se reproduce una y otra vez. Si está cargando una lista de reproducción, esta se reproduce completa y luego comienza de nuevo desde el primer video.

0 (predeterminado): no reproduce un video o una lista de reproducción completa de forma continua.
modestbranding  1: evita que el logotipo de YouTube aparezca en la barra de controles. Aparecen una etiqueta de texto o una marca de agua de YouTube cuando el puntero del mouse del usuario se desplaza por encima del reproductor.

0: muestra un logotipo de YouTube en la barra de controles del reproductor.
playlist  Una lista de identificaciones de video, separadas por comas, que se reproducen en secuencia.
playsinline  1: hace que la reproducción intercalada de UIWebViews creada con la propiedad allowsInlineMediaPlayback se establezca en TRUE.

0 (predeterminado): hace que la reproducción sea en pantalla completa. Ten en cuenta que el valor predeterminado podría cambiar.
start  El tiempo de desfase en que el video debería comenzar a reproducirse. El valor es un número entero positivo que especifica la cantidad de segundos en el video en que la reproducción debería comenzar. El reproductor busca el fotograma clave más cercano al tiempo que especificaste o uno antes que él.
Estadísticas   La información de esta sección describe el estado del reproductor de video y el video que se está reproduciendo (o el último que se mostró). La siguiente lista señala la función de API asociada con cada campo de esta sección:
  • Duración: getDuration()
  • Tiempo actual: getCurrentTime()
  • Estado del reproductor: getPlayerState()
  • Porcentaje de carga del video: getVideoLoadedFraction()
  • Bytes iniciales: getVideoStartBytes()
  • Nivel de calidad: getPlaybackQuality()
  • Niveles disponibles: getAvailableQualityLevels()
  • Volumen (encendido/apagado): isMuted()
  • Número de videos de la lista de reproducción: count(getPlaylist())
  • Posición del video actual: getPlaylistIndex()
  • Videos de la lista de reproducción: getPlaylist()
  • Bytes cargados: getVideoBytesLoaded() (deprecated)
  • Bytes totales: getVideoBytesTotal() (deprecated)

Duración: --:--
Tiempo actual: --:--
Estado del reproductor: --
Bytes iniciales: --
% de carga del video: --
Volumen (encendido/apagado):
Velocidad de reproducción: --
Velocidades disponibles:
Suspendido
Bytes cargados: --
Bytes totales: --