Saltar al contenido

@capgo/capacitor-youtube-player

Incrusta videos de YouTube con control total del reproductor API y gestión de eventos

Incrusta videos de YouTube con control total del reproductor API y gestión de eventos

Comienza con initialize() y los demás métodos principales detallados 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 y cancela la carga. Úsalo con moderación; suele ser mejor usar pauseVideo().
  • playVideo - Reproduce el video en cola o cargado. 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 y cancela la carga. Úsalo con moderación; normalmente es mejor pauseVideo().
playVideoReproduce el video actualmente en cola o cargado. El estado final del reproductor será PLAYING (1).
pauseVideoPausa el video que se está reproduciendo. 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 llame 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 playlist 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. 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.
getAvailablePlaybackRatesObtén la lista de velocidades de reproducción disponibles para el video actual.
setLoopActiva o desactiva el bucle de la playlist. Si se activa, la playlist se reiniciará desde el principio al terminar el último video.
setShuffleActiva o desactiva el modo aleatorio de la playlist.
getVideoLoadedFractionObtén la fracción del video que se ha almacenado 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 eventos de todos los reproductores activos. Útil para rastrear múltiples instancias de reproductores.
getCurrentTimeObtén la posición actual de reproducción en segundos.
toggleFullScreenActiva o desactiva el modo de pantalla completa.
getPlaybackQualityObtén la calidad de reproducción actual.
setPlaybackQualityEstablece la calidad de reproducción sugerida. La calidad real puede variar según las condiciones de 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 embed code del video actual. Devuelve el iframe HTML de embed code.
getPlaylistObtén el array de IDs de video de 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 en web.
addEventListenerAñade un event listener al player. Solo en web.
removeEventListenerElimina un event listener del player. Solo en web.
getPluginVersionObtén el número de 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 con plugins nativos, 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 del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para el detalle de implementación en los Plugins de Capacitor por Capgo, Añadir o actualizar plugins para el detalle de implementación en Agregar o actualizar plugins, y Alternativas a plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas a plugins de Ionic Enterprise.