Além de ajustar as configurações de incorporação do seu vídeo no local, você pode adicionar funcionalidades ao player do Vimeo acrescentando diversos parâmetros URL ao final do URL do player em seu código de incorporação.
Parâmetros URL começam com um ponto de interrogação (?),Por exemplo:
<iframe src="https://player.vimeo.com/video/76979871?embedparameter=value" width="640" height="360" frameborder="0" allowfullscreen></iframe>
Os parâmetros de URL só se aplicam ao código de incorporação específico onde o parâmetro é adicionado.
Parâmetros suportados do player
| Parâmetro | Valores suportados | Valor padrão | Descrição | Videos suportados |
|---|---|---|---|---|
|
autopause |
true , false Ou 1,0 |
true |
O player do Vimeo é projetado para reproduzir somente um vídeo do Vimeo por vez. Portanto, será necessário adicionar este parâmetro a cada vídeo se quiser ter mais de um vídeo do Vimeo sendo reproduzido na mesma página. ⚠️ Advertências: - A funcionalidade de pausa automática não é suportada no Internet Explorer 11 e versões mais antigas. - Para que a pausa automática funcione,você deve ter os cookies ativados no seu navegador. |
Todos os vídeos |
|
autoplay |
true , false ou 1,0 |
false |
Inicia a reprodução do vídeo automaticamente. ⚠️ Aviso: a reprodução automática pode estar bloqueada em alguns ambientes, tais como iOS, Chrome 66+ e Safari 11+. Nestes casos, utilizaremos uma reprodução padrão onde é solicitado ao público que inicie a reprodução. |
Todos os vídeos |
|
background |
true , false ou 1,0 |
false |
A adição deste parâmetro terá o seguinte efeito:
Se você preferir que seu vídeo não entre em loop ou tenha reprodução automática, confira o parâmetro controls=0 abaixo. Observe que, a configuração deste parâmetro não desabilitará os controles do teclado. |
É necessário o vídeo ser hospedado por uma conta PRO ou superior. |
|
byline |
true , false ou 1,0 |
Valor especificado nas |
Mostra o autor do vídeo (autoria). |
Todos os vídeos (somente se o proprietário do vídeo permitir) |
|
color |
[hex code] |
Vimeo blue- |
Especifica a cor dos controles de vídeo. As cores podem ser substituídas por meio das configurações de incorporação do vídeo. |
É necessário o vídeo ser hospedado por uma conta PRO ou superior. |
|
controls |
true , false ou 1,0 |
verdadeiro |
Este parâmetro irá ocultar todos os elementos no player (barra de reprodução, botões de compartilhamento, etc) para uma experiência incomparável.
⚠️ Advertências: Ao usar este parâmetro, o botão reproduzir/pausar ficará oculto. Para iniciar a reprodução para seus espectadores, você precisará ativar a reprodução automática, usar controles de teclado ou implementar nosso SDK do player para iniciar e controlar a reprodução. Observe que, a configuração deste parâmetro não desabilitará os controles do teclado. |
O vídeo deve ser hospedado por uma conta Plus ou superior. |
|
dnt |
true , false ou 1,0 |
false |
Definir este parâmetro como "verdadeiro" irá impedir o player de rastrear quaisquer dados da sessão, incluindo todos os cookies e análises. (Terá o mesmo efeito que ativar uma configuração Do Not Track no seu navegador) |
Todos os vídeos |
|
loop |
true , false ou 1,0 |
false |
Reproduz o vídeo novamente quando ele chega ao final, infinitamente. Obs.: o loop também pode ser escolhido como a tela final de um vídeo na página de configurações de incorporação. Saiba mais aqui. |
Todos os vídeos |
|
muted |
true , false ou 1,0 |
false |
Configura o vídeo para ser silenciado ao carregar. O público pode ajustar suas preferências de volume no player. Pode ser usado para ativar o som em vídeos de fundo ou contornar limitações da reprodução automática em certos navegadores, tais como Chrome e Safari. |
Todos os vídeos |
pip
|
true , false ou 1,0 |
false |
Exibe o botão picture-in-picture na barra de controle e ativa a API picture-in-picture. |
Todos os vídeos |
|
playsinline |
true , false ou 1,0 |
true |
Reproduzir vídeos em sequência em dispositivos móveis em vez de entrar no modo tela cheia automaticamente. Por padrão, a reprodução em sequência está ativada para todos os vídeos. |
Todos os vídeos |
|
portrait |
true , false ou 1,0 |
Valor especificado |
Mostra a imagem do perfil do autor (retrato) |
Todos os vídeos (somente se o proprietário do vídeo permitir) |
|
quality |
240p, 360p, 540p, 720p, 1080p, 2k, 4k |
automático |
Por padrão, o player do Vimeo está definido no modo "Automático", o que significa que ele escolhe a qualidade de vídeo mais alta possível, dependendo da largura de banda do público e de outros fatores no ambiente de reprodução. O parâmetro de qualidade permite que você especifique a qualidade padrão de reprodução de seu vídeo incorporado. Caso selecione uma qualidade que não existe para o seu vídeo, o parâmetro de qualidade será ignorado e a incorporação usará o padrão Automático. ⚠️ Advertências: - Este parâmetro não é suportado em dispositivos móveis ou tablets. - Por favor, tenha cuidado ao implementar este parâmetro. O padrão para uma qualidade superior (como 4K) pode resultar em buffer excessivo e reprodução instável para seus espectadores. - Este parâmetro só é suportado para vídeos carregados e eventos arquivados que são incorporados. Ele não é suportado para eventos ao vivo. |
É necessário o vídeo ser hospedado por uma conta PRO ou superior. |
|
speed |
true , false ou 1,0 |
false |
Mostra os controles de velocidade no menu de preferências do player e permite API de taxa de reprodução. (saiba mais sobre nossa API do player aqui) |
É necessário o vídeo ser hospedado por uma conta PRO ou superior. |
|
#t |
Tempo representado em minutos e/ou segundos (por exemplo, #t=1m2s) |
Início do vídeo |
Usado para iniciar a reprodução automaticamente em um ponto específico no tempo. Saiba mais aqui. Obs.: diferente de todos os outros, este parâmetro não necessita de um ponto de interrogação prefixado. |
Todos os vídeos |
|
faixa de texto |
um código de idioma em letras minúsculas e, opcionalmente, a localidade e o tipo de faixa de texto. (Exemplos: "en", "en-US", "en.captions", "en.subtitles") |
Falso |
Exibe uma determinada faixa cc/legenda por padrão no player (dependendo se a faixa cc/legenda está disponível).
Se você inserir uma preferência de idioma que ainda não tenha sido carregada para o seu vídeo específico, o parâmetro de faixa de texto será ignorado e seu vídeo incorporado poderá carregar com CC ou legendas desativadas por padrão. |
Todos os vídeos com legendas ocultas cc ou legendas disponíveis (observação: legendas ocultas cc e legendas devem ser carregadas pelo proprietário do vídeo) |
|
title |
true , false ou 1,0 |
Valor especificado |
Mostra o título do vídeo. |
Todos os vídeos (somente se o proprietário do vídeo permitir) |
|
transparente |
true , false ou 1,0 |
true |
Por padrão, o fundo do iframe do player é transparente no Vimeo. Quando desativado, o fundo do iframe se tornará preto. Barras pretas serão aplicadas ao player quando as dimensões de altura e largura para o player incorporado não corresponderem à proporção de tela original de um vídeo-- p. ex., as dimensões de iframe estão definidas em 4:3 (quadrado), no entanto, o vídeo original tem 16:9 de largura. |
Todos os vídeos |
Usando vários parâmetros de incorporação
Caso adicione múltiplos parâmetros ao mesmo código de incorporação, será necessário separá-los com um "e comercial" (&). Por exemplo:
<iframesrc="https://player.vimeo.com/video/76979871?autoplay=1&loop=1&muted=1" width="640" height="360" frameborder="0"webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>
Aplicando parâmetros de incorporação ao URL do Vimeo.com
Caso use um aplicativo que solicite inserir uma URL Vimeo.com (p. ex., https://vimeo.com/
Por exemplo, este método não é suportado:
https://vimeo.com/76979871?
O seguinte é suportado:
<iframe src="https://player.vimeo.com/
Alguns exemplos de aplicativos que suportam somente URLs do Vimeo são postagens de mídias sociais, temas e plugins do Wordpress, plugins do Wix, plugins do Squarespace e outras ferramentas de incorporação de vídeo dentro de geradores de páginas web. A boa notícia é que algumas ferramentas permitem que você ajuste as preferências do player (como reprodução automática, por exemplo) diretamente em sua própria interface de usuário.