Zum Inhalt springen

@capgo/capacitor-audio-recorder

Sprachclips auf iOS, Android und im Web aufnehmen – mit Pause-Funktion, Pegelanzeigen und nativer Dateiausgabe.

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.

PlattformSupportNotizen
iOSJaAVFoundation-Aufnahme, optional resetToPlaybackOnStop um leises Abspielen nach der Aufnahme zu vermeiden
AndroidJaMediaRecorder, pausieren oder fortsetzen unter API 24+
WebJaBrowser MediaRecorder, stopRecording gibt ein Blob anstatt einer Datei-URI
  • 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.
MethodeBeschreibung
startRecordingAufnahme mit dem Gerätemikrofon starten.
pauseRecordingDie laufende Aufnahme pausieren. Nur auf Android (API 24+), iOS und Web verfügbar.
resumeRecordingEine zuvor pausierte Aufnahme fortsetzen.
stopRecordingDie aktuelle Aufnahme stoppen und das aufgenommene Audio speichern.
cancelRecordingDie aktuelle Aufnahme abbrechen und bereits aufgenommenes Audio verwerfen.
getRecordingStatusDen aktuellen Aufnahmestatus abrufen.
getCurrentAmplitudeRuft die aktuelle Eingabeamplitude (Mikrofonpegel) als normalisierte Zahl in der [0, 1] Bereich.
checkPermissionsGibt den aktuellen Berechtigungsstatus für den Mikrofonzugriff zurück.
requestPermissionsFordert die Berechtigung für den Mikrofonzugriff an.
addListenerAuf Aufnahmefehler hören.
addListenerAuf Pause-Events hören, die beim Pausieren einer Aufnahme ausgelöst werden.
addListenerAuf Events zum Abschluss der Aufnahme hören.
removeAllListenersAlle registrierten Listener entfernen.
getPluginVersionDie native Capacitor Plugin-Version abrufen.

Diese Referenz wird synchronisiert von src/definitions.ts in einem 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.