Übersicht
Abschnitt: „Übersicht“Nutzt @capgo/capacitor-audio-recorder wenn deine Capacitor-App Mikrofonaufnahme braucht, ohne für jede Plattform ein separates natives Modul anzubinden. Clips starten und stoppen, mitten in der Aufnahme pausieren, den Eingangspegel für Waveforms abfragen und auf Aufnahmefehler achten, während Nutzer zwischen Vordergrund und Hintergrund wechseln (mit den richtigen nativen Entitlements).
Typische Einsatzfälle: Sprachmemos, Audio-Nachrichten in der App, Feldnotizen, leichte Podcast-Aufnahmen und sprachbasierte Funktionen, die im mobilen WebView und in mobilen Browsern funktionieren müssen.
Plattformunterstützung
Abschnitt mit dem Titel „Plattformunterstützung“| Plattform | Support | Notizen |
|---|---|---|
| iOS | Ja | AVFoundation-Aufnahme, optional resetToPlaybackOnStop um leises Abspielen nach der Aufnahme zu vermeiden |
| Android | Ja | MediaRecorder, pausieren oder fortsetzen unter 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 unter Android (API 24+), iOS und Web.resumeRecording- Eine zuvor pausierte Aufnahme fortsetzen.stopRecording- Stoppt die aktuelle Aufnahme und speichert das aufgenommene Audio dauerhaft.
Öffentliches API
Abschnitt mit dem Titel „Öffentliche API“| Methode | Beschreibung |
|---|---|
startRecording | Aufnahme mit dem Gerätemikrofon starten. |
pauseRecording | Die laufende Aufnahme pausieren. Nur auf Android (API 24+), iOS und Web verfügbar. |
resumeRecording | Eine zuvor pausierte Aufnahme fortsetzen. |
stopRecording | Die aktuelle Aufnahme stoppen und das aufgenommene Audio speichern. |
cancelRecording | Die aktuelle Aufnahme abbrechen und bereits aufgenommenes Audio verwerfen. |
getRecordingStatus | Den aktuellen Aufnahmestatus abrufen. |
getCurrentAmplitude | Ruft die aktuelle Eingabeamplitude (Mikrofonpegel) als normalisierte Zahl in der [0, 1] Bereich. |
checkPermissions | Gibt den aktuellen Berechtigungsstatus für den Mikrofonzugriff zurück. |
requestPermissions | Fordert die Berechtigung für den Mikrofonzugriff an. |
addListener | Auf Aufnahmefehler hören. |
addListener | Auf Pause-Events hören, die beim Pausieren einer Aufnahme ausgelöst werden. |
addListener | Auf Events zum Abschluss der Aufnahme hören. |
removeAllListeners | Alle registrierten Listener entfernen. |
getPluginVersion | Die native Capacitor Plugin-Version abrufen. |
Source of Truth
Abschnitt mit dem Titel „Source of Truth“Diese Referenz wird synchronisiert von src/definitions.ts in einem capacitor-audio-recorder.
Weiter geht's mit @capgo/capacitor-audio-recorder
Abschnitt mit dem Titel „Weiter geht's mit @capgo/capacitor-audio-recorder“Wenn du es nutzt @capgo/capacitor-audio-recorder , um natives Media- und Interface-Verhalten zu planen, verbinde es mit @capgo/capacitor-audio-recorder verwenden für die native Funktionalität bei der Nutzung 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 die Implementierungsdetails in @capgo/capacitor-live-activities, Verwendung von @capgo/capacitor-video-player für die native Funktion in „@capgo/capacitor-video-player verwenden“, und @capgo/capacitor-video-player für das Implementierungsdetail in @capgo/capacitor-video-player.