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.