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.

Enregistrement sans risque de crash avec format: 'aac'

Section intitulée « Enregistrement sans crash avec format: 'aac' »

Intégré au plugin 8.4.0 (PR d’implémentation). startRecording accepte format?: 'm4a' | 'aac' sur Android et iOS. Le comportement par défaut 'm4a' reste inchangé pour les applications existantes.

Choisissez 'aac' lorsqu’un enregistrement doit survivre à un crash, une fermeture forcée, une batterie faible ou un processus tué mediaserver ADTS écrit des trames AAC autonomes dans un .aac fichier, donc la lecture fonctionne jusqu’à la dernière trame complète, même si stopRecording never runs. 'm4a' convient toujours si vous avez besoin d’un conteneur MPEG-4 standard et que vous obtenez toujours un arrêt propre.

Sur iOS, les interruptions 'aac' les segments sont assemblés à l’arrêt de l’enregistrement en copiant les trames ADTS complètes, sans réencodage ni AVAssetExportSession. Si l’assemblage échoue, stopRecording peut toujours résoudre avec mergeFailed et segments pour vous permettre de récupérer manuellement.

Consultez Enregistrement sans crash (format: 'aac') pour savoir quand l’activer, les compromis et les spécificités par plateforme stopRecording comportement.

Utiliser @capgo/capacitor-audio-recorder lorsque votre application Capacitor a besoin de capturer l'audio du micro sans ajouter un module natif distinct par plateforme. Démarrez et arrêtez des clips, mettez en pause en cours d'enregistrement, interrogez le niveau d'entrée pour les formes d'onde et surveillez les erreurs d'enregistrement pendant que les utilisateurs passent du premier plan à l'arrière-plan (avec les autorisations natives adéquates).

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

PlateformeSupportNotes
iOSOuiCapture AVFoundation, optionnelle resetToPlaybackOnStop pour éviter une lecture silencieuse après l'enregistrement
AndroidOuiMediaRecorder, mettre en pause ou reprendre sur API 24+
Le WebOuiNavigateur MediaRecorder, stopRecording renvoie un Blob au lieu d'un URI de fichier
  • startRecording - Enregistrer de l’audio via le microphone de l’appareil. Optionnel format: 'm4a' | 'aac' sur Android et iOS pour une sortie ADTS tolérante aux plantages.
  • pauseRecording - Mettre en pause l'enregistrement en cours. Disponible uniquement sur Android (API 24+), iOS et Web.
  • resumeRecording - Reprendre un enregistrement précédemment mis en pause.
  • stopRecording - Arrêtez l'enregistrement en cours et conservez l'audio enregistré.
MéthodeDescription
startRecordingDémarrez l'enregistrement audio via le micro de l'appareil.
pauseRecordingMettez en pause l'enregistrement en cours. Disponible uniquement sur Android (API 24+), iOS et Web.
resumeRecordingReprenez un enregistrement précédemment mis en pause.
stopRecordingArrêtez l'enregistrement en cours et conservez l'audio enregistré.
cancelRecordingAnnulez l'enregistrement en cours et supprimez l'audio capturé.
getRecordingStatusRécupérez le statut de l'enregistrement en cours.
getCurrentAmplitudeRécupère l'amplitude d'entrée actuelle (niveau du microphone) sous la forme d'un nombre normalisé dans la [0, 1] plage.
checkPermissionsRenvoie l'état actuel des permissions pour l'accès au microphone.
requestPermissionsDemande la permission d'accéder au microphone.
addListenerÉcoutez 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ère 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 capacité native dans 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.