Todos los parámetros que aparecen a continuación son opcionales. En la lista se muestran los parámetros admitidos en cualquier reproductor incorporado de YouTube. Si todos los reproductores no son compatibles con un parámetro en particular, la definición de ese parámetro identifica los reproductores que sí lo son. Ten en cuenta que estos parámetros son oficialmente compatibles solo con el reproductor incorporado; sin embargo, es posible que un subconjunto de ellos también sea compatible con otros reproductores, tales como el reproductor de listas de reproducción.
Nota: Las incorporaciones IFrame pueden cargar tanto el reproductor HTML5 como el reproductor AS3. Aunque algunos parámetros no son compatibles con ninguno de los dos reproductores, una incorporación IFrame capaz de cargar el reproductor AS3 es compatible con todos los parámetros admitidos por ese reproductor e ignora todos los demás parámetros. Del mismo modo, una incorporación IFrame capaz de cargar el reproductor HTML5 es compatible con todos los parámetros admitidos por ese reproductor e ignora todos los demás parámetros.
Por ejemplo, el reproductor HTML5 no es compatible actualmente con el parámetro playerapiid
, pero es posible indicar ese parámetro cuando se crea una incorporación IFrame. Si la incorporación carga el reproductor AS3, el reproductor admite el parámetro; si carga el reproductor HTML5, el reproductor lo ignora.
1. autohide
Valores: 2 (predeterminado), 1 y 0. Este parámetro indica si los controles del video se ocultan automáticamente cuando comienza la reproducción. En la conducta predeterminada autohide=2), la barra de progreso se desvanece y los controles del reproductor (botón Reproducir, control de volumen, etc.) permanecen visibles.Si el parámetro se establece en 1, la barra de progreso y los controles del reproductor se ocultan algunos segundos después de que comienza la reproducción del video. Para que aparezcan nuevamente, el usuario debe mover el cursor del mouse sobre el reproductor de video o presionar una tecla del teclado. Si el parámetro se establece en 0, la barra de progreso del video y los controles del reproductor de video son visibles durante toda la reproducción y en pantalla completa.
&autohide=0
&autohide=1
&autohide=2
2. autoplay
Valores: 0 o 1. El valor predeterminado es 0. Define si el video inicial se reproduce automáticamente o no cuando se carga el reproductor.
&autoplay=0
&autoplay=1
3. cc_load_policy
Valores: 1. El valor predeterminado se basa en las preferencias del usuario. Si se establece en 1, los subtítulos opcionales se muestran de forma predeterminada, aun si el usuario desactivó los subtítulos.
&cc_load_policy=0
&cc_load_policy=1
4. color
Este parámetro especifica el color que se utiliza en la barra de progreso del reproductor para destacar la cantidad de video ya vista por el usuario. Los valores válidos de este parámetro son red y white. De forma predeterminada, la barra de progreso del video utiliza el color rojo. Consulta el blog de la API de YouTube para obtener más información sobre las opciones de colores. Nota: Configurar el parámetro color en white desactiva la opción modestbranding.
&color=blue
&color=red
5. controls
Valores: 0, 1 o 2. El valor predeterminado es 1. Este parámetro indica si se muestran o no los controles del reproductor de video. Para incorporaciones IFrame que cargan un reproductor Flash, también definen cuándo se muestran los controles en el reproductor, así como cuándo cargarán este último: controls=0: Los controles del reproductor no se muestran en el reproductor. Para incorporaciones IFrame, el reproductor Flash carga de manera inmediata. controls=1: Los controles del reproductor se muestran en el reproductor. Para incorporaciones IFrame, los controles se muestran inmediatamente y el reproductor Flash carga de la misma manera. controls=2: Los controles del reproductor se muestran en el reproductor. Para incorporaciones IFrame, se muestran los controles y el reproductor Flash se carga después de que el usuario inicia la reproducción del video. Nota: Está previsto que los valores 1 y 2 del parámetro proporcionen una experiencia de usuario idéntica, pero controls=2 proporciona una mejora del rendimiento sobre controls=1 para incorporaciones IFrame. Actualmente, los dos valores aún producen algunas diferencias visuales en el reproductor, como el tamaño de la fuente del título del video. Sin embargo, cuando la diferencia entre los dos valores es completamente evidente para el usuario, el valor predeterminado del parámetro puede cambiar de 1 a 2.
&controls=0
&controls=1
&controls=2
6. disablekb
Valores: 0 o 1. El valor predeterminado es 0. Establecer el valor en 1 desactiva los controles de teclado del reproductor. Los controles del teclado son los siguientes: Barra espaciadora: permite reproducir/pausar. Flecha izquierda: permite retroceder un 10% en el video actual. Flecha derecha: permite avanzar un 10% en el video actual. Flecha hacia arriba: permite subir el volumen. Flecha hacia abajo: permite bajar el volumen.
&disablekb=0
&disablekb=1
7. enablejsapi
Valores: 0 o 1. El valor predeterminado es 0. Establecer este parámetro en 1 activa la API de JavaScript. Para obtener más información sobre la API de JavaScript y cómo usarla, consulta la documentación de la API de JavaScript.
&enablejsapi=0
&enablejsapi=1
8. end
Valores: un número entero positivo. Este parámetro especifica el tiempo, medido en segundos desde el inicio del video, en que el reproductor debe detener la reproducción del video. Ten en cuenta que el tiempo se mide desde el comienzo del video y no considerando el parámetro start del reproductor o el parámetro startSeconds, que se utiliza en las funciones de la API del reproductor de YouTube para cargar un video o ponerlo en cola.
&end=10
&end=20
9. fs
Valores: 0 o 1. El valor predeterminado es 1, que hace que aparezca el botón de pantalla completa. Establecer este parámetro en 0 evita que se muestre el botón de pantalla completa.
&fs=0
&fs=1
10. hl
Configura el idioma de la interfaz del reproductor. El valor del parámetro es un código de idioma ISO 639-1 de dos letras, aunque también se pueden manejar correctamente otros códigos de entrada de idioma, como las etiquetas de idioma IETF (BCP 47). El idioma de la interfaz se usa para los tooltips en el reproductor y también afecta la pista de subtítulos predeterminada. Ten presente que YouTube podría seleccionar un idioma de pista de subtítulos diferente para un usuario en particular basándose en sus preferencias de idioma individuales y la disponibilidad de pistas de subtítulos
11. iv_load_policy
Valores: 1 o 3. El valor predeterminado es 1. El valor 1 permite que las anotaciones del video se muestren de forma predeterminada, mientras que el valor 3 permite que las anotaciones del video no se muestren de forma predeterminada.
&iv_load_policy=1
&iv_load_policy=3
12. list
El parámetro list, junto al parámetro listType, identifica el contenido que se cargará en el reproductor. Si el valor del parámetro listType es search, el valor del parámetro list especifica la consulta de búsqueda. Si el valor del parámetro listType es user_uploads, el valor del parámetro list identifica el canal de YouTube cuyos videos subidos se cargarán. Si el valor del parámetro listType es playlist, el valor del parámetro list especifica un ID de la lista de reproducción de YouTube. En el valor del parámetro, necesitas anteponer el ID de la lista de reproducción con las letras PL como se muestra en el siguiente ejemplo. https://www.youtube.com/playlist?list=PLc3-OpriT7ZJdpnRAI-s8ZWJnovH-_H7Y Nota: Si especificas los valores para los parámetros list y listType, no es necesario que la URL IFrame incorporada especifique un ID de video.
13. listType
El parámetro listType, junto al parámetro list, identifica el contenido que se carga en el reproductor. Los valores del parámetro válidos son playlist, search y user_uploads. Si especificas los valores para los parámetros list y listType, no es necesario que la URL IFrame incorporada especifique un ID de video.
14. loop
Valores: 0 o 1. El valor predeterminado es 0. Define si el video inicial se reproduce automáticamente o no cuando se carga el reproductor.
&loop=0
&loop=1
15. modestbranding
Este parámetro te permite usar un reproductor de YouTube sin que se muestre un logotipo de YouTube. Establece el valor de parámetro en 1 para evitar que se muestre el logotipo de YouTube en la barra de control. Ten en cuenta que se seguirá mostrando una etiqueta pequeña de YouTube en la esquina superior derecha de un video en pausa cuando el cursor del mouse del usuario se desplace sobre el reproductor.
&modestbranding=0
&modestbranding=1
16. origin
Este parámetro entrega una medida de seguridad adicional para la API de IFrame y es compatible solamente con las incorporaciones IFrame. Si estás usando la API de IFrame, lo que significa que configuras el valor del parámetro enablejsapi en 1, siempre debes especificar tu dominio como el valor del parámetro origin.
17. playerapiid
El valor puede ser una unidad alfanumérica. Estos parámetros de configuración se usan junto a la API de JavaScript. Consulta la documentación de la API de JavaScript para obtener más detalles.
18. playlist
El valor es una lista separada por comas de ID de videos para reproducir. Si especificas un valor, el primer video que se reproduce es aquel cuya identificación (VIDEO_ID) está especificada en la ruta de acceso de la dirección URL. Los videos especificados en el parámetro playlist se reproducen después.
19. rel
Valores: 0 o 1. El valor predeterminado es 1. Este parámetro indica si el reproductor debe mostrar videos relacionados al finalizar la reproducción del video inicial.
&rel=0
&rel=1
20. playsinline
El parámetro controla si los videos se reproducen intercalados o en pantalla completa en un reproductor HTML5 en iOS. Los valores válidos son: 0: Este valor hace que la reproducción sea en pantalla completa. Este valor es actualmente el valor predeterminado, aunque está sujeto a cambios. 1: Este valor hace que la reproducción intercalada de UIWebViews que se creó con la propiedad allowsInlineMediaPlayback se configure en TRUE.
&playsinline=0
&playsinline=1
21. showinfo
Valores: 0 o 1. El valor predeterminado del parámetro es 1. Si se establece el valor del parámetro en 0, el reproductor no muestra información como el título del video o el usuario que lo subió antes de comenzar la reproducción. Si el reproductor está cargando una lista de reproducción y el valor del parámetro se establece explícitamente en 1, el reproductor muestra imágenes en miniatura de los videos de la lista de reproducción cuando se carga. Ten en cuenta que esta función es compatible solo con el reproductor AS3 debido a que es el único reproductor que puede cargar una lista de reproducción.
&showinfo=0
&showinfo=1
22. start
Valores: un número entero positivo. Este parámetro permite que el reproductor inicie la reproducción del video en el número exacto de segundos proporcionados desde el comienzo del video. Ten en cuenta que, de forma similar a la función seekTo, el reproductor busca el fotograma más cercano al momento especificado. Esto significa que en algunas ocasiones la reproducción comienza justo antes del tiempo solicitado, con un margen de aproximadamente dos segundos.
&start=10
&start=20
23. theme
Este parámetro indica si el reproductor incorporado muestra los controles del reproductor (como el botón de reproducción o el control de volumen) con una barra de control oscura o clara. Los valores de parámetro válidos son dark y light. De forma predeterminada, el reproductor muestra los controles del reproductor usando el tema dark. Consulta el blog de la API de YouTube para obtener más información sobre los temas oscuros y claros.