Pasar al contenido principal

Reproductor de YouTube plugin de Capacitor

Inserte videos de YouTube con control completo del reproductor y manejo de eventos API

Instalar

bun add @capgo/capacitor-youtube-player bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-youtube-player
  • pnpm add @capgo/capacitor-youtube-player
  • yarn add @capgo/capacitor-youtube-player

Guía

How to use YouTube Player en Capacitor

Probar en dispositivo

Descarga la aplicación Capgo, luego escanea el código QR code.

YouTube Player plugin preview QR code

Usando @capgo/capacitor-youtube-player

Interfaz del plugin de YouTube Player para Capacitor. Proporciona métodos para controlar la reproducción de videos de YouTube en tu aplicación.

Instalar

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

¿Qué se expone en este plugin?

  • initialize - Inicialice una nueva instancia del reproductor de YouTube.
  • destroy - Destruir una instancia de reproductor y liberar recursos.
  • stopVideo Detener la reproducción de video y cancelar la carga. Utilízalo con moderación - detener la reproducción de video() es lo habitual.
  • playVideo - Reproducir 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 la WebView principal de Capacitor porque YouTube espera un navegador como Referer header.

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

La actualización solo se aplica a youtube.com, youtube-nocookie.com, and youtu.be solicitudes. Solicitud existente Referer Los encabezados se preservan, y refererHeader defaults a https://www.youtube.com cuando se omite.

Uso de Ejemplo

initialize

Inicialice una nueva instancia del reproductor de YouTube.

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

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

destroy

Destruir una instancia del reproductor y liberar recursos.

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

const result = await YoutubePlayer.destroy({ playerId: 'player-id-123' });
console.log(result);

stopVideo

Detener la reproducción de video y cancelar la carga. Utilice esto con moderación - pauseVideo() es preferido generalmente.

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

const result = await YoutubePlayer.stopVideo({ playerId: 'player-id-123' });
console.log(result);

playVideo

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

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

const result = await YoutubePlayer.playVideo({ playerId: 'player-id-123' });
console.log(result);

Referencia Completa

Continúa desde @capgo/capacitor-youtube-player

Si estás utilizando Utilizando @capgo/capacitor-youtube-player para planificar el comportamiento de medios y interfaz nativa, conecta con @capgo/capacitor-youtube-player para el detalle de implementación en @capgo/capacitor-youtube-player, Getting Started para el detalle de implementación en Inicio, Utilizando @capgo/capacitor-actividades-en-vivo para la capacidad nativa en Utilizando @capgo/capacitor-actividades-en-vivo, @capgo/capacitor-actividades-en-vivo para el detalle 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.

FAQ

Preguntas frecuentes del plugin de reproductor de YouTube

¿Cómo instalo el plugin de reproductor de YouTube en una aplicación Capacitor?

Ejecuta "bun add @capgo/capacitor-youtube-player" (o "npm install @capgo/capacitor-youtube-player"), luego ejecuta "bunx cap sync" para que los proyectos de iOS y Android capturen el nativo code. Importa desde "@capgo/capacitor-youtube-player" en tu aplicación code.

¿Funciona @capgo/capacitor-youtube-player con React, Vue y Angular?

Sí. El reproductor de YouTube es un paquete Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor soporta @capgo/capacitor-youtube-player?

Capgo los plugins siguen la versión mayor de Capacitor: utiliza la versión mayor del plugin que coincida con la versión mayor de Capacitor (por ejemplo, plugin v8 con Capacitor 8). La tabla de compatibilidad en el README del GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-youtube-player gratuito y de código abierto?

Sí. El código fuente de code está disponible en GitHub en https://github.com/Cap-go/capacitor-youtube-player/ y el paquete es gratuito para instalar desde npm. Se aceptan informes de errores y solicitudes de cambios.

¿Puedo actualizar code que utiliza el reproductor de YouTube sin una revisión de la Tienda?

Instalar o actualizar el plugin cambia el nativo code, por lo que necesita una nueva compilación de la tienda. Después de eso, los cambios de JavaScript, HTML y CSS que llaman al plugin pueden enviarlos instantáneamente con Capgo actualizaciones en vivo.

Envíe cambios del reproductor de YouTube sin esperar a que se apruebe la aplicación

Una vez que el plugin esté en tu tienda de construcción, Capgo actualizaciones en vivo envían cambios en JavaScript, HTML y CSS a los usuarios en minutos.

Comienza con Capgo