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.

Vista previa del plugin Video Player QR 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 determinado 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 desde un playerId.
getVolume Obtiene el volumen del video actual de un playerId.
setVolume Establece el volumen del video actual de un playerId.
getMuted Obtiene si el video actual está silenciado desde un playerId.
setMuted Establece si el video actual está silenciado desde un playerId.
setRate Establece la velocidad del video actual mediante un playerId.
getRate Obtiene la velocidad del video actual mediante un playerId.
stopAllPlayers Detiene todos los reproductores en ejecución.
showController Muestra el controlador.
isControllerIsFullyVisible isControllerIsFullyVisible.
exitPlayer Cierra el reproductor.
hidePlayer Oculta la interfaz del reproductor actual sin detener la reproducción (fullscreen nativo).
showPlayer Vuelve a mostrar la interfaz del reproductor que estaba oculta (fullscreen nativo).

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()

Indica si un playerId determinado está reproduciendo.

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

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

play()

Reproduce el video actual mediante un playerId.

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 los detalles 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

FAQ del plugin Video Player

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

Ejecuta "bun add @capgo/capacitor-video-player" (o "npm install @capgo/capacitor-video-player"), luego ejecuta "bunx cap sync" para que los proyectos de iOS y Android reconozcan el code nativo. 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.

Lanza cambios en tu 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