Saltar al contenido principal
@capgo/capacitor-video-player Multimedia Código abierto

Reproductor de video plugin Capacitor

Reproducción de video nativa con subtítulos, pantalla completa y controles completos

Instalar

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

Guía

Cómo usar Video Player en Capacitor

Probar en el dispositivo

Descarga la app Capgo y escanea el QR code.

QR de vista previa del plugin Video Player code

Uso de @capgo/capacitor-video-player

Plugin Capacitor para reproducir video en el reproductor nativo.

Instalar

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

bunx cap sync copia el code nativo del plugin en tus proyectos nativos. Ejecútalo de nuevo tras cada actualización del plugin.

Importar

import { VideoPlayer } from '@capgo/capacitor-video-player';

API de un vistazo

Método Descripción
initPlayer Inicializa un reproductor de video.
isPlaying Devuelve si un playerId dado está reproduciendo.
play Reproduce el video actual desde un playerId dado.
pause Pausa el video actual de un playerId dado.
getDuration Obtén la duración del video actual de un playerId dado.
getCurrentTime Obtén el tiempo actual del video de un playerId dado.
setCurrentTime Establece el tiempo actual para buscar en el video actual desde un playerId dado.
getVolume Obtiene el volumen del video actual desde un playerId dado.
setVolume Establece el volumen del video actual desde un playerId dado.
getMuted Obtiene el estado de silencio del video actual desde un playerId dado.
setMuted Establece el estado de silencio del video actual desde un playerId dado.
setRate Establece la velocidad del video actual a partir de un playerId dado.
getRate Obtiene la velocidad del video actual a partir de un playerId dado.
stopAllPlayers Detiene todos los reproductores en reproducción.
showController Muestra el controlador.
isControllerIsFullyVisible isControllerIsFullyVisible.
exitPlayer Sale del reproductor.
hidePlayer Oculta la interfaz del reproductor actualmente presentada sin detener la reproducción (pantalla completa nativa).
showPlayer Muestra de nuevo la interfaz del reproductor oculta previamente (pantalla completa nativa).

Ejemplos

initPlayer()

Inicializa un reproductor de video.

import { VideoPlayer } from '@capgo/capacitor-video-player';

const result = await VideoPlayer.initPlayer({ mode: 'fullscreen' });
console.log(result);

isPlaying()

Devuelve si un playerId dado está en reproducción.

import { VideoPlayer } from '@capgo/capacitor-video-player';

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

play()

Reproduce el video actual a partir de un playerId dado.

import { VideoPlayer } from '@capgo/capacitor-video-player';

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

pause()

Pausa el video actual de un playerId dado.

import { VideoPlayer } from '@capgo/capacitor-video-player';

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

getDuration()

Obtén la duración del video actual de un playerId dado.

import { VideoPlayer } from '@capgo/capacitor-video-player';

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

getCurrentTime()

Obtén el tiempo actual del video de un playerId dado.

import { VideoPlayer } from '@capgo/capacitor-video-player';

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

La tabla anterior lista los 19 métodos principales. Los helpers de listeners y versión, junto con el contrato completo de cada método, están en la repositorio GitHub.

Referencia completa

Continúa desde Uso de @capgo/capacitor-video-player

Si estás usando Uso de @capgo/capacitor-video-player para planificar el comportamiento de los medios nativos y la interfaz, conéctalo con @capgo/capacitor-video-player para el detalle de implementación en @capgo/capacitor-video-player, Primeros pasos para los detalles de implementación en Primeros pasos, Uso de @capgo/capacitor-live-activities para la capacidad nativa en Uso de @capgo/capacitor-live-activities, @capgo/capacitor-live-activities para el detalle de implementación en @capgo/capacitor-live-activities, y Uso de @capgo/capacitor-native-navigation para la capacidad nativa al usar @capgo/capacitor-native-navigation.

FAQ

Preguntas frecuentes del plugin Video Player

¿Cómo instalo el plugin Video Player en una app de Capacitor?

Ejecuta "bun add @capgo/capacitor-video-player" (o "npm install @capgo/capacitor-video-player") y luego ejecuta "bunx cap sync" para que los proyectos de iOS y Android incorporen el código nativo code. Impórtalo desde "@capgo/capacitor-video-player" en el code de tu app.

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

Sí. Video Player es un paquete Capacitor, así que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluidos Ionic, React, Vue, Angular, Svelte y JavaScript puro.

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

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

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

Sí. El código fuente de code es público en GitHub: https://github.com/Cap-go/capacitor-video-player/ y el paquete se puede instalar gratis desde npm. Se agradecen los reportes de bugs y los pull requests.

¿Puedo actualizar code que usa Video Player sin pasar por la revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

Publica cambios en Video Player sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo