Este documento fornece informações de referência sobre o player sem cromo do YouTube.

Sumário

Visão geral

O player sem cromo do YouTube fornece aos desenvolvedores flexibilidade para personalizarem o player do YouTube com seus próprios controles, "cromos" e até mesmo comportamentos como listas de reprodução e menus personalizados.

Requisitos

O usuário final deve ter o Flash Player 8 ou superior instalado. Devido a este requisito, sugerimos o uso do SWFObject para incorporar o SWF e detectar a versão do Flash Player do usuário.

Primeiros passos

Em primeiro lugar, você precisa de uma chave de desenvolvedor. Para se registrar e obter uma, visite a página de registro.

O player sem cromo é composto por dois arquivos SWF. O arquivo apiplayer.SWF contém a funcionalidade de reprodução de vídeo propriamente dita. O arquivo cl.SWF é um carregador de SWF que carrega o apiplayer.SWF e expõe as funções da API do player. Ele também fornece restrições de segurança da sandbox para o apiplayer.SWF, de modo que o carregamento de SWFs não pode acessar elementos diretamente dentro do player.

O player pode ser controlado por meio de dois métodos: carregando o SWF em outro SWF (ou em um site Flash, etc.) ou incorporando-o diretamente em uma página HTML e usando o JavaScript para controlar o player. Os controles JavaScript são idênticos aos da API JavaScript do player incorporado.

O URL para carregar o SWF do player sem cromo é:

http://gdata.youtube.com/apiplayer?key=DEV_KEY

Funções

As seguintes operações estão disponíveis além das listadas na documentação da API JavaScript.

loadVideoById(videoId:String, startSeconds:Number):Void

Carrega o vídeo especificado e inicia a reprodução do vídeo. Se startSeconds (o número pode ser decimal) for especificado, o vídeo começará a partir do keyframe mais próximo do tempo especificado.

cueVideoById(videoId:String, startSeconds:Number):Void

Carrega a miniatura do vídeo especificado e prepara o player para a reprodução do vídeo. O player não solicita o FLV até playVideo() ou seekTo() ser chamado. startSeconds aceita um número decimal/inteiro e especifica o momento em que a reprodução do vídeo deve começar a partir do momento em que playVideo() é chamado. Se você especificar startSeconds e chamar seekTo(), o startSeconds será esquecido e o player reproduzirá o vídeo a partir do momento especificado na chamada de seekTo(). Quando o vídeo é preparado e está pronto para ser reproduzido, o player transmite um evento de aviso de vídeo (5).

setSize(width:Number, height:Number):Void

Define o tamanho do player sem cromo. Este método deve ser usado para definir a largura + altura do MovieClip diretamente. Este método não limita as proporções do player de vídeo, de modo que você talvez precise manter a proporção 4:3. Ao incorporar o player diretamente no HTML, o tamanho é atualizado automaticamente para os valores Stage.width e Stage.height, de modo que não é necessário chamar setSize() durante a incorporação do player sem cromo diretamente em uma página HTML. O tamanho padrão do SWF ao ser carregado em outro SWF é 320 pixels x 240 pixels.

Exemplos

Uso da API JavaScript

Ao incorporar o player sem cromo em uma página HTML, ative a API JavaScript anexando uma variável ao URL do SWF:

http://gdata.youtube.com/apiplayer?key=dev_key&enablejsapi=1

Para obter uma lista dos métodos de API disponíveis e exemplos de uso da API JavaScript, consulte a documentação de referência.

Há um exemplo do player sem cromo usando a API JavaScript disponível aqui.

Carregamento do player em outro SWF

Para obter informações sobre como carregar o player sem cromo em outro SWF, consulte a documentação do ActionScript 2.0. Todas as chamadas de API são iguais, incluindo as destacadas acima.

Voltar ao início