@capgo/capacitor-audio-recorder

Resumen

Usa @capgo/capacitor-audio-recorder cuando tu app Capacitor necesita capturar audio por micrófono sin tener que añadir un módulo nativo distinto por cada plataforma. Inicia y detén clips, pausa grabaciones, consulta el nivel de entrada para crear waveforms y detecta errores de grabación mientras los usuarios pasan de primer plano a segundo plano (con los permisos nativos adecuados).

Casos de uso comunes: notas de voz, mensajes de audio en la app, notas de campo, podcasts ligeros y funciones basadas en voz que deban funcionar tanto en la WebView móvil como en navegadores móviles.

Soporte de plataformas

Plataforma	Soporte	Notas
iOS	Sí	Captura con AVFoundation, opcional resetToPlaybackOnStop para evitar una reproducción silenciosa tras grabar
Android	Sí	MediaRecorder, pausa o reanuda en API 24+
Web	Sí	Navegador MediaRecorder, stopRecording devuelve un Blob en lugar de un URI de archivo

Funcionalidades principales

• 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 previamente.
• stopRecording - Detiene la grabación actual y guarda el audio grabado.

API pública

Método	Descripción
startRecording	Empieza a grabar audio usando 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	Detén la grabación actual y guarda el audio grabado.
cancelRecording	Cancela la grabación actual y descarta el audio capturado.
getRecordingStatus	Obtén el estado actual de la grabación.
getCurrentAmplitude	Obtén la amplitud de entrada actual (nivel del micrófono) como un número normalizado en el [0, 1] rango.
checkPermissions	Devuelve el estado actual de los permisos para acceder al micrófono.
requestPermissions	Solicita permiso para acceder al micrófono.
addListener	Escucha los errores de grabación.
addListener	Escucha los eventos de pausa emitidos cuando se pausa una grabación.
addListener	Escucha los eventos de finalización de la grabación.
removeAllListeners	Elimina todos los listeners registrados.
getPluginVersion	Obtén la versión nativa del plugin Capacitor.

Fuente de verdad

Esta referencia se sincroniza desde src/definitions.ts en capacitor-audio-recorder.

Continuar con @capgo/capacitor-audio-recorder

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