La API del reproductor de YouTube para Android te permite incorporar la funcionalidad de reproducción de video en las aplicaciones de Android. La API define métodos para cargar y reproducir videos de YouTube (y listas de reproducción) y para personalizar y controlar la experiencia de reproducción de video.
Al usar la API, puedes cargar o insertar videos en una vista de reproductor insertada en la interfaz de usuario de la aplicación. Puedes controlar la reproducción posteriormente de forma programática. Por ejemplo, puedes reproducir, pausar o buscar un punto específico en el video que está cargado.
También puedes registrar objetos de escucha de eventos para obtener devoluciones de llamada para ciertos eventos, por ejemplo, mientras el reproductor carga un video o el reproductor cambia de estado. Por último, la API tiene la función auxiliar de admitir los cambios de orientación, así como las transiciones y la reproducción en pantalla completa.
Cómo funciona
La biblioteca cliente de API interactúa con un servicio que se distribuye como parte de la aplicación de YouTube para la plataforma Android. La biblioteca cliente es deja una huella moderada, lo que significa que no repercutirá negativamente en el tamaño del archivo de tu aplicación si utilizas ProGuard como parte de tu proceso de compilación.
A medida que la API se desarrolla, serás capaz de acceder a las funciones de API más recientes al actualizar a una nueva versión de la biblioteca cliente de API. Sin embargo, la actualización no es necesaria si no estás interesado en las nuevas características o en las correcciones de errores.
Además, la aplicación de YouTube está disponible a través de Google Play Store, lo que significa que las actualizaciones del servicio de API no dependen del proveedor ni de las actualizaciones de imágenes de sistema OEM. En general, los dispositivos con Android 2.2 (Froyo) o posteriores que tienen instalados la aplicación Google Play Store recibirán actualizaciones a los pocos días. Como resultado, la aplicación puede utilizar la API del reproductor de YouTube para Android y llegar a la mayoría de los dispositivos en el ecosistema Android.
Nota: Los usuarios deben ejecutar la versión 4.2.16 (o superior) de la aplicación de YouTube para dispositivos móviles para poder utilizar la API.
Cómo empezar
Los siguientes documentos te ayudarán a configurar el entorno de desarrollo y el uso de la API del reproductor de YouTube para Android:
-
En la página de descarga se incluye un enlace para descargar la biblioteca de cliente API y JavaDocs.
-
Las instrucciones para registrar tu aplicación explican cómo registrar tu aplicación en la Consola de API de Google y obtener una clave de API para Android, la cual necesitarás para utilizar la API.
-
Las instrucciones de instalación explican cómo configurar un proyecto de API mediante Eclipse o IntelliJ.
-
La descripción general de las aplicaciones de ejemplo detalla las aplicaciones de ejemplo incluidas en la descarga de la API.
-
La referencia JavaDoc define de forma detallada las interfaces, categorías, métodos y enumeraciones de la API.