@capgo/capacitor-audio-recorder

Grabación a prueba de fallos con format: 'aac'

Incluido en el plugin 8.4.0 (PR de implementación). startRecording acepta format?: 'm4a' | 'aac' en Android e iOS. El valor predeterminado 'm4a' no cambia para las aplicaciones existentes.

Elige 'aac' cuando una grabación debe sobrevivir a un crash, cierre forzado, batería baja o un proceso terminado. mediaserver ADTS escribe frames AAC autocontenidos en un .aac archivo, por lo que la reproducción funciona hasta el último frame completo incluso si stopRecording nunca se ejecuta. 'm4a' sigue siendo adecuado cuando necesitas un contenedor MPEG-4 estándar y siempre obtienes una parada limpia.

En iOS, las interrupciones de 'aac' los segmentos se unen al detener la grabación copiando tramas ADTS completas, sin recodificar ni AVAssetExportSession. Si la unión falla, stopRecording aún puede resolverse con mergeFailed y segments para que puedas recuperarlo manualmente.

Ver Grabación a prueba de fallos (format: 'aac') for when to opt in, tradeoffs, and platform specific stopRecording comportamiento.

Resumen

Usa @capgo/capacitor-audio-recorder cuando tu app de Capacitor necesita capturar audio del micrófono sin añadir un módulo nativo aparte por plataforma. Inicia y detén clips, pausa a mitad de grabación, consulta el nivel de entrada para formas de onda y escucha errores de grabación mientras los usuarios pasan entre primer y segundo plano (con los permisos nativos adecuados).

Casos de uso típicos: notas de voz, mensajes de audio en la app, notas de campo, grabación de podcasts ligera y funciones basadas en voz que deben funcionar en el WebView móvil y en navegadores móviles.

Soporte de plataformas

Plataforma	Soporte	Notas
iOS	Sí	captura con AVFoundation, opcional resetToPlaybackOnStop para evitar que el audio suene bajo 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 - Empieza a grabar audio con el micrófono del dispositivo. Opcional format: 'm4a' | 'aac' en Android e iOS para una salida ADTS tolerante a fallos.
• 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.

Público API

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.
addListener	Escucha errores de grabación.
addListener	Escucha eventos de pausa emitidos cuando una grabación se pausa.
addListener	Escucha eventos de finalización de grabación.
removeAllListeners	Elimina todos los listeners registrados.
getPluginVersion	Obtén la versión del plugin nativo Capacitor.

Fuente de verdad

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

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

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