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

FFmpeg plugin Capacitor

Codificación y procesamiento de video con FFmpeg para compresión y conversión

Instalar

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

Guía

Cómo usar FFmpeg en Capacitor

Usando @capgo/capacitor-ffmpeg

Expone el API de FFmpeg a Capacitor

Instalar

bun add @capgo/capacitor-ffmpeg
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 { CapacitorFFmpeg } from '@capgo/capacitor-ffmpeg';

API de un vistazo

Método Descripción
getCapabilities Devuelve la matriz de capacidades legible por máquina para la plataforma actual.
reencodeVideo Encola un trabajo de recodificación de video.
convertImage Convierte una imagen estática a otro formato.
convertAudio Convierte audio a otro contenedor o codec.

Ejemplos

getCapabilities()

Devuelve la matriz de capacidades legible por máquina para la plataforma actual.

import { CapacitorFFmpeg } from '@capgo/capacitor-ffmpeg';

const result = await CapacitorFFmpeg.getCapabilities();
console.log(result);

reencodeVideo()

Encola un trabajo de recodificación de video.

import { CapacitorFFmpeg } from '@capgo/capacitor-ffmpeg';

const result = await CapacitorFFmpeg.reencodeVideo({
  inputPath: 'path/to/file',
  outputPath: 'path/to/file',
  width: 1080,
  height: 1920,
});
console.log(result);

convertImage()

Convierte una imagen estática a otro formato.

import { CapacitorFFmpeg } from '@capgo/capacitor-ffmpeg';

const result = await CapacitorFFmpeg.convertImage({
  inputPath: 'path/to/file',
  outputPath: 'path/to/file',
  format: 'webp',
});
console.log(result);

convertAudio()

Convierte audio a otro contenedor o codec.

import { CapacitorFFmpeg } from '@capgo/capacitor-ffmpeg';

const result = await CapacitorFFmpeg.convertAudio({
  inputPath: 'path/to/file',
  outputPath: 'path/to/file',
  format: 'm4a',
});
console.log(result);

Escuchar eventos

addListener devuelve un handle. Llama handle.remove() cuando la pantalla se desmonta.

Referencia completa

Continuar desde Uso de @capgo/capacitor-ffmpeg

Si estás usando Uso de @capgo/capacitor-ffmpeg para planificar las operaciones del dashboard y de API, conéctalo con @capgo/capacitor-ffmpeg para los detalles de implementación en @capgo/capacitor-ffmpeg, Primeros pasos para los detalles de implementación en Primeros pasos, Resumen de API para los detalles de implementación en API Overview, Introducción para los detalles de implementación en Introducción, y Claves de API para los detalles de implementación en API Keys.

FAQ

FAQ del plugin FFmpeg

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

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

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

Sí. FFmpeg 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 es compatible con @capgo/capacitor-ffmpeg?

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-ffmpeg gratuito y de código abierto?

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

¿Puedo actualizar code que usa FFmpeg 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 de FFmpeg 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