El artículo explica cómo personalizar el reproductor de Vimeo utilizando parámetros de URL en el código de inserción para agregar una funcionalidad específica a ese video.
En este artículo:
- ¿Qué es un parámetro de reproductor?
- Cómo aprovechar al máximo los parámetros del reproductor
- Próximos pasos sugeridos
¿Qué es un parámetro de reproductor?
- Un parámetro del reproductor es una cadena de texto que se adjunta a la URL de un video dentro de su código de inserción. Actúa como una instrucción que modifica el comportamiento del reproductor de video, como por ejemplo, iniciar la reproducción automática o la reproducción en bucle.
- Los parámetros de URL comienzan con un signo de interrogación (?).
- Los parámetros de URL solo se aplican al código de inserción específico donde se agrega el parámetro.
Ejemplo:
iframe src="https://player.vimeo.com/video/76979871?embedparameter=valor" ancho="640" altura="360" frameborder="0" permita pantalla completa></iframe>
Cómo aprovechar al máximo los parámetros del reproductor
Consulte la tabla siguiente para ver un resumen de los parámetros de los reproductores admitidos que puede usar con su código de inserción:
| Parámetro | Valores admitidos | Valor predeterminado | Descripción | Videos admitidos |
| AirPlay |
true , false O 1,0 |
true | Si AirPlay está habilitado. | El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise . ⚠️Nota: AirPlay solo es compatible con Safari. |
| ask_ai | autopause | true | Si la función Ask AI está activada. | Videos alojados por una cuenta Enterprise que son elegibles para la función Ask AI. |
| audio_track |
true , false O 1,0 |
true | Si aparece el menú de audio. | El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| pista de audio |
un código de idioma en minúsculas, o "main" si quieres que el video sea la pista de audio principal predeterminada
|
false | Muestra una pista de audio determinada de forma predeterminada en el reproductor (en espera de que la pista de audio esté disponible) | Todos los videos en los que se hayan subido varias pistas de audio |
| autopause |
true , false O 1,0 |
true |
El reproductor de Vimeo solo reproduce un video a la vez. Para tener varios videos en la misma página, debes agregar un parámetro específico a cada uno. ⚠️ Nota: Para que la pausa automática funcione, debes tener habilitadas las cookies en tu navegador. |
Todos los videos |
| autoplay |
true , false O 1,0 |
false | Inicia automáticamente la reproducción del video. | Todos los videos |
| background |
true , false O 1,0 |
false |
Agregar este parámetro hará lo siguiente:
Para evitar el bucle o la reproducción automática, usa el parámetro controls=0. La configuración de este parámetro no desactivará los controles del teclado. |
El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| Insignia |
true , false O 1,0 |
true | Mostrar la insignia del video (por ejemplo, insignia de Staff Pick). | Todos los videos |
| byline |
true , false O 1,0 |
Valor especificado en la configuración de insertar del video en el sitio |
Muestra el autor del video (nombre del creador). | Todos los videos |
| CC |
true , false O 1,0 |
true | Si el botón de subtítulos ocultos está activado. | El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| Capítulos |
true , false O 1,0 |
true | Si aparece el botón de capítulos. | El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| Chromecast |
true , false O 1,0 |
true | Si aparece el botón de Chromecast. |
El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise . ⚠️Nota: Chromecast no es compatible con iOS |
| color | [hex code] | Vimeo blue- 00adef |
Especifica el color de los controles de video. Los colores pueden ser anulados por la configuración insertada del video. Si el color no se establece a través de un parámetro o configuración, se activará el parámetro transparente. |
El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| colores |
1-4 [códigos hexadecimales] - separados por comas. (Example: colors=000000,00adef, ffffff,000000) |
Color 1- Primario: #000000 Color 2- Acento: #00adef Color 3- Icono y texto:#ffffff Color 4- Fondo: #000000 |
Especifique los colores del reproductor. Los colores pueden ser anulados por la configuración insertada del video. |
El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| Controles |
true , false O 1,0 |
true | Oculta o muestra todos los elementos del reproductor, como la barra de reproducción y los botones para compartir, para crear una experiencia sin bordes. Nota: Cuando está activado, el botón de reproducción/pausa está oculto. Los espectadores deben usar la reproducción automática, los controles del teclado o nuestro SDK del reproductor para iniciar y controlar la reproducción. Esta configuración no desactiva los controles del teclado. |
El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| dnt |
true , false O 1,0 |
false |
Establecer este parámetro en "true" impide que el reproductor recopile datos y análisis de la sesión, de forma similar a la activación de la función No rastrear en tu navegador. ⚠️ Nota: Con DNT activo, algunas cookies esenciales seguirán activas. Visita las cookies del reproductor de Vimeo para ver esta lista. |
Todos los videos |
| Pantalla completa |
true , false O 1,0 |
true | Si aparece el botón de pantalla completa. | El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| calidad_inicial | 240 p, 360 p, 540 p, 720 p, 1080 p, 2 k, 4 k | auto |
La calidad de video inicial, que se muestra brevemente antes de que comience la transmisión adaptable. Esto se puede ajustar para una carga más rápida o una mayor claridad. La calidad inferior, como 360p, se carga más rápido; una calidad más alta, como 1080p o 4K, ofrece una mejor resolución de inmediato. |
El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| interactive_params | Pares clave-valor separados por comas | Ninguno | Pares clave-valor que representan parámetros dinámicos que se utilizan en videos interactivo con elementos dinámicos, como title=my-video , subtitle= interactivo | Videos interactivos |
| interactive_markers |
true , false O 1,0 |
true | Si se muestran los marcadores que representan la marca de tiempo donde aparecen los puntos de acceso en un video interactivo . | Videos interactivos |
| keyboard |
true , false O 1,0 |
true | Permite que la entrada del teclado active eventos del reproductor. Si se establece como falso, el reproductor ignorará la entrada del teclado. El tabulado seguirá siendo compatible en ambos modos. |
Todos los videos |
| loop |
true , false O 1,0 |
false |
Reproduce el video nuevamente cuando llega al final, infinitamente. 💡Consejo: La opción de bucle también se puede seleccionar como pantalla final de un video dentro de la página de configuración de insertar . Obtén más información enAcerca de las pantallas finales. |
Todos los videos |
| max_quality | 240 p, 360 p, 540 p, 720 p, 1080 p, 2 k, 4 k | auto |
La calidad más alta que el reproductor seleccionará automáticamente durante la reproducción del video. El reproductor elige la mejor calidad hasta este valor sin excederlo. Establecer esta opción puede ayudar a reducir el consumo de ancho de banda . Puedes seleccionar cualquier valor en el menú de calidad del reproductor de video, incluidos 360p, 720p, 1080p, 2K y 4K. |
El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| min_quality | 240 p, 360 p, 540 p, 720 p, 1080 p, 2 k, 4 k | auto |
La calidad más baja a la que el reproductor cambiará automáticamente durante la reproducción de video . El reproductor selecciona la calidad óptima sin caer por debajo de este umbral. La configuración de este parámetro ayuda a garantizar que los espectadores reciban videos de alta resolución teniendo en cuenta las limitaciones de ancho de banda . Puedes seleccionar cualquier opción de calidad disponible en el reproductor, incluidas 360p, 720p, 1080p, 2K y 4K. |
El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| muted |
true , false O 1,0 |
false |
Configura el video para que se silencie durante la carga. Los espectadores aún pueden ajustar las preferencias de volumen en el reproductor. Se puede utilizar para activar el sonido de los videos de fondo o evitar las limitaciones de reproducción automática en ciertos navegadores, como Chrome y Safari. |
Todos los videos |
|
pepita |
true , false O 1,0 |
false | Muestra el botón de imagen incrustada en la barra de control y activa la API de imagen incrustada. | El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise |
| play_button_position | automático, inferior o central | auto | Dónde se coloca el botón de reproducción en el reproductor. Cuando se establece en automático, el botón de reproducción aparece en la barra de control antes de moverse al centro del reproductor en los puntos de interrupción más pequeños. | El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise |
| playsinline |
true , false O 1,0 |
true | Reproduce videos intercalados en dispositivos móviles en lugar de pasar automáticamente al modo de pantalla completa. La reproducción en línea está habilitada de forma predeterminada para todos los videos. | Todos los videos |
| portrait |
true , false O 1,0 |
Valor especificado en la configuración de insertar del video en el sitio |
Muestra la imagen de perfil del autor (vertical). | Todos los videos |
| precarga | metadata, metadata_on_hover, automático, auto_on_hover, ninguno |
metadata_ on_hover |
El comportamiento de carga previo a la reproducción del reproductor se alinea con la propiedad de precarga nativa de la interfaz HTMLMediaElement, con algunas opciones adicionales:
La precarga de más datos ayuda a que el video comience más rápido. Por lo tanto, "auto" y "auto_on_hover" permiten un inicio más rápido, pero requieren más ancho de banda, ya que los segmentos de video se cargan tanto si el usuario reproduce el video como si no. Para obtener más detalles sobre los límites de ancho de banda de Vimeo, visita Ancho de banda en Vimeo. |
El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| barra_de_progreso |
true , false O 1,0 |
true | Si aparece la barra de progreso. | El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| quality | 240 p, 360 p, 540 p, 720 p, 1080 p, 2 k, 4 k | automático |
De forma predeterminada, el reproductor de Vimeo está configurado en modo "Auto", lo que significa que elige la calidad de video más alta posible en función del ancho de banda del espectador y otros factores en el entorno de reproducción. La calidad te permite especificar la resolución de reproducción predeterminada para tu video insertado. Si seleccionas una calidad que no está disponible, el parámetro se ignorará y la insertar se establecerá de forma predeterminada en Automático. 💡Consejo: Elegir una configuración de mayor calidad (como 4K) puede provocar un almacenamiento en búfer excesivo y una reproducción entrecortada para los espectadores. |
El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. Disponible para videos subidos y eventos archivados. No admite eventos en vivo. |
| quality_selector |
true , false O 1,0 |
true | Si aparece el menú del selector de calidad. | El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| skipping_forward |
true , false O 1,0 |
true | Si el usuario puede saltar hacia adelante durante la reproducción. | El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| speed |
true , false O 1,0 |
false | Muestra los controles de velocidad en el menú de preferencias del reproductor y activa la API de velocidad de reproducción. (Lee sobre nuestra API para reproductores en Vimeo Developer: API ). | El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| #t | Tiempo representado en minutos o segundos (por ejemplo, #t=1m2s) |
Inicio del video (0m) |
Se utiliza para iniciar automáticamente la reproducción en un punto específico en el tiempo. Obtén más información en "Iniciar la reproducción en un código de tiempo específico". 💡Consejo: Este parámetro no requiere un signo de interrogación prefijado como todos los demás. |
Todos los videos |
| texttrack |
Un código de idioma en minúsculas y, opcionalmente, la configuración regional y el tipo de pista de texto. (Ejemplos: "en", "en-US", "en.captions", "en.subtitles") |
false |
Muestra una pista de subtítulos/subtítulos especificada de forma predeterminada en el reproductor, si está disponible. Si seleccionas una preferencia de idioma que aún no se ha subido para tu video, se ignorará la configuración de la pista de texto y es posible que el video insertado se cargue con las leyendas o los subtítulos desactivados de forma predeterminada. |
Todos los videos con leyendas o subtítulos están disponibles (Nota: las leyendas y los subtítulos deben ser subidos por el propietario del video. Obtén más información en Leyendas y subtítulos) |
| thumbnail_id | El ID de la miniatura que se va a cargar desde el conjunto de miniaturas disponible del video. | Ninguno | Muestra el ID de la miniatura que se va a cargar desde el conjunto de miniaturas disponibles del video. | El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| title |
true , false O 1,0 |
Valor especificado en la configuración de insertar del video en el sitio |
Muestra el título del video. | Todos los videos |
| transparent |
true , false O 1,0 |
true |
La configuración transparente está activa si el color no se ha especificado a través de una configuración o parámetro. Por lo general, el fondo iFrame del reproductor de Vimeo es transparente por defecto. Si está desactivada, el fondo cambiará a negro. Las barras negras serán visibles en el reproductor cuando la altura y el ancho del iframe no coincidan con la relación de aspecto original del video, como cuando se establece el iFrame en 4:3 mientras que el video original es 16:9. |
Todos los videos |
| Transcripción |
true , false O 1,0
|
true | Muestre el botón de transcripción en la barra de control y active los controles de transcripción. | El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| unmute_button |
true , false O 1,0 |
true | Si aparece el botón para dejar de silenciar. | El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| vimeo_logo |
true , false O 1,0 |
true | Si aparece el logotipo de Vimeo . | El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| Volumen |
true , false O 1,0 |
true | Si aparece el control de volumen. | El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| ver_video_completo |
true , false O 1,0 |
true | Si el botón Ver video completo aparece en los videos en el modo de reproducción segmentada. | Todos los videos en modo de reproducción segmentada. |