YouTube Android Player API

Com a API do Player do YouTube para Android, você pode incorporar a funcionalidade de reprodução de vídeo em seus aplicativos Android. A API define métodos para carregar e reproduzir vídeos (e playlists) do YouTube e personalizar e controlar a experiência de reprodução de vídeo.

Com a API, você pode carregar vídeos ou marcar vídeos em uma visualização do player integrada à interface do usuário de seu aplicativo para que você possa controlar a reprodução de forma programática. Você pode reproduzir, pausar, ou procurar um ponto específico do vídeo carregado no momento, por exemplo.

Você também pode registrar listener de eventos para receber retornos de chamada de determinados eventos, como o player carregando um vídeo ou uma alteração no estado do player. Finalmente, a API tem funcionalidade de ajuda para oferece suporte a mudanças na orientação, bem como transições para a reprodução em tela inteira.

Como funciona

A biblioteca cliente da API interage com um serviço distribuído como parte do aplicativo do YouTube para a plataforma Android. A biblioteca cliente tem uma pegada leve, ou seja, não impacta negativamente no tamanho do arquivo de seu aplicativo, se você usar o ProGuard como parte de seu processo de desenvolvimento.

Conforme a API é desenvolvida, você poderá acessar os recursos da API introduzidos recentemente fazendo a atualização para uma versão mais recente da biblioteca cliente da API. Entretanto, a atualização não é necessária se você não se interessa por novos recursos ou correções de bugs.

Além disso, o aplicativo do YouTube é fornecido pelo Google Play Store. Portanto, as atualizações para o serviço da API não dependem de atualizações da imagem do sistema da OEM ou operadora. De modo geral, os dispositivos com Android 2.2 (Froyo) ou versão posterior e o aplicativo Google Play Store instalado receberão atualizações em poucos dias. O aplicativo pode usar a API do Player do YouTube para Android e chegar à maioria dos dispositivos no ecossistema Android.

Observação: os usuários precisam executar a versão 4.2.16 (ou superior) do aplicativo do YouTube para celular para usar a API.

Primeiros passos

Os documentos a seguir ajudarão você a instalar seu ambiente de desenvolvimento e usar a API do Player do YouTube para Android:

  • A página de download tem um link para fazer o download da biblioteca cliente da API e JavaDocs.

  • As instruções para registrar seu aplicativo explicam como registrar o aplicativo no console de APIs do Google e receber uma chave da API do Android, que você precisará para usar a API.

  • As instruções de instalação explicam como configurar um projeto de API usando Eclipse ou IntelliJ.

  • A visão geral aplicativos de amostra descreve os aplicativos de amostra inclusos na API do download.

  • A referência JavaDoc oferece definições detalhadas das interfaces, classes, métodos e enumerações da API.