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

Grabadora de audio plugin Capacitor

Graba audio en iOS, Android y Web con controles y formatos sencillos

Instalar

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

Guía

Cómo usar Audio Recorder en Capacitor

Probar en el dispositivo

Descarga la app Capgo y escanea el QR code.

Vista previa del plugin Audio Recorder QR code

Uso de @capgo/capacitor-audio-recorder

Plugin Capacitor para grabar audio.

Instalar

bun add @capgo/capacitor-audio-recorder
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 { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';

API de un vistazo

Método Descripción
startRecording Inicia la grabación de audio con el micrófono del dispositivo.
pauseRecording Pausa la grabación en curso. Solo disponible en Android (API 24+), iOS y Web.
resumeRecording Reanuda una grabación pausada anteriormente.
stopRecording Detiene la grabación actual y guarda el audio grabado.
cancelRecording Cancela la grabación actual y descarta cualquier audio capturado.
getRecordingStatus Obtiene el estado actual de la grabación.
getCurrentAmplitude Obtiene la amplitud de entrada actual (nivel del micrófono) como un número normalizado en el [0, 1] rango.
checkPermissions Devuelve el estado actual del permiso de acceso al micrófono.
requestPermissions Solicita permiso para acceder al micrófono.

Ejemplos

startRecording()

Inicia la grabación de audio con el micrófono del dispositivo.

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';

await CapacitorAudioRecorder.startRecording();

pauseRecording()

Pausa la grabación en curso. Solo disponible en Android (API 24+), iOS y Web.

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';

await CapacitorAudioRecorder.pauseRecording();

resumeRecording()

Reanuda una grabación pausada anteriormente.

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';

await CapacitorAudioRecorder.resumeRecording();

stopRecording()

Detiene la grabación actual y guarda el audio grabado.

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';

const result = await CapacitorAudioRecorder.stopRecording();
console.log(result);

cancelRecording()

Cancela la grabación actual y descarta cualquier audio capturado.

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';

await CapacitorAudioRecorder.cancelRecording();

getRecordingStatus()

Obtiene el estado actual de la grabación.

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';

const result = await CapacitorAudioRecorder.getRecordingStatus();
console.log(result);

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

Escuchar eventos

addListener devuelve un handle. Llama handle.remove() cuando la pantalla se desmonte, o CapacitorAudioRecorder.removeAllListeners() para limpiar todos los listeners.

Referencia completa

Continúa desde Uso de @capgo/capacitor-audio-recorder

Si estás usando Uso de @capgo/capacitor-audio-recorder para planificar el comportamiento de los medios nativos y la interfaz, conéctalo con @capgo/capacitor-audio-recorder para los detalles de implementación en @capgo/capacitor-audio-recorder, 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-video-player para la capacidad nativa en Uso de @capgo/capacitor-video-player.

FAQ

FAQ del plugin Audio Recorder

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

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

¿Es compatible @capgo/capacitor-audio-recorder con React, Vue y Angular?

Sí. Audio Recorder 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-audio-recorder?

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-audio-recorder 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-audio-recorder/ y el paquete se puede instalar gratis desde npm. Los reportes de bugs y pull requests son bienvenidos.

¿Puedo actualizar code que usa Audio Recorder 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 Audio Recorder 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