Saltar al contenido principal
Volver a plugins
@capgo/capacitor-youtube-player
Tutoriales
@capgo/capacitor-youtube-player

Reproductor de YouTube

Embed YouTube videos with full player API control and event handling

Guía

Tutorial de Reproductor de YouTube

Probar en dispositivo

Descargue la aplicación Capgo, luego escane el código QR code.

Enlace QR de vista previa del plugin de reproductor de YouTube code

Usando @capgo/capacitor-youtube-player

YouTube Player Plugin interface for Capacitor. Provides methods to control YouTube video playback in your app.

Instalar

bun add @capgo/capacitor-youtube-player
bunx cap sync

Qué se expone con este plugin

  • initialize - Inicializa una nueva instancia del reproductor de YouTube.
  • destroy - Destruye una instancia del reproductor y libera recursos.
  • stopVideo - Detiene la reproducción de video y cancela la carga. Utiliza esto con moderación - pauseVideo() es preferido generalmente.
  • playVideo - Reproduce el video actualmente programado o cargado. El estado final del reproductor será REPRODUCIENDO (1).

Parche de referente de WebView principal

Habilitar patchRefererHeader cuando el contenido de YouTube funciona en el plugin pero falla desde el WebView principal de Capacitor porque YouTube espera un navegador similar Referer encabezado.

{
  "plugins": {
    "YoutubePlayer": {
      "patchRefererHeader": true,
      "refererHeader": "https://www.youtube.com"
    }
  }
}

La corrección solo se aplica a youtube.com, youtube-nocookie.comy youtu.be solicitudes. Se preservan los encabezados de solicitud existentes, y Referer por defecto se establece en refererHeader cuando se omite. https://www.youtube.com Ejemplo de uso

Iniciar una nueva instancia del reproductor de YouTube.

initialize

Destruir una instancia del reproductor y liberar recursos.

import { YoutubePlayer } from '@capgo/capacitor-youtube-player';

await YoutubePlayer.initialize({
  playerId: 'my-player',
  videoId: 'dQw4w9WgXcQ',
  playerSize: { width: 640, height: 360 },
  privacyEnhanced: true
});

destroy

Detener la reproducción de video y cancelar la carga. Utilice esto con moderación - pauseVideo() es preferible en la mayoría de los casos.

import { YoutubePlayer } from '@capgo/capacitor-youtube-player';

await YoutubePlayer.destroy({} as PlayerIdOptions);

stopVideo

Stop video playback and cancel loading. Use this sparingly - pauseVideo() is usually preferred.

import { YoutubePlayer } from '@capgo/capacitor-youtube-player';

await YoutubePlayer.stopVideo({} as PlayerIdOptions);

playVideo

Reproducir el video actualmente cedido o cargado. El estado final del jugador será REPRODUCIENDO (1).

import { YoutubePlayer } from '@capgo/capacitor-youtube-player';

await YoutubePlayer.playVideo({} as PlayerIdOptions);

Referencia completa

Sigue adelante desde Usando @capgo/capacitor-reproductor-de-youtube

Si estás utilizando Usando @capgo/capacitor-reproductor-de-youtube para planificar el comportamiento de medios y interfaz nativa, conecta con @capgo/capacitor-reproductor-de-youtube para obtener detalles de implementación en @capgo/capacitor-reproductor-de-youtube Inicio rápido para los detalles de implementación en Getting Started, Usando @capgo/capacitor-actividades-en-vivo para la capacidad nativa en Usando @capgo/capacitor-actividades-en-vivo, @capgo/capacitor-actividades-en-vivo para los detalles de implementación en @capgo/capacitor-actividades-en-vivo, y Usando @capgo/capacitor-reproductor-de-videos para la capacidad nativa en Usando @capgo/capacitor-reproductor-de-videos.