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.
Plateformes compatibles
Section intitulée « Plateformes compatibles »| Plateforme | Support | Notes |
|---|---|---|
| iOS | Oui | Capture AVFoundation, optionnelle resetToPlaybackOnStop pour éviter une lecture silencieuse après l'enregistrement |
| Android | Oui | MediaRecorder, pause ou reprise sur API 24+ |
| Web | Oui | Navigateur MediaRecorder, stopRecording renvoie un Blob au lieu d'un URI de fichier |
Fonctionnalités clés
Section intitulée « Fonctionnalités clés »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é.
API public
Section intitulée « Public API »| Méthode | Description |
|---|---|
startRecording | Démarre 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ête l'enregistrement en cours et conserve l'audio enregistré. |
cancelRecording | Annule l'enregistrement en cours et supprime l'audio capturé. |
getRecordingStatus | Récupère le statut de l'enregistrement en cours. |
getCurrentAmplitude | Récupère l'amplitude d'entrée actuelle (niveau du micro) sous forme de nombre normalisé dans la [0, 1] plage. |
checkPermissions | Retourne l'état actuel de la permission d'accès au micro. |
requestPermissions | Demande 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. |
removeAllListeners | Supprimez tous les écouteurs enregistrés. |
getPluginVersion | Récupérer la version du plugin natif Capacitor. |
Source de vérité
Section intitulée « Source de vérité »Cette référence est synchronisée depuis src/definitions.ts dans capacitor-audio-recorder.
Continuer avec @capgo/capacitor-audio-recorder
Section intitulée « Continuer avec @capgo/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.