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.
Neste artigo:
- Parâmetros suportados do player
- Usando vários parâmetros de incorporação
- Aplicando parâmetros de incorporação ao URL do Vimeo.com
Parâmetros suportados do player
Consulte a tabela abaixo para obter um resumo dos parâmetros suportados pelo 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 está disponível no Internet Explorer. - 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. |
O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
|
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- |
Especifique a cor dos controles de vídeo. |
O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
|
Cores
|
1-4 [códigos hexadecimais] - separados por vírgula. (Exemplo: colors=000000,00adef, ffffff, 000000) |
Cor 1- Primária: #000000 |
Especifique as cores do player. As cores podem ser substituídas pelas configurações de incorporação do vídeo. |
O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
|
Controles |
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 Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
|
dnt |
true , false OU 1,0 |
false |
Definir esse parâmetro como " true " impedirá o jogador de rastrear dados e análises da sessão. (Terá o mesmo efeito que ativar a configuração Do Not Track em seu navegador.) ⚠️ Advertências: Quando o DNT está ativado, o Vimeo implanta um cookie essencial por meio do player incorporável:
|
Todos os vídeos |
|
keyboard |
verdadeiro, falso |
true |
Permite a entrada do teclado para acionar eventos do jogador. Se for falso, o player ignorará a entrada do teclado. A tabulação ainda será suportada em qualquer um dos modos. |
Todos os vídeos |
|
loop |
true , false OU 1,0 |
false |
Reproduz o vídeo novamente quando ele chega ao final, infinitamente. Nota: Oloop também pode ser escolhido como 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 |
auto |
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. |
O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
|
speed |
true , false OU 1,0 |
false |
Mostre os controles de velocidade no menu de preferências do player e ative a API de taxa de reprodução. (saiba mais sobre nossa API de player no Vimeo Developer: API ) |
O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
|
#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 em "Iniciar a reprodução em um código de tempo específico". 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: as legendas ocultas cc e as legendas devem ser enviadas pelo proprietário do vídeo. Saiba mais em Legendas ocultas (cc) e legendas) |
|
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. |
|
transparent |
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 |
|
Transcrição |
true , false OU 1,0
|
true |
Mostre o botão de transcrição na barra de controle e ative os controles de transcrição. |
Todos os vídeos com faixas de texto. |
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
Se você estiver usando um aplicativo que exige a inserção de uma URL do Vimeo.com (por exemplo , https://vimeo.com/
Por exemplo, este método não é suportado:
https://vimeo.com/76979871?
O seguinte é suportado:
< iframe src= " https://player.vimeo.com/video/76979871?quality=720p" width= " 640 " height= " 360 " frameborder= " 0 "
webkit permite tela cheia mozallow tela cheia permite tela cheia ></iframe>
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 podem permitir que você ajuste as preferências do player (como a reprodução automática, por exemplo) diretamente em sua própria interface de usuário.
Solucionar problemas de parâmetros do player
Se você estiver tendo problemas para adicionar um parâmetro de player, entre em contato conosco para obter assistência e forneça o código de incorporação que você está usando para solucionar problemas mais rapidamente.