O reprodutor de incorporação do YouTube aceita uma longa lista de parâmetros de URL que controlam quase tudo sobre o aspeto e o comportamento de um vídeo assim que está na sua página. Esta referência reúne os que realmente importam, com explicações em linguagem simples e exemplos.
Como funcionam os parâmetros
Cada parâmetro é adicionado ao URL de incorporação como um valor de query string, unido com um E comercial: https://www.youtube-nocookie.com/embed/VIDEO_ID?param1=value¶m2=value. Pode combinar quantos precisar. Os parâmetros que esperam um valor booleano 1 ou 0 usam 1 para “ligado” e 0 para “desligado”; salvo indicação contrária, deixar um parâmetro de fora usa o comportamento predefinido do próprio YouTube.
Parâmetros de controlo de reprodução
| Parâmetro | Valores | O que faz |
|---|---|---|
| autoplay | 0 ou 1 | Inicia a reprodução automaticamente. A maioria dos navegadores exige mute=1 em conjunto. |
| mute | 0 ou 1 | Inicia o reprodutor sem som. Necessário na maioria dos navegadores para a reprodução automática funcionar. |
| start | segundos | Inicia a reprodução no número de segundos indicado do vídeo. |
| end | segundos | Para a reprodução no número de segundos indicado. |
| loop | 0 ou 1 | Repete o vídeo. Para um único vídeo, adicione também playlist=VIDEO_ID (o mesmo ID) ou o ciclo não funcionará. |
| controls | 0 ou 1 | Mostra (1, predefinido) ou oculta (0) a barra de controlos do reprodutor. |
Parâmetros de apresentação e disposição
| Parâmetro | Valores | O que faz |
|---|---|---|
| rel | 0 ou 1 | Quando é 0, as sugestões de vídeos relacionados mostradas no final ficam limitadas ao mesmo canal. |
| modestbranding | 0 ou 1 | Reduz a presença do logótipo do YouTube nos controlos do reprodutor (o suporte varia consoante a versão do reprodutor). |
| fs | 0 ou 1 | Ativa (1, predefinido) ou desativa (0) o botão de ecrã inteiro. |
| cc_load_policy | 0 ou 1 | Força a exibição de legendas por predefinição quando definido como 1. |
| hl | código de idioma | Define o idioma da interface do reprodutor, por exemplo hl=pt. |
| color | red ou white | Define a cor da barra de progresso do vídeo. |
Parâmetros de listas de reprodução e multivídeo
| Parâmetro | Valores | O que faz |
|---|---|---|
| list | ID da lista de reprodução | Carrega uma lista de reprodução inteira. Combine com o caminho /embed/videoseries em vez de um ID de vídeo único. |
| listType | playlist, user_uploads | Altera a forma como o parâmetro list é interpretado. |
| index | número | Em que item da lista de reprodução iniciar, contando a partir de 0. |
Exemplos práticos
Respeitador da privacidade, responsivo, começa aos 90 segundos, sem vídeos relacionados:
https://www.youtube-nocookie.com/embed/VIDEO_ID?start=90&rel=0Vídeo de fundo com reprodução automática sem som, controlos ocultos, em ciclo:
https://www.youtube-nocookie.com/embed/VIDEO_ID?autoplay=1&mute=1&controls=0&loop=1&playlist=VIDEO_IDExcerto que reproduz apenas entre os 30 e os 90 segundos:
https://www.youtube-nocookie.com/embed/VIDEO_ID?start=30&end=90Uma lista de reprodução inteira, a começar no terceiro vídeo:
https://www.youtube-nocookie.com/embed/videoseries?list=PLAYLIST_ID&index=2Parâmetros que já não funcionam
Alguns parâmetros mais antigos que costumavam aparecer em tutoriais de incorporação, como showinfo e disablekb, foram removidos ou descontinuados pelo YouTube ao longo dos anos. Se um parâmetro encontrado num artigo antigo não tiver qualquer efeito visível, é geralmente por isso: o reprodutor do YouTube mudou e o parâmetro é simplesmente ignorado.
Uma nota sobre fiabilidade
Alguns parâmetros relacionados com a apresentação, como modestbranding, são aplicados com base no melhor esforço e o seu efeito visual exato pode variar à medida que o YouTube atualiza o seu reprodutor. Os parâmetros de controlo de reprodução (start, end, autoplay, mute, loop, controls) são os mais consistentemente fiáveis e os que vale a pena usar como base da sua estratégia de incorporação.
Construa-o sem memorizar nada disto
Não precisa de escrever estas query strings à mão. O nosso gerador de código de incorporação gratuito disponibiliza os parâmetros mais úteis, hora de início, hora de fim, reprodução automática, som desligado, ciclo, controlos ocultos, modo de privacidade, formato Shorts e listas de reprodução, como simples interruptores e campos, e monta automaticamente o URL correto. Use esta página como referência quando quiser perceber exatamente o que um embed gerado está a fazer, ou quando precisar de um parâmetro que o gerador não disponibiliza e queira acrescentá-lo ao código manualmente.
Leitura relacionada
Para o lado da disposição da incorporação, veja o nosso guia sobre embeds responsivos do YouTube. Para o lado da privacidade, veja incorporar vídeos do YouTube sem cookies.