Além de ajustar as configurações de incorporação do seu vídeo no local, você pode adicionar funcionalidades ao player do Vimeo adicionando vários parâmetros de URL ao final do URL do player no seu código de incorporação.
Os parâmetros de URL iniciam com um ponto de pergunta (?).
Por exemplo:
< iFrame srn==https://player.vimeo.com/video/76979871?embedparametr=value " bandwidth==640" altura=360" quadroborder=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
Consulte a tabela abaixo para obter um resumo dos parâmetros do player compatível.
|
Parâmetro |
Valores suportados |
Valor padrão |
Descrição |
Videos suportados |
|
faixa de áudio |
um código de idioma em maiúsculas ou "principal" se quiser que o vídeo tenha como padrão a faixa de áudio principal
|
false |
Exibe uma determinada faixa de áudio por padrão no player ( enquanto a faixa de áudio está disponível ) |
Todos os vídeos onde várias faixas de áudio foram carregadas |
|
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 ambiente, como OS, Chrome 66+ e Safari 11+. Nestes casos, reverteremos para a reprodução padrão , solicitando que os espectadores iniciem 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 |
Avaliação especificada |
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 incorporadas 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 oculta todos os elementos do player (barra de reprodução, botões de compartilhamento etc.) para oferecer uma experiência sem elementos cromados.
⚠️ 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.) ⚠️ Aviso: Quando o DNT estiver ativado, alguns cookies essenciais permanecerão definidos. Você pode encontrar uma lista desses cookies aqui. |
Todos os vídeos |
|
initial_quality |
240p, 360p, 540p, 720p, 1080p, 2k, 4k |
auto |
A qualidade do vídeo é usada durante os primeiros segundos de reprodução, antes que a transmissão com taxa de bits adaptável assuma o controle. Definir uma qualidade mais baixa (por exemplo, 360p) pode ajudar os vídeos a começar mais rápido, enquanto uma qualidade mais alta (por exemplo, 1080p ou 4K) garante alta resolução desde o início. Os valores aceitos incluem qualquer opção de qualidade disponível no menu do player, como 360p, 720p, 1080p, 2K e 4K. |
O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
|
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. Observação: a opção de loop também pode ser selecionada como tela final de um vídeo na página de configurações de incorporação.Leia mais emSobre as telas finais. |
Todos os vídeos |
|
máximo_qualidade |
240p, 360p, 540p, 720p, 1080p, 2k, 4k |
auto |
A qualidade mais alta possível para a qual o player muda automaticamente durante a reprodução do vídeo . O player determina a melhor qualidade para reproduzir sem exceder esse valor máximo. A configuração deste parâmetro pode ajudar a reduzir o uso da largura de banda. Esse campo pode receber qualquer valor do menu de qualidade no player do vídeo. Os valores comuns são 360p, 720p, 1080p, 2K e 4K |
O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
|
min_quality |
240p, 360p, 540p, 720p, 1080p, 2k, 4k |
auto |
A qualidade mais baixa possível para a qual o player muda automaticamente durante a reprodução do vídeo. O player determina a melhor qualidade para reproduzir sem ficar abaixo desse valor mínimo. A configuração deste parâmetro garante que o espectador receba vídeo de alta resolução enquanto ainda é responsável pela largura de banda. Esse campo pode receber qualquer valor do menu de qualidade no player do vídeo. Os valores comuns são 360p, 720p, 1080p, 2K ou 4K |
O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
|
muted |
true , false OU 1,0 |
false |
Defina o vídeo para silenciar no carregamento. Os espectadores ainda podem ajustar as preferências de volume no player. Pode ser usado para ativar o som de vídeos de fundo ou solucionar limitações de reprodução automática em determinados navegadores, 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 |
Reproduza vídeos online em dispositivos móveis, em vez de entrar automaticamente no modo de tela cheia. A reprodução integrada está ativada por padrão 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 seleciona a mais alta qualidade de vídeo possível, levando em conta a largura de banda do espectador e 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: - 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ó é compatível com vídeos carregados e eventos arquivados que estão incorporados. Não é compatível com eventos ao vivo. |
O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
|
skiping_forboard |
verdadeiro, falso ou 1,0 | true |
Se os usuários podem pular para frente no player incorporável |
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. (leia sobre a API do player em Vimeo Desenvolvedor: 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 automaticamente a reprodução em um ponto específico no tempo. Saiba como em “Iniciar 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 foi carregada para seu vídeo específico, o parâmetro da faixa de texto será ignorado, e seu vídeo incorporado poderá carregar com as legendas ocultas (cc) (CC) ou legendas desativadas por padrão. |
Todos os vídeos com closed captions (cc); legendas (cc) ou legendas estão disponíveis (observação: as closed captions (cc); legendas e as legendas devem ser enviadas pelo proprietário do vídeo. Leia mais em Legendas ocultas (cc) e legendas) |
|
thumbnail_id |
O ID da miniatura a ser carregada do conjunto de miniaturas disponíveis do vídeo. |
Nenhum |
Exibe o ID da miniatura a ser carregada do conjunto de miniaturas disponíveis para o vídeo. |
O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
|
title |
true , false OU 1,0 |
Avaliação especificada nas configurações de incorporação de vídeo |
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 no Vimeo é transparente. 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. |