Nesta página são mostradas as funções da API do Player do YouTube. É necessário que os players incorporados tenham uma Janela de visualização de pelo menos 200 px por 200 px. Se o player mostra controles, ele tem que ser grande o suficiente para exibir completamente os controles sem encolher a Janela visualização abaixo do tamanho mínimo. Recomendamos que players de 16:9 tenham pelo menos 480 pixels de largura e 270 pixels de altura.

Código de Incorporação de IFrame

Conteúdo Você pode escolher carregar ou inserir conteúdo no player. Se você seleciona uma opção para carregar conteúdo e atualiza o player, ele reproduzirá o conteúdo especificado em vez do vídeo que já estiver sendo reproduzido.

Se você seleciona uma opção para inserir conteúdo e atualiza o player, ele carrega o vídeo, mas não o reproduz. Para reproduzir o vídeo, é necessário clicar no link Reproduzir na seção de controles do player ou no próprio player do vídeo.

Dependendo de sua seleção, esta página chama uma das seguintes funções de API:
  • loadVideoById
  • loadVideoByUrl
  • loadPlaylist
  • cueVideoById
  • cueVideoByUrl
  • cuePlaylist
 
 
Controles Com os controles nesta seção, é possível reproduzir, pausar ou parar um vídeo.

Para ir até um ponto específico no vídeo, insira um número no campo Ir para, que especifica o ajuste do horário, em segundos, de quando reprodução deve começar a partir do início do vídeo.
   
Volume Os controles de ativação e desativação de som ligam ou desligam o volume. O campo Ligar/desligar volume na seção Estatísticas indica se o som do player foi desativado.

Você pode ajustar o volume do player ao inserir um número entre 0 e 100 no campo Definir volume. Aperte "Tab" ou clique fora da caixa de entrada para atualizar o volume.
Desativar som | Ativar som | Definir:   (0-100) [ nível atual:  --]
Qualidade Use este menu suspenso para chamar a função setPlaybackQuality() e altere a qualidade do vídeo que está sendo reproduzido. Quando você altera a qualidade, o vídeo pausa e recomeça do início.

No campo Níveis disponíveis na seção Estaísticas estão listados os níveis de qualidade para este vídeo.

Se você seleciona um nível de qualidade que está indisponível, o YouTube seleciona o nível mais adequado disponível. Por exemplo, se você definir a qualidade como baixa, mas os níveis suportados são mediana e alta, o YouTube define a qualidade como mediana.
Rate O rate de reprodução identifica a velocidade em que o vídeo é reproduzido. A função getAvailablePlaybackRates() retorna o conjunto de rates de reprodução em que o vídeo atual está disponível. Nesta demonstração, as rates de reprodução disponíveis são mostradas na seção Estatísticas.

Um valor de 1 indica que o vídeo é reproduzido em velocidade normal.
   
Tamanho Nesta seção, é possível modificar o tamanho do player ao usar a função setSize(width, height). Geralmente, essa função é útil apenas em aplicativos ActionScript. Em um aplicativo JavaScript, o player redimensionado ainda é inserido no objeto que contém o player de vídeo, mesmo se esse objeto for menor ou maior que o player redimensionado.
 x 405   
Histórico Esta página chama as funções getVideoUrl() e getEmbedCode() quando o player está pronto para reproduzir um vídeo. Essas funções serão chamadas novamente se você carregar ou inserir um vídeo.

Se você chamar getVideoUrl() depois do vídeo ter sido reproduzido por pelo menos 10 segundos, o URL inclui um parâmetro que especifica o ajuste de horário em que o player deve começar a reproduzir o vídeo.
(limpar)
Erros
Nenhum ainda.

Eventos e chamadas de funções
Nenhum ainda.

Parâmetros do player
  • caixa selecionada = valor do parâmetro de 1
  • caixa não selecionada = valor do parâmetro de 0
  • Usar o Código Incorporado do IFrame para incorporar um player com as opções selecionadas.

Parâmetro Valor
autoplay  1 – O vídeo é reproduzido automaticamente quando o player é carregado.

0 (padrão) – O vídeo não é reproduzido automaticamente quando o player é carregado.
cc_load_policy  1 – Torna a exibição de closed captions padrão, mesmo se o usuário desativou as legendas. O comportamento padrão é baseado na preferência do usuário.
color Este parâmetro especifica a cor usada na barra de progresso do vídeo no player para mostrar a quantidade de vídeo que o espectador já viu. O valor padrão é vermelho.
controls  1 – (padrão) Exibe os controles do player de vídeo.

0 – Não exibe os controles do player de vídeo.
disablekb  1 – Desativa os controles de teclado do player.

