Resumen
Sección titulada “Resumen”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.
Soporte de plataformas
Sección titulada “Compatibilidad de plataformas”| Plataforma | Soporte | Notas |
|---|---|---|
| iOS | Sí | Nativo |
| Android | Sí | Nativo |
| Web | No | Protege con Capacitor.getPlatform() |
Funcionalidades principales
Sección titulada “Funcionalidades principales”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).
API pública
Sección titulada “API pública”| Método | Descripción |
|---|---|
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: normalmente se prefiere pauseVideo(). |
playVideo | Reproduce el video actualmente en cola o cargado. El estado final del reproductor será PLAYING (1). |
pauseVideo | Pausa el video en reproducción. El estado final del reproductor será PAUSED (2), a menos que ya esté en ENDED (0). |
seekTo | Salta a un momento específico del video. Si el reproductor está en pausa, sigue en pausa. Si se está reproduciendo, continúa reproduciéndose. |
loadVideoById | Carga y reproduce un video por su ID de YouTube. |
cueVideoById | Prepara un video por ID sin reproducirlo. Carga la miniatura y prepara el reproductor, pero no solicita el video hasta que se llama a playVideo(). |
loadVideoByUrl | Carga y reproduce un video por su URL completa. |
cueVideoByUrl | Prepara un video por URL sin reproducirlo. |
cuePlaylist | Prepara una playlist sin reproducirla. Carga la playlist y prepara el primer video. |
loadPlaylist | Carga y reproduce una playlist. |
nextVideo | Reproduce el siguiente video de la playlist. |
previousVideo | Reproduce el video anterior de la playlist. |
playVideoAt | Reproduce un video específico de la lista por su índice. |
mute | Silencia el audio del reproductor. |
unMute | Activa el audio del reproductor. |
isMuted | Comprueba si el reproductor está silenciado. |
setVolume | Establece el nivel de volumen del reproductor. |
getVolume | Obtiene el nivel de volumen actual del reproductor. Devuelve el volumen aunque el reproductor esté silenciado. |
setSize | Establece las dimensiones del reproductor en píxeles. |
getPlaybackRate | Obtiene la velocidad de reproducción actual. |
setPlaybackRate | Establece la velocidad de reproducción. |
getAvailablePlaybackRates | Obtiene la lista de velocidades disponibles para el video actual. |
setLoop | Activa o desactiva el bucle de la lista. Al activarlo, la lista se reinicia tras el último video. |
setShuffle | Activa o desactiva el modo aleatorio de la lista. |
getVideoLoadedFraction | Obtén la fracción del video que se ha cargado en el buffer. Más fiable que los métodos obsoletos getVideoBytesLoaded/getVideoBytesTotal. |
getPlayerState | Obtén el estado actual del reproductor. |
getAllPlayersEventsState | Obtén los estados de evento de todos los reproductores activos. Útil para trackear múltiples instancias. |
getCurrentTime | Obtén la posición actual de reproducción en segundos. |
toggleFullScreen | Activa o desactiva el modo pantalla completa. |
getPlaybackQuality | Obtén la calidad de reproducción actual. |
setPlaybackQuality | Establece la calidad de reproducción sugerida. La calidad real puede variar según la red. |
getAvailableQualityLevels | Obtén la lista de niveles de calidad disponibles para el video actual. |
getDuration | Obtén la duración del video actual en segundos. |
getVideoUrl | Obtén la URL de YouTube.com del video actual. |
getVideoEmbedCode | Obtén el code de inserción del video actual. Devuelve el code de iframe en HTML. |
getPlaylist | Obtén el array de IDs de video en la playlist actual. |
getPlaylistIndex | Obtén el índice del video que se está reproduciendo en la playlist. |
getIframe | Obtén el elemento DOM del iframe del player. Solo plataforma web. |
addEventListener | Añade un event listener al player. Solo plataforma web. |
removeEventListener | Elimina un event listener del player. Solo plataforma web. |
getPluginVersion | Obtén la versión del plugin. Devuelve información de la versión según la plataforma. |
Fuente de verdad
Sección titulada “Fuente de verdad”Esta referencia se sincroniza desde src/definitions.ts en capacitor-youtube-player.
Continuar con @capgo/capacitor-youtube-player
Sección titulada “Continuar con @capgo/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.