@capgo/capacitor-audio-recorder

Panoramica

Usa @capgo/capacitor-audio-recorder quando la tua app Capacitor richiede la cattura del microfono senza dover integrare un modulo nativo separato per ogni piattaforma. Avvia e ferma le 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 nella WebView mobile e nei browser.

Piattaforme supportate

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

Funzionalità principali

• 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 - Ferma la registrazione attuale e salva l'audio registrato.

Pubblico API

Metodo	Descrizione
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	Riprendi una registrazione precedentemente in pausa.
stopRecording	Interrompi 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 nell' [0, 1] intervallo.
checkPermissions	Restituisce lo stato attuale dei permessi per l'accesso al microfono.
requestPermissions	Richiede l'autorizzazione 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 in capacitor-audio-recorder.

Continua da @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 Utilizzo di @capgo/capacitor-audio-recorder, Usare @capgo/capacitor-live-activities per la funzionalità nativa nella guida Usare @capgo/capacitor-live-activities, @capgo/capacitor-live-activities per i dettagli di implementazione in @capgo/capacitor-live-activities, Usare @capgo/capacitor-video-player per la funzionalità nativa in Utilizzo di @capgo/capacitor-video-player, e @capgo/capacitor-video-player per il dettaglio di implementazione in @capgo/capacitor-video-player.