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 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 |
---|---|---|---|---|
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 |
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 |
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. |
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) |
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) |
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) |
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. |
fun |
true , false ou 1,0 |
true |
Quando desativado, remove mensagens de erros peculiares no player (p. ex., Opa, Credo) |
Todos os vídeos |
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. ⚠️ Aviso: a funcionalidade de autopause não é suportada no Internet Explorer 11, e versões anteriores. |
Todos os vídeos |
background |
true , false ou 1,0 |
false |
A adição deste parâmetro terá o seguinte efeito:
*A reprodução automática e o loop não podem ser desativados usando outros parâmetros. |
É necessário o vídeo ser hospedado por uma conta PRO ou superior. |
quality |
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. ⚠️ Aviso: tenha cuidado ao implementar este parâmetro. Usar uma determinada qualidade como padrão poderá resultar em pausas excessivas e uma reprodução picada para seu público. Nem todos contam com uma largura de banda para suportar vídeos de alta definição - especialmente 2K e 4K. |
É necessário o vídeo ser hospedado por uma conta PRO ou superior. |
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 |
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 |
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 |
dnt |
true , false ou 1,0 |
false |
Rastreamos todas as sessões de reprodução para identificar falhas e monitorar o desempenho em nosso player. Definir este parâmetro em verdadeiro impedirá que o player rastreie qualquer dado de sessão de reprodução. (Terá o mesmo efeito que ativar um cabeçalho Não Rastrear em seu navegador) |
Todos os vídeos |
#t |
Tempo representado em minutos e/ou segundos (por exemplo, #t=1m2s) |
Início do vídeo |
Usado para iniciar a reprodução em um momento específico. 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 |
Usando parâmetros de incorporação múltiplos
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 a um 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.