@capgo/capacitor-audio-recorder

Registra clip vocali su iOS, Android e web con pausa, misuratori di livello e output di file nativi.

Panoramica

Usa @capgo/capacitor-audio-recorder quando la tua app Capacitor richiede la cattura del microfono senza dover aggiungere un modulo nativo separato per ogni piattaforma. Avvia e ferma clip, metti in pausa durante la registrazione, monitora il livello di input per le waveform e gestisci gli errori di registrazione mentre gli utenti passano in foreground o background (con i permessi nativi corretti).

Casi d'uso tipici: memo vocali, messaggi audio in-app, note sul campo, podcast leggeri e funzionalità basate sulla voce che devono funzionare sia nella WebView mobile che nei browser.

Supporto piattaforme

Piattaforma	Supporto	Note
iOS	Sì	Cattura AVFoundation, opzionale `resetToPlaybackOnStop` to avoid quiet playback after recording
Android	Sì	`MediaRecorder`, metti in pausa o riprendi su API 24+
Web	Sì	Browser `MediaRecorder`, `stopRecording` restituisce un `Blob` invece di un URI di file

Funzionalità principali

startRecording - Avvia la registrazione audio tramite il microfono del dispositivo.
pauseRecording - Metti in pausa la registrazione in corso. Disponibile solo su Android (API 24+), iOS e Web.
resumeRecording - Riprende una registrazione precedentemente in pausa.
stopRecording - Ferma la registrazione in corso e salva l'audio registrato.

Pubblico API

Metodo	Descrizione
`startRecording`	Avvia la registrazione audio tramite il microfono del dispositivo.
`pauseRecording`	Mette in pausa la registrazione in corso. Disponibile solo su Android (API 24+), iOS e Web.
`resumeRecording`	Riprendi una registrazione precedentemente in pausa.
`stopRecording`	Interrompe la registrazione attuale e salva l'audio registrato.
`cancelRecording`	Annulla la registrazione attuale e scarta l'audio catturato.
`getRecordingStatus`	Recupera lo stato attuale della registrazione.
`getCurrentAmplitude`	Recupera l'ampiezza dell'input attuale (livello microfono) come numero normalizzato nel `[0, 1]` specificato.
`checkPermissions`	Restituisce lo stato attuale dei permessi per l'accesso al microfono.
`requestPermissions`	Richiedi il permesso per accedere al microfono.
`addListener`	Ascolta gli errori di registrazione.
`addListener`	Ascolta gli eventi di pausa emessi quando una registrazione viene messa in pausa.
`addListener`	Ascolta gli eventi di completamento della registrazione.
`removeAllListeners`	Rimuove tutti i listener registrati.
`getPluginVersion`	Ottieni la versione nativa del plugin Capacitor.

Fonte di verità

Questo riferimento è sincronizzato da src/definitions.ts nella capacitor-audio-recorder.

Continua con @capgo/capacitor-audio-recorder

Se stai usando @capgo/capacitor-audio-recorder per pianificare il comportamento dei media nativi e dell'interfaccia, collegalo a Utilizzo di @capgo/capacitor-audio-recorder per la funzionalità nativa in Usare @capgo/capacitor-audio-recorder, Uso di @capgo/capacitor-live-activities per la funzionalità nativa nella pagina Uso di @capgo/capacitor-live-activities, @capgo/capacitor-live-activities per il dettaglio implementativo in @capgo/capacitor-live-activities, Uso di @capgo/capacitor-video-player per la funzionalità nativa nella pagina Uso di @capgo/capacitor-video-player, e @capgo/capacitor-video-player per il dettaglio implementativo in @capgo/capacitor-video-player.