Saltar al contenido

@capgo/capacitor-youtube-player

Incrusta videos de YouTube con control total de la API y manejo de eventos

Incrusta videos de YouTube con control total de la API y manejo de eventos

Empieza con initialize() y los demás métodos principales listados abajo.

PlataformaSoporteNotas
iOSSíNativo
AndroidSíNativo
WebNoProtege con Capacitor.getPlatform()
  • initialize - Inicializa una nueva instancia del reproductor de YouTube.
  • destroy - Destruye una instancia del reproductor y libera recursos.
  • stopVideo - Detiene la reproducción del video y cancela la carga. Úsalo con moderación; suele ser mejor usar pauseVideo().
  • playVideo - Reproduce el video cargado o en cola. El estado final del reproductor será PLAYING (1).
MétodoDescripción
initializeInicializa una nueva instancia del reproductor de YouTube.
destroyDestruye una instancia del reproductor y libera recursos.
stopVideoDetiene la reproducción del video y cancela la carga. Úsalo con moderación: normalmente se prefiere pauseVideo().
playVideoReproduce el video actualmente en cola o cargado. El estado final del reproductor será PLAYING (1).
pauseVideoPausa el video en reproducción. El estado final del reproductor será PAUSED (2), a menos que ya esté en ENDED (0).
seekToSalta a un momento específico del video. Si el reproductor está en pausa, sigue en pausa. Si se está reproduciendo, continúa reproduciéndose.
loadVideoByIdCarga y reproduce un video por su ID de YouTube.
cueVideoByIdPrepara un video por ID sin reproducirlo. Carga la miniatura y prepara el reproductor, pero no solicita el video hasta que se llama a playVideo().
loadVideoByUrlCarga y reproduce un video por su URL completa.
cueVideoByUrlPrepara un video por URL sin reproducirlo.
cuePlaylistPrepara una playlist sin reproducirla. Carga la playlist y prepara el primer video.
loadPlaylistCarga y reproduce una playlist.
nextVideoReproduce el siguiente video de la playlist.
previousVideoReproduce el video anterior de la playlist.
playVideoAtReproduce un video específico de la lista por su índice.
muteSilencia el audio del reproductor.
unMuteActiva el audio del reproductor.
isMutedComprueba si el reproductor está silenciado.
setVolumeEstablece el nivel de volumen del reproductor.
getVolumeObtiene el nivel de volumen actual del reproductor. Devuelve el volumen aunque el reproductor esté silenciado.
setSizeEstablece las dimensiones del reproductor en píxeles.
getPlaybackRateObtiene la velocidad de reproducción actual.
setPlaybackRateEstablece la velocidad de reproducción.
getAvailablePlaybackRatesObtiene la lista de velocidades disponibles para el video actual.
setLoopActiva o desactiva el bucle de la lista. Al activarlo, la lista se reinicia tras el último video.
setShuffleActiva o desactiva el modo aleatorio de la lista.
getVideoLoadedFractionObtén la fracción del video que se ha cargado en el buffer. Más fiable que los métodos obsoletos getVideoBytesLoaded/getVideoBytesTotal.
getPlayerStateObtén el estado actual del reproductor.
getAllPlayersEventsStateObtén los estados de evento de todos los reproductores activos. Útil para trackear múltiples instancias.
getCurrentTimeObtén la posición actual de reproducción en segundos.
toggleFullScreenActiva o desactiva el modo pantalla completa.
getPlaybackQualityObtén la calidad de reproducción actual.
setPlaybackQualityEstablece la calidad de reproducción sugerida. La calidad real puede variar según la red.
getAvailableQualityLevelsObtén la lista de niveles de calidad disponibles para el video actual.
getDurationObtén la duración del video actual en segundos.
getVideoUrlObtén la URL de YouTube.com del video actual.
getVideoEmbedCodeObtén el code de inserción del video actual. Devuelve el code de iframe en HTML.
getPlaylistObtén el array de IDs de video en la playlist actual.
getPlaylistIndexObtén el índice del video que se está reproduciendo en la playlist.
getIframeObtén el elemento DOM del iframe del player. Solo plataforma web.
addEventListenerAñade un event listener al player. Solo plataforma web.
removeEventListenerElimina un event listener del player. Solo plataforma web.
getPluginVersionObtén la versión del plugin. Devuelve información de la versión según la plataforma.

Esta referencia se sincroniza desde src/definitions.ts en capacitor-youtube-player.

Si estás usando @capgo/capacitor-youtube-player para planificar el trabajo del plugin nativo, conéctalo con Uso de @capgo/capacitor-youtube-player para la capacidad nativa en Uso de @capgo/capacitor-youtube-player, Directorio de plugins de Capgo para el flujo de trabajo de productos en el Capgo Plugin Directory, Plugins de Capacitor por Capgo para los detalles de implementación en Plugins de Capacitor por Capgo, Añadir o actualizar plugins para el detalle de implementación en Agregar o actualizar plugins, y Alternativas a los plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas a plugins de Ionic Enterprise.