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.
Support des plateformes
Section intitulée « Support des plateformes »| Plateforme | Support | Notes |
|---|---|---|
| iOS | Oui | Capture AVFoundation, optionnelle resetToPlaybackOnStop pour éviter une lecture silencieuse après l'enregistrement |
| Android | Oui | MediaRecorder, mettre en pause ou reprendre sur API 24+ |
| Le 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- Enregistrer de l’audio via le microphone de l’appareil. Optionnelformat: '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é.
API public
Section intitulée « Public API »| Méthode | Description |
|---|---|
startRecording | Démarrez l'enregistrement audio via le micro de l'appareil. |
pauseRecording | Mettez en pause l'enregistrement en cours. Disponible uniquement sur Android (API 24+), iOS et Web. |
resumeRecording | Reprenez un enregistrement précédemment mis en pause. |
stopRecording | Arrêtez l'enregistrement en cours et conservez l'audio enregistré. |
cancelRecording | Annulez l'enregistrement en cours et supprimez l'audio capturé. |
getRecordingStatus | Récupérez le statut de l'enregistrement en cours. |
getCurrentAmplitude | Récupère l'amplitude d'entrée actuelle (niveau du microphone) sous la forme d'un nombre normalisé dans la [0, 1] plage. |
checkPermissions | Renvoie l'état actuel des permissions pour l'accès au microphone. |
requestPermissions | Demande 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. |
removeAllListeners | Supprimez tous les écouteurs enregistrés. |
getPluginVersion | Récupère 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.
Continuez depuis @capgo/capacitor-audio-recorder
Section intitulée « Continuez depuis @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 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.