Además de ajustar la configuración de insertar de tu video en el sitio, puedes agregar funcionalidad al reproductor de Vimeo agregando varios parámetros de URL al final de la URL del reproductor en tu código de inserción.
Los parámetros de URL comienzan con un signo de interrogación (?).
Por ejemplo:
< iFrame src="https://player.vimeo.com/video/76979871?embedparameter=value" width="640" height="360" frameborder="0" allowfullscreen></iframe>
Los parámetros de URL solo se aplican al código de inserción específico donde se agrega el parámetro.
Parámetros del reproductor admitidos
Consulta la siguiente tabla para ver un resumen de los parámetros del reproductor admitidos.
| Parámetro | Valores admitidos | Valor predeterminado | Descripción | Videos admitidos |
| 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 está diseñado para reproducir solo un video de Vimeo a la vez. Por lo tanto, deberás agregar este parámetro a cada video si deseas que se reproduzca más de un video de Vimeo en la misma página. ⚠️ Advertencias: - La función de pausa automática no es compatible con Internet Explorer. - 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. ⚠️ Advertencia: La reproducción automática puede estar bloqueada en algunos entornos, como iOS, Chrome 66+ y Safari 11+. En estos casos, volveremos a la reproducción estándar, lo que requerirá que los espectadores inicien la reproducción. |
Todos los videos |
| background |
true , false O 1,0 |
false |
Agregar este parámetro tendrá el siguiente efecto:
Si prefieres que tu video no se reproduzca en bucle ni reproducción automática, consulta el parámetro controls=0 que aparece a continuación. Ten en cuenta que al establecer este parámetro no se desactivarán los controles del teclado. |
El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| byline |
true , false O 1,0 |
Valor especificado en la configuración de insertar del video en el sitio |
Mostrar el autor del video (firma). |
Todos los videos (pero solo si el propietario del video lo permite) |
| 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. |
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 |
Este parámetro ocultará todos los elementos del reproductor (barra de reproducción, botones para compartir, etc.) para una experiencia chromeless.
⚠️ Advertencias: Al usar este parámetro, el botón de reproducción/pausa estará oculto. Para iniciar la reproducción para tus espectadores, tendrás que habilitar la reproducción automática, usar los controles del teclado o implementar nuestro SDK del reproductor para iniciar y controlar la reproducción. Ten en cuenta que al establecer este parámetro no se desactivarán 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 |
Si se establece este parámetro en "true", se bloqueará el seguimiento de los datos y análisis de la sesión por parte del reproductor. (Tendrá el mismo efecto que activar la opciónNo rastrear en su navegador). ⚠️ Advertencia: Cuando DNT está habilitado, ciertas cookies esenciales permanecerán establecidas. Puedes encontrar una lista de dichas cookies aquí. |
Todos los videos |
| calidad_inicial | 240 p, 360 p, 540 p, 720 p, 1080 p, 2 k, 4 k | auto | La calidad de video se utiliza durante los primeros segundos de reproducción, antes de que la transmisión con tasa de bits adaptable se haga cargo. Establecer una calidad más baja (por ejemplo, 360p) puede ayudar a que los videos comiencen más rápido, mientras que una calidad más alta (por ejemplo, 1080p o 4K) garantiza una alta resolución desde el principio. Los valores aceptables incluyen cualquier opción de calidad disponible en el menú del reproductor, como 360p, 720p, 1080p, 2K y 4K. | El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| keyboard |
verdadero, falso O 1, 0 |
true |
Permite que la entrada del teclado active eventos del reproductor. Si es falso, el reproductor ignorará la entrada del teclado. El tabulado seguirá siendo compatible en cualquiera de los dos modos. |
Todos los videos |
| loop |
true , false O 1,0 |
false |
Reproduce el video nuevamente cuando llega al final, infinitamente. Nota: 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 en Acerca 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 posible a la que el reproductor cambia automáticamente durante la reproducción de video. El reproductor determina la mejor calidad para reproducir sin exceder este valor máximo. La configuración de este parámetro puede ayudar a reducir el uso de ancho de banda. Este campo puede tomar cualquier valor del menú de calidad del reproductor del video. Los valores comunes son 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 posible a la que el reproductor cambia automáticamente durante la reproducción de video . El reproductor determina la mejor calidad para reproducir sin caer por debajo de este valor mínimo. La configuración de este parámetro garantiza que el espectador reciba video de alta resolución sin dejar de tener en cuenta el ancho de banda. Este campo puede tomar cualquier valor del menú de calidad del reproductor del video. Los valores comunes son 360p, 720p, 1080p, 2k o 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. | Todos los videos |
| 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 (foto de perfil) |
Todos los videos (pero solo si el propietario del video lo permite) |
| precarga | metadata, metadata_on_hover, automático, auto_on_hover, ninguno |
metadata_ on_hover |
El comportamiento de carga del reproductor antes de iniciar la reproducción .
Esto sigue los principios básicos de la propiedad de precarga nativa (https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/preload) de la interfaz HTMLMediaElement, con algunos valores adicionales:
|
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 "Automático", lo que significa que selecciona la mejor calidad de video posible, teniendo en cuenta el ancho de banda del espectador y otros factores en el entorno de reproducción . El parámetro de calidad te permite especificar la calidad de reproducción predeterminada para tu video insertado. Si eliges una calidad inexistente para un video en particular, ignoraremos el parámetro y la inserción pasará a modo automático de forma predeterminada. ⚠️ Advertencias: - Ten cuidado al implementar este parámetro. Establecer por defecto una calidad más alta (como 4 K) puede generar un almacenamiento en búfer excesivo y a una reproducción entrecortada para los espectadores. Este parámetro solo es compatible con los videos subidos y los eventos archivados que están insertados. No es compatible con eventos en vivo. |
El video debe estar alojado en una cuenta Starter, Standard, Advanced, Plus, Pro, Business, Premium o Enterprise. |
| skipping_forward | verdadero, falso OR 1,0 | true | Si los usuarios pueden saltar hacia adelante en el reproductor insertable | 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". Nota: 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 determinada pista de leyendas/subtítulos por defecto en el reproductor (mientras la pista de leyendas/subtítulos esté disponible).
Si ingresas una preferencia de idioma que aún no se ha subido para tu video en particular, el parámetro de pista de texto se ignorará y tu video insertado puede cargarse con los subtítulos ocultos (CC) 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 (pero solo si el propietario del video lo permite) |
| transparent |
true , false O 1,0 |
true |
Por defecto, el fondo del iFrame del reproductor en Vimeo es transparente. Si está inhabilitado, el fondo del iframe se volverá negro. Aplicaremos barras negras al reproductor cuando las dimensiones de altura y ancho del reproductor insertado no coincidan con la relación de aspecto original de un video. Por ejemplo, las dimensiones del iframe están establecidas en 4:3 estándar, pero el video original es 16:9 panorámico. |
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. | Todos los vídeos con pistas de texto. |