Gerador de código de incorporação do YouTube
Cole o link de um vídeo, Short ou playlist, escolha as opções e copie um código de incorporação limpo, com início e fim, modo de privacidade aprimorada e tamanho responsivo. Funciona inteiramente no seu navegador.
Este gerador de código de incorporação do YouTube monta o HTML para colocar um vídeo, Short ou playlist do YouTube no seu site, com opções que a caixa Compartilhar → Incorporar do próprio YouTube não oferece. Defina um tempo de início e de fim, autoplay (inclusive o autoplay sem som que os navegadores permitem), loop, legendas, modo de privacidade aprimorada e um tamanho responsivo que se ajusta a qualquer tela; depois copie o código e cole na sua página. Uma prévia ao vivo mostra o player enquanto você configura. Tudo acontece no seu navegador: nada é enviado ao Marqly, e cada opção corresponde a um parâmetro documentado na referência oficial do player do YouTube.
Como incorporar um vídeo do YouTube no seu site
- Copie o link do vídeo no YouTube: uma página de vídeo, Short, transmissão ao vivo, link youtu.be ou um link de playlist que contenha
list=. - Cole acima. Se o link incluir uma marcação de tempo como
?t=90, o tempo de início é preenchido. - Escolha as opções. O código e a prévia são atualizados na hora.
- Pressione Copiar código e cole no HTML da sua página: no WordPress, use um bloco de HTML personalizado; na maioria dos construtores de sites, um elemento Incorporar ou HTML.
Cada opção e o parâmetro por trás dela
| Opção | Parâmetro | O que faz |
|---|---|---|
| Começar em | start | Inicia a reprodução neste número de segundos do vídeo. O player vai para o quadro-chave mais próximo, que pode ficar até cerca de dois segundos antes. |
| Terminar em | end | Para a reprodução neste tempo, contado desde o início do vídeo, e não desde o seu tempo de início. |
| Autoplay | autoplay=1 | Inicia o vídeo quando o player carrega. O YouTube observa que a coleta de dados de reprodução passa a ocorrer no carregamento da página. |
| Loop | loop=1 | Repete uma playlist; para um vídeo único, o YouTube também precisa de playlist com o mesmo ID do vídeo, o que o gerador adiciona. |
| Mostrar controles do player | controls=0 quando desligado | Esconde a barra de controles. |
| Botão de tela cheia | fs=0 quando desligado | Esconde o botão de tela cheia. |
| Legendas ativadas por padrão | cc_load_policy=1 | Mostra as legendas por padrão, quando o vídeo as tem. |
| Sugestões do mesmo canal | rel=0 | Limita os vídeos relacionados exibidos no final ao mesmo canal. |
| Reproduzir na página no iPhone | playsinline=1 | Reproduz dentro da página no iOS em vez de pular para a tela cheia. |
| Desativar controles pelo teclado | disablekb=1 | Desliga atalhos como k para pausar e j/l para pular 10 segundos. |
| Barra de progresso branca | color=white | Pinta de branco, em vez de vermelho, a parte já assistida da barra de progresso. |
| Modo de privacidade aprimorada | youtube-nocookie.com | Usa o domínio de incorporação com privacidade aprimorada do YouTube (veja abaixo). |
Tempos de início e de fim
O player do YouTube recebe os tempos de início e de fim em segundos inteiros, então o gerador converte o que você digitar (90, 1:30, 1:02:03 ou 1h2m3s) em segundos. Os dois são medidos desde o começo do vídeo: para tocar o trecho de 1:30 a 2:00, informe início 1:30 e fim 2:00, não fim 0:30. Para compartilhar um momento como link, e não como incorporação, use o gerador de link do YouTube com marcação de tempo.
Por que vídeos incorporados não tocam sozinhos, e a solução
Os navegadores decidem se um vídeo pode começar sozinho. A documentação da API IFrame do YouTube lista a reprodução com som e sem interação do usuário entre os casos que os navegadores bloqueiam, entãoautoplay=1 sozinho muitas vezes não faz nada. A abordagem confiável é começar sem som: escolha Autoplay sem som (API JavaScript) e o gerador produz uma incorporação mais um script curto que carrega a API oficial IFrame Player do YouTube, silencia o player quando ele está pronto e inicia a reprodução. Os visitantes podem ativar o som com um clique.
As regras do YouTube para clientes da API acrescentam duas condições que vale respeitar: o player não deve começar a tocar automaticamente até que mais da metade dele esteja visível na tela, e uma página não deve ter mais de um player do YouTube tocando automaticamente ao mesmo tempo. Um vídeo de destaque no topo da página é aceitável; um vídeo com autoplay lá embaixo, não.
Modo de privacidade aprimorada (youtube-nocookie.com)
O modo de privacidade aprimorada troca www.youtube.com porwww.youtube-nocookie.com na URL de incorporação. A central de ajuda do YouTube diz que ele impede que as visualizações do vídeo incorporado influenciem a experiência de navegação do espectador no YouTube, exibe anúncios não personalizados e evita que essas visualizações personalizem anúncios mostrados ao espectador fora do seu site. Aqui ele vem ligado por padrão porque não custa nada. O que ele não é: uma promessa de que a incorporação não define cookies nem faz rastreamento, e ele não torna, por si só, uma incorporação compatível com nenhuma lei de privacidade; cite o YouTube na sua política de privacidade e na configuração de consentimento de qualquer forma.
Incorporações responsivas do YouTube, inclusive Shorts
O iframe padrão tem tamanho fixo de 560 × 315, que estoura em celulares. Com Responsivoligado, o código define o player com 100% da largura do contêiner e usa a propriedade CSSaspect-ratio para manter o formato, sem precisar de contêiner com padding-bottom em nenhum navegador atual. Escolha 9:16 para Shorts, para que o vídeo vertical não fique com tarjas; o campo de largura define até onde ele pode crescer. O YouTube exige que os players incorporados tenham pelo menos 200 × 200 pixels e recomenda pelo menos 480 × 270 para players 16:9; por isso o gerador não desce de 200 pixels de largura.
Incorporações com carregamento ao clicar para páginas mais rápidas
Um iframe do YouTube carrega o player completo assim que a página carrega, o que pesa em uma página com um vídeo que a maioria dos visitantes nunca toca. A saída Carregar ao clicarmostra a miniatura do vídeo com um botão de reproduzir e só troca pelo player de verdade quando alguém clica (ou pressiona Enter), e então inicia a reprodução. A velocidade da página melhora, e nada é solicitado ao player até o visitante decidir assistir. Funciona para vídeos únicos; playlists usam o iframe padrão.
Parâmetros que não funcionam mais
modestbrandingestá obsoleto e não tem efeito; o YouTube agora decide a marca pelo tamanho do player e por outros sinais. Geradores que ainda o oferecem estão desatualizados.showinfofoi descontinuado em 2018 e removido da documentação.rel=0não desliga os vídeos relacionados desde 25 de setembro de 2018: só os limita ao mesmo canal.controls=2está obsoleto; use 0 ou 1.
Resolvendo problemas de uma incorporação quebrada
- Erro 153 ou player em branco. O YouTube exige que as incorporações identifiquem o site em que estão pelo cabeçalho HTTP Referer e recomenda a política de referência
strict-origin-when-cross-origin. O código gerado define essa política; se o seu site enviano-referrerglobalmente, o player pode falhar. - “Vídeo indisponível.” O dono pode ter desativado a incorporação desse vídeo, ou ele é privado, foi excluído ou está bloqueado no país do visitante. Só o dono pode mudar isso.
- O player aparece cortado ou minúsculo. Um elemento pai com altura fixa ou
overflow: hiddenestá cortando o player; com Responsivo ligado, dê uma largura ao contêiner e deixe a altura acompanhar. - O loop não repete. Para um vídeo único, a URL precisa incluir
playlist=com o mesmo ID do vídeo: copie o código gerado em vez de adicionarloop=1à mão.
Outras ferramentas do YouTube
Encontre o momento certo para começar com a ferramenta de transcrição do YouTube, adicione capítulos a incorporações longas com ogerador de capítulos ou baixe uma imagem de capa personalizada com o baixador de miniaturas. Vai incorporar um curso inteiro? Acalculadora de duração de playlistmostra aos visitantes quanto tempo ele dura.
Perguntas frequentes
Como incorporar um vídeo do YouTube que começa em um momento específico?
Digite o tempo de início no gerador, em segundos, M:SS, H:MM:SS ou 1m30s, e copie o código. Ele adiciona o parâmetro start à URL de incorporação em segundos, que é o formato que o player do YouTube espera. Se o link que você colar já tiver uma marcação t=, o tempo de início é preenchido para você.
Por que o meu vídeo incorporado do YouTube não toca sozinho?
A maioria dos navegadores bloqueia vídeos que tocam com som antes de o visitante interagir com a página. A documentação para desenvolvedores do YouTube lista a reprodução com som e sem interação do usuário como um dos casos que os navegadores bloqueiam. Use a saída Autoplay sem som (API JavaScript), que inicia o player no mudo.
Como deixar uma incorporação do YouTube responsiva?
Deixe a opção Responsivo ligada. O código define o player com a largura total do contêiner e usa a propriedade CSS aspect-ratio para manter 16:9 (ou 9:16 nos Shorts), de modo que ele se ajusta a qualquer tela sem gambiarra de contêiner.
O que faz o modo de privacidade aprimorada?
Ele troca a incorporação para o domínio youtube-nocookie.com. Segundo a central de ajuda do YouTube, as visualizações do vídeo incorporado deixam de influenciar a experiência de navegação do espectador no YouTube e de personalizar anúncios exibidos fora do seu site. Isso não torna a incorporação livre de rastreamento, então mantenha o YouTube citado na sua política de privacidade.
Como repetir um único vídeo do YouTube em loop?
Marque Loop. Para um vídeo único, o YouTube exige o parâmetro playlist com o mesmo ID do vídeo, além de loop=1; o gerador adiciona os dois para você.
Dá para esconder os vídeos relacionados no final?
Não por completo. Desde setembro de 2018, rel=0 não esconde mais os vídeos relacionados: ele só os limita a vídeos do mesmo canal. A opção Sugestões só do mesmo canal do gerador define isso.
Posso incorporar uma playlist?
Pode. Cole o link de uma playlist (ele contém list=). O gerador monta uma incorporação de playlist e, se o seu link também apontar para um vídeo específico, o player começa por ele.
