Aller au contenu

@capgo/capacitor-audio-recorder

Enregistrez des clips vocaux sur iOS, Android et le web avec pause, indicateurs de niveau et sortie de fichier native.

Utilisez @capgo/capacitor-audio-recorder lorsque votre application Capacitor nécessite la capture par microphone sans avoir à ajouter un module natif distinct par plateforme. Démarrez et arrêtez des clips, mettez en pause en cours d'enregistrement, surveillez le niveau d'entrée pour les formes d'onde et écoutez les erreurs d'enregistrement pendant que les utilisateurs passent du premier plan à l'arrière-plan (avec les autorisations natives appropriées).

Cas d'usage typiques : mémos vocaux, messages audio intégrés, notes de terrain, capture de podcasts légère et fonctionnalités axées sur la voix devant fonctionner dans la WebView mobile et les navigateurs mobiles.

PlateformeSupportNotes
iOSOuiCapture AVFoundation, optionnelle resetToPlaybackOnStop pour éviter une lecture silencieuse après l'enregistrement
AndroidOuiMediaRecorder, pause ou reprise sur API 24+
WebOuiNavigateur MediaRecorder, stopRecording renvoie un Blob au lieu d'un URI de fichier
  • startRecording - Lance l'enregistrement audio via le micro de l'appareil.
  • pauseRecording - Met en pause l'enregistrement en cours. Disponible uniquement sur Android (API 24+), iOS et Web.
  • resumeRecording - Reprend un enregistrement précédemment mis en pause.
  • stopRecording - Arrêter l'enregistrement en cours et sauvegarder l'audio enregistré.
MéthodeDescription
startRecordingDémarre l'enregistrement audio via le micro de l'appareil.
pauseRecordingMet en pause l'enregistrement en cours. Disponible uniquement sur Android (API 24+), iOS et Web.
resumeRecordingReprend un enregistrement précédemment mis en pause.
stopRecordingArrête l'enregistrement en cours et conserve l'audio enregistré.
cancelRecordingAnnule l'enregistrement en cours et supprime l'audio capturé.
getRecordingStatusRécupère le statut de l'enregistrement en cours.
getCurrentAmplitudeRécupère l'amplitude d'entrée actuelle (niveau du micro) sous forme de nombre normalisé dans la [0, 1] plage.
checkPermissionsRetourne l'état actuel de la permission d'accès au micro.
requestPermissionsDemande la permission d'accéder au micro.
addListenerÉcoute les erreurs d'enregistrement.
addListenerÉcoutez les événements de pause émis lorsqu'un enregistrement est mis en pause.
addListenerÉcoutez les événements de fin d'enregistrement.
removeAllListenersSupprimez tous les écouteurs enregistrés.
getPluginVersionRécupérer la version du plugin natif Capacitor.

Cette référence est synchronisée depuis src/definitions.ts dans capacitor-audio-recorder.

Si vous utilisez @capgo/capacitor-audio-recorder pour planifier le comportement des médias et de l'interface natifs, connectez-l’à Utiliser @capgo/capacitor-audio-recorder pour la capacité native dans Utiliser @capgo/capacitor-audio-recorder , Utiliser @capgo/capacitor-live-activities pour la fonctionnalité native de la page Utiliser @capgo/capacitor-live-activities, @capgo/capacitor-live-activities pour le détail d'implémentation dans @capgo/capacitor-live-activities , Utiliser @capgo/capacitor-video-player pour la capacité native dans Utiliser @capgo/capacitor-video-player , et @capgo/capacitor-video-player pour le détail d'implémentation dans @capgo/capacitor-video-player.