java.lang.Object | ||
↳ | android.app.Fragment | |
↳ | com.google.android.youtube.player.YouTubePlayerFragment |
Descripción general
Fragmento que contiene un YouTubePlayerView
. El uso de este fragmento es la forma preferida
para reproducir videos de YouTube, ya que la actividad no necesita extender una actividad proporcionada por
la biblioteca, como cuando se usa YouTubePlayerView
directamente.
Para comenzar, ubica esta vista en tu jerarquía de vistas e invoca a
initialize(String, OnInitializedListener)
para crear un YouTubePlayer
, el que puedes
usar para subir videos en este fragmento.
Este fragmento guardará y restaurará el estado del YouTubePlayer
asociado como
parte del flujo onSaveInstanceState
/onRestoreInstanceState
. Consulta la
documentación de YouTubePlayer
para obtener más información.
El YouTubePlayer
asociado con este fragmento se liberará cada vez que su método
onDestroyView()
se invoque. Por lo tanto, deberás volver a invocar initialize(String, YouTubePlayer.OnInitializedListener)
cada vez que la actividad asociada con este fragmento se vuelva a crear, aunque la instancia del fragmento
se conserve durante la recreación de la actividad mediante la configuración de setRetainInstance(boolean)
.
Te recomendamos que te hagas cargo manualmente de los cambios de la configuración causados por la orientación de la actividad,
de modo que no sea necesario volver a crear esta vista cada vez que cambie la configuración. Para
obtener la mejor experiencia de usuario, también debe manejar manualmente el evento a pantalla completa mediante el cambio del
diseño de la actividad. Consulta FULLSCREEN_FLAG_CUSTOM_LAYOUT
para obtener más
información.
Ten en cuenta que durante la reproducción de los videos, el tamaño mínimo de esta vista será de 200 x 110 dp. Si reduces el tamaño de la vista, los videos automáticamente se dejarán de reproducir. Además, no se permite superponer la vista de este fragmento con otras vistas mientras se reproduce un video.
Si la plataforma a la que apuntas no es compatible con los fragmentos, usa
YouTubePlayerSupportFragment
.
Resumen
Constantes heredadas | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Constructores públicos | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
YouTubePlayerFragment()
Crea un fragmento de YouTube.
|
Métodos públicos | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
void |
initialize(String developerKey, YouTubePlayer.OnInitializedListener listener)
Iniciar un
YouTubePlayer que se puede utilizar para reproducir y controlar la reproducción de videos. | ||||||||||
static YouTubePlayerFragment |
newInstance()
Crea un fragmento de YouTube.
|
Métodos heredados | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Constructores públicos
public YouTubePlayerFragment ()
Crea un fragmento de YouTube. Este constructor es público solo para su uso por parte de un inflador. Usa
newInstance()
para crear programáticamente un YouTubePlayerFragment
.
Métodos públicos
public void initialize (String developerKey, YouTubePlayer.OnInitializedListener listener)
Inicia un YouTubePlayer
que se puede utilizar para reproducir y controlar videos. Se invocará una de las devoluciones de llamada de listener
cuando la inicialización
sea correcta o incorrecta.
Parámetros
developerKey | Clave válida de API habilitada para usar el servicio de la versión 3 de la API de datos de YouTube. Para generar una nueva clave, visita la consola de API de Google. |
objeto de escucha | Devoluciones de llamada que se realizarán cuando la inicialización sea correcta o incorrecta. |