@capgo/capacitor-audio-recorder
Übersicht
Abschnitt mit dem Titel „Übersicht“Nutze @capgo/capacitor-audio-recorder wenn deine Capacitor App Mikrofon-Aufnahmen benötigt, ohne für jede Plattform ein eigenes natives Modul zu integrieren. Clips starten und stoppen, Pausen während der Aufnahme machen, Pegel für Waveforms abfragen und Aufnahmefehler überwachen, während Nutzer zwischen Vorder- und Hintergrund wechseln (unter Beachtung der nativen Berechtigungen).
Typische Anwendungsfälle: Sprachmemos, Audio-Nachrichten in der App, Feldnotizen, einfache Podcast-Aufnahmen und Voice-First-Features, die sowohl in der mobilen WebView als auch in mobilen Browsern funktionieren müssen.
Plattform-Support
Abschnitt mit dem Titel „Plattformunterstützung“| Plattform | Support | Hinweise |
|---|---|---|
| iOS | Ja | AVFoundation Capture, optional resetToPlaybackOnStop um leise Wiedergabe nach der Aufnahme zu vermeiden |
| Android | Ja | MediaRecorder, pausieren oder fortsetzen auf API 24+ |
| Web | Ja | Browser MediaRecorder, stopRecording gibt ein Blob anstatt einer Datei-URI |
Kernfunktionen
Abschnitt mit dem Titel „Kernfunktionen“startRecording- Audioaufnahme mit dem Mikrofon des Geräts starten.pauseRecording- Die laufende Aufnahme pausieren. Nur verfügbar auf Android (API 24+), iOS und Web.resumeRecording- Eine zuvor pausierte Aufnahme fortsetzen.stopRecording- Stoppt die aktuelle Aufnahme und speichert das Audio.
API (öffentlich)
Abschnitt mit dem Titel „Public API“| Methode | Beschreibung |
|---|---|
startRecording | Audioaufnahme über das Mikrofon des Geräts starten. |
pauseRecording | Die laufende Aufnahme pausieren. Nur verfügbar für Android (API 24+), iOS und Web. |
resumeRecording | Eine pausierte Aufnahme fortsetzen. |
stopRecording | Stoppt die aktuelle Aufnahme und speichert das Audio. |
cancelRecording | Die aktuelle Aufnahme abbrechen und das Audio verwerfen. |
getRecordingStatus | Ruft den aktuellen Aufnahme-Status ab. |
getCurrentAmplitude | Gibt die aktuelle Eingabeamplitude (Mikrofonpegel) als normalisierte Zahl im [0, 1] Bereich ab. |
checkPermissions | Gibt den aktuellen Berechtigungsstatus für den Zugriff auf das Mikrofon zurück. |
requestPermissions | Berechtigung für den Mikrofonzugriff anfordern. |
addListener | Auf Aufnahmefehler hören. |
addListener | Auf Pause-Events bei einer pausierten Aufnahme hören. |
addListener | Auf Events beim Abschluss der Aufnahme hören. |
removeAllListeners | Alle registrierten Listener entfernen. |
getPluginVersion | Gibt die native Capacitor Plugin-Version zurück. |
Source of Truth
Abschnitt mit dem Titel „Source of Truth“Diese Referenz wird synchronisiert von src/definitions.ts in capacitor-audio-recorder.
Weiter mit @capgo/capacitor-audio-recorder
Abschnitt mit dem Titel „Weiter mit @capgo/capacitor-audio-recorder“Wenn Sie ... verwenden @capgo/capacitor-audio-recorder um natives Medien- und Interface-Verhalten zu planen, verbinde es mit Verwendung von @capgo/capacitor-audio-recorder für die native Funktion in Verwendung von @capgo/capacitor-audio-recorder, @capgo/capacitor-live-activities verwenden für die native Funktion in „@capgo/capacitor-live-activities verwenden“, @capgo/capacitor-live-activities für das Implementierungsdetail in @capgo/capacitor-live-activities, @capgo/capacitor-video-player verwenden für die native Funktionalität bei der Nutzung von @capgo/capacitor-video-player, und @capgo/capacitor-video-player für das Implementierungsdetail in @capgo/capacitor-video-player.