0 (padrão) - Ativa os controles de teclado do player. Os controles de teclado são:
  • Barra de espaço: reproduzir/pausar
  • Seta para esquerda: voltar alguns segundos no vídeo atual.
  • Seta para direita: pular alguns segundos à frente no vídeo atual.
  • Seta para cima: aumentar o volume
  • Seta para baixo: diminuir o volume
enablejsapi  1 – Ativa o player que será controlado usando a API do Player de IFrame.

0 (padrão) - Não ativa a API.
end  O ajuste de horário em que a reprodução do vídeo deve parar. O valor é um número inteiro positivo que especifica o número de segundos no vídeo em que o player interrompe a reprodução.
fs  1 (padrão) - O player mostra um botão para ver um player de tela cheia.

0 – O botão não aparece no player.
hl  Define o idioma da interface do player. O valor do parâmetro é um código de idioma de duas letras do ISO 639-1 ou um localidade totalmente especificada, como fr ou fr-ca. Outros códigos de entrada de idioma, como tags de idioma IETF (BCP 47), também podem ser tratados de forma adequada.

O idioma da interface é utilizado para dicas no player e também afeta a faixa de legenda padrão.
iv_load_policy 1 (padrão) - Exibe anotações do vídeo. 3 – Não exibe anotações do vídeo.
list  Em conjunto com o parâmetro list, este parâmetro identifica o conteúdo que carrega no player.
  • playlist – O parâmetro list especifica um ID de playlist do YouTube. Certifique-se de que o valor do parâmetro começa com as letras PL.
  • search – O parâmetro list especifica o termo de consulta de pesquisa usado para selecionar o conteúdo a ser reproduzido.
  • user_uploads – O parâmetro list especifica o canal do YouTube cujos vídeos enviados estão carregados.
listType Em conjunto com o parâmetro list, este parâmetro identifica o conteúdo que carrega no player.
  • search – O parâmetro list especifica o termo de consulta de pesquisa usado para selecionar o conteúdo a ser reproduzido.
  • user_uploads – O parâmetro list especifica o canal do YouTube cujos vídeos enviados estão carregados.
  • playlist – O parâmetro list especifica um ID de playlist do YouTube. Certifique-se de que o valor do parâmetro começa com as letras PL.
loop  1 – Se o player está carregando um único vídeo, reproduz o vídeo repetidamente. Se o player está carregando uma playlist, reproduz a playlist inteira e começa novamente no primeiro vídeo.

0 (padrão) - Não reproduz o vídeo ou a playlist inteira continuamente.
modestbranding  1 – Evita que o logo do YouTube seja exibido na barra de controle. Um marcador ou marca d'água de texto do YouTube ainda é exibido quando o cursor do mouse do usuário passa por cima do player.

0 – Um logo do YouTube é exibido na barra de controle do player.
playlist  Uma lista separada com vírgulas de IDs do vídeos que são reproduzidos em sequência.
playsinline  1 – Causa reprodução in-line para UIWebViews criado com a propriedade allowsInlineMediaPlayback definida como TRUE.

0 (padrão) - Causa reprodução em tela cheia. Note que o valor padrão está sujeito a alteração.
start  O ajuste de horário em que o player deve começar a reproduzir o vídeo. O valor é um número inteiro positivo que especifica o número de segundos no vídeo em que o player deve começar. O player procura pelo keyframe mais próximo antes ou no horário especificado.
Estatísticas   As informações nesta seção descrevem o status do player de vídeo e do vídeo em execução (ou o último vídeo que foi reproduzido). A lista a seguir mostra a função da API associada a cada campo nesta seção:
  • Duração: getDuration()
  • Hora atual: getCurrentTime()
  • Estado do player: getPlayerState()
  • Percentual carregado do vídeo: getVideoLoadedFraction()
  • Bytes de início: getVideoStartBytes()
  • Nível de qualidade: getPlaybackQuality()
  • Níveis disponíveis: getAvailableQualityLevels()
  • Volume (ligado/desligado): isMuted()
  • Quantidade de vídeos na playlist: count(getPlaylist())
  • Posição do vídeo atual: getPlaylistIndex()
  • Vídeos na playlist: getPlaylist()
  • Bytes carregados: getVideoBytesLoaded() (suspenso)
  • Total de bytes: getVideoBytesTotal() (suspenso)

Duração: --:--
Hora atual: --:--
Estado do player: --
Bytes de início: --
% carregado do vídeo: --
Volume (ligado/desligado):
Rate de reprodução: --
Rates disponíveis:
Suspenso
Bytes carregados: --
Total de bytes: --