Zum Inhalt springen

@capgo/capacitor-audio-recorder

Nimm Sprachclips auf iOS, Android und im Web auf – mit Pause-Funktion, Pegelanzeige und nativem Dateiformat.

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.

PlattformSupportHinweise
iOSJaAVFoundation Capture, optional resetToPlaybackOnStop um leise Wiedergabe nach der Aufnahme zu vermeiden
AndroidJaMediaRecorder, pausieren oder fortsetzen auf 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 auf Android (API 24+), iOS und Web.
  • resumeRecording - Eine zuvor pausierte Aufnahme fortsetzen.
  • stopRecording - Stoppt die aktuelle Aufnahme und speichert das Audio.
MethodeBeschreibung
startRecordingAudioaufnahme über das Mikrofon des Geräts starten.
pauseRecordingDie laufende Aufnahme pausieren. Nur verfügbar für Android (API 24+), iOS und Web.
resumeRecordingEine pausierte Aufnahme fortsetzen.
stopRecordingStoppt die aktuelle Aufnahme und speichert das Audio.
cancelRecordingDie aktuelle Aufnahme abbrechen und das Audio verwerfen.
getRecordingStatusRuft den aktuellen Aufnahme-Status ab.
getCurrentAmplitudeGibt die aktuelle Eingabeamplitude (Mikrofonpegel) als normalisierte Zahl im [0, 1] Bereich ab.
checkPermissionsGibt den aktuellen Berechtigungsstatus für den Zugriff auf das Mikrofon zurück.
requestPermissionsBerechtigung für den Mikrofonzugriff anfordern.
addListenerAuf Aufnahmefehler hören.
addListenerAuf Pause-Events bei einer pausierten Aufnahme hören.
addListenerAuf Events beim Abschluss der Aufnahme hören.
removeAllListenersAlle registrierten Listener entfernen.
getPluginVersionGibt die native Capacitor Plugin-Version zurück.

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