O artigo explica como personalizar o player do Vimeo usando parâmetros de URL no código de incorporação para adicionar uma funcionalidade específica a esse vídeo.
Além de ajustar as configurações de incorporação do seu vídeo no site, você também pode aprimorar os recursos do 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 (?).
Exemplos:
< iFrame srn==https://player.vimeo.com/video/76979871?embedparametr=value " bandwidth==640" altura=360" quadroborder=0" allowfullscreen</iframe>
Os parâmetros de URL se aplicam somente 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 |
| AirPlay |
true , false OU 1,0 |
true | Se o AirPlay está ativado. | O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise . ⚠️Nota: oAirPlay é compatível apenas com o Safari. |
| ask_ai | autopause | true | Se o recurso Perguntar à IA está ativado. | Vídeos hospedados por uma conta Enterprise qualificada para o recurso Perguntar à IA. |
| audio_ track |
true , false OU 1,0 |
true | Se o menu de áudio é exibido. | O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
| 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 só reproduz um vídeo por vez. Para ter vários vídeos na mesma página, é preciso adicionar um parâmetro específico a cada um. ⚠️ Observação: para que a pausa automática funcione, é necessário 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. | Todos os vídeos |
| background |
true , false OU 1,0 |
false |
A adição deste parâmetro:
Para evitar looping ou a reprodução automática, use o parâmetro control=0. 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. |
| distintivo |
true , false OU 1,0 |
true | Mostrar o distintivo do vídeo (p. ex., Distintivo Staff Pick). | Todos os vídeos |
| byline |
true , false OU 1,0 |
Avaliação especificada nas configurações de incorporação de vídeo no site |
Mostra o autor do vídeo (autoria). | Todos os vídeos |
| cc |
true , false OU 1,0 |
true | Se o botão de legendas ocultas (cc) está ativado. | O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
| Capítulos |
true , false OU 1,0 |
true | Se o botão de capítulos é exibido. | O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
| Chromecast |
true , false OU 1,0 |
true | Se o botão do Chromecast é exibido. |
O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise . ⚠️Observação: o Chromecast não é compatível com iOS |
| color | [hex code] | Vimeo blue- 00adef |
Especifique a cor dos controles de vídeo. As cores podem ser substituídas pelas configurações incorporadas do vídeo. Se a cor não for definida por meio de parâmetro ou configuração, o parâmetro transparente será ativado. |
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- Principal: #000000 Cor 2-Accent: #00adef Cor 3- Ícone e texto:#ffffff Cor 4- Fundo: #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 | Oculta ou mostra todos os elementos do player, como a barra de reprodução e os botões de compartilhamento, para criar uma experiência sem elementos cromados. Observação: quando ativado, o botão reproduzir/pausar fica oculto. Os espectadores devem usar a reprodução automática, os controles do teclado ou nosso SDK do player para iniciar e controlar a reprodução. Essa configuração não desativa 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 este parâmetro como "true" impede o player de coletar dados e análises da sessão, de forma similar à ativação de um recurso Não Monitorar no seu navegador. ⚠️ Observação: com o DNT ativo, alguns cookies essenciais ainda estarão ativos. Acesse Cookies do player do Vimeo para ver esta lista. |
Todos os vídeos |
| Tela cheia |
true , false OU 1,0 |
true | Se o botão de tela cheia é exibido. | O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
| initial_quality | 240p, 360p, 540p, 720p, 1080p, 2k, 4k | auto |
A qualidade inicial do vídeo, exibida rapidamente antes do início da transmissão adaptativa. Pode ser ajustado para um carregamento mais rápido ou uma melhor clareza. Uma qualidade mais baixa, como 360p, carrega mais rápido; uma qualidade superior, como 1080p ou 4K, oferece melhor resolução imediatamente. |
O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
| interactive_params | pares de chaves e valores separados por vírgulas | Nenhum | pares de valores-chave que representam parâmetros dinâmicos que são usados em vídeos interativo com elementos dinâmicos, como title=my-video , caption= interativo | Vídeos interativos |
| interactive_marketers |
true , false OU 1,0 |
true | Se deve exibir marcas que representam o carimbo de data/hora em que os hotspots aparecem em um vídeo interativo . | Vídeos interativos |
| keyboard |
true , false OU 1,0 |
true | Permite que a entrada do teclado acione eventos do player. Se definido como falso, o player ignorará a entrada do teclado. Pressionar a tecla Tab será aceito em ambos os modos. |
Todos os vídeos |
| loop |
true , false OU 1,0 |
false |
Reproduz o vídeo novamente quando ele chega ao final, infinitamente. 💡 Dica: 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 que o player selecionará automaticamente durante a reprodução do vídeo . O player escolhe a melhor qualidade até esse valor, sem excedê-lo. Configurar isso pode ajudar a reduzir o consumo da largura de banda . Você pode selecionar qualquer valor no menu de qualidade no reprodutor de vídeo, incluindo 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 |
O player mudará automaticamente para a qualidade mais baixa durante a reprodução do vídeo . O player seleciona a qualidade ideal sem ficar abaixo deste limite. A configuração deste parâmetro ajuda a garantir que os espectadores recebam vídeo de alta resolução, levando em conta as restrições de largura de banda . Você pode selecionar qualquer opção de qualidade disponível no player, incluindo 360p, 720p, 1080p, 2K e 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. | O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise |
| play_Button_scription | automático, na parte inferior ou no meio | auto | Onde o botão de play está posicionamento no player. Quando definido como automático, o botão de play aparece na barra de controle antes de passar para o meio do player em pontos de pausa menores. | O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise |
| 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 |
Avaliação especificada nas configurações de incorporação de vídeo no site |
Mostre a imagem do perfil do autor (retrato). | Todos os vídeos |
| pré-carregamento | metadados, metadados_on_hover, auto, auto_on_hover, nenhum |
metadados_ on_hover |
O comportamento de carregamento pré-reprodução do player está alinhado à propriedade nativa de pré-carregamento da interface HTMLMediaElement, com algumas opções adicionadas:
Pré-carregar mais dados ajuda o vídeo a começar mais rápido. Portanto, "auto" e "auto_on_hover" permitem uma startup mais rápida, mas exigem mais largura de banda, uma vez que os segmentos de vídeo são carregados, independentemente de o usuário reproduzir o vídeo ou não. Para obter mais detalhes sobre os limites de largura de banda do Vimeo, acesse Largura de banda no Vimeo. |
O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
| progresso_bar |
true , false OU 1,0 |
true | Se a barra de progresso é exibida. | O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
| 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 escolhe a qualidade de vídeo mais alta possível com base na largura de banda do espectador e em outros fatores no ambiente de reprodução. Qualidade, você pode especificar a resolução de reprodução padrão do seu vídeo incorporado. Se você selecionar uma qualidade que não esteja disponível, o parâmetro será ignorado, e a incorporação passará a ser automática. 💡 Dica: escolher uma configuração de qualidade mais alta (como 4K) pode levar a buffering excessivo e reprodução picada para os espectadores. |
O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. Disponível para vídeos carregados e eventos arquivados. Não é compatível com eventos ao vivo. |
| quality_seletor |
true , false OU 1,0 |
true | Se o menu seletor de qualidade é exibido. | O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
| skiping_forboard |
true , false OU 1,0 |
true | Se o usuário tem permissão para pular para frente durante a reprodução. | 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) |
Iniciar do vídeo (0m) |
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”. 💡 Dica: este parâmetro não requer um ponto de pergunta como todos os outros. |
Todos os vídeos |
| faixa de texto |
Um código de idioma em miniatura e, opcionalmente, o local e o tipo de faixa de texto. (Exemplos: "en", "en-US", "en.captions", "en.subtitles") |
Falso |
Exibe uma faixa de legendas/cc especificada por padrão no player, se disponível. Se você selecionar uma preferência de idioma que ainda não tenha sido carregada para o seu vídeo, a configuração da faixa de texto será ignorada, e o vídeo incorporado pode carregar com as closed captions (cc); legendas) 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 no site |
Mostra o título do vídeo. | Todos os vídeos |
| transparent |
true , false OU 1,0 |
true |
A configuração transparente estará ativa se a cor não tiver sido especificada por meio de uma configuração ou parâmetro. Normalmente, o fundo do iFrame do player do Vimeo é transparente por padrão. Se desativada, o fundo mudará para preto. Barras blacks ficarão visíveis no player quando a altura e a largura do iframe não corresponder à proporção original do vídeo, como, por exemplo, configurar o iFrame para 4:3 enquanto o vídeo original é 16:9. |
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. | O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
| unmut_Button |
true , false OU 1,0 |
true | Se o botão de ativar o som é exibido. | O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
| vimeo_logo |
true , false OU 1,0 |
true | Se o logotipo do Vimeo é exibido. | O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
| Volume |
true , false OU 1,0 |
true | Se o controle de volume é exibido. | O vídeo deve ser hospedado por uma conta Starter, Standard, Advanced, Plus, Pro, Business, Premium ou Enterprise. |
| watch_full_video |
true , false OU 1,0 |
true | Se o botão Assistir ao Vídeo completo aparece em vídeos no modo de reprodução segmentada. | Todos os vídeos no modo de reprodução segmentada. |