@capgo/capacitor-native-audio

Soundeffekte mit geringer Latenz und Audio-Streaming mit Preload, Now Playing-Steuerung und Optionen für die Hintergrundwiedergabe.

Loslegen GitHub

Übersicht

Nutzt @capgo/capacitor-native-audio Wenn deine Capacitor App responsives Playback für UI-Sounds, kurze Clips oder Musik-Sessions benötigt, ohne mehrere native Audio-APIs gleichzeitig verwalten zu müssen. Assets vorladen, Tracks loopen, Lautstärke faden, Remote-URLs oder HLS streamen und optional Transport-Steuerungen auf dem Lockscreen anzeigen.

Typische Anwendungsfälle: Game-SFX, Benachrichtigungstöne, geführte Meditationen, Podcast-Player und alle Flows, die in der Audio-Session des Geräts mit anderen Apps koexistieren müssen.

Plattformunterstützung

Plattform	Support	Notizen
iOS	Ja	AVFoundation, optional Now Playing und Audio-Session-Kategorien
Android	Ja	Medienwiedergabe, Benachrichtigungen, optionaler Foreground Service für den Hintergrund
Web	Teilweise	Kern-Wiedergabe; einige Listener-Events werden im Web nicht ausgelöst

Kernfunktionen

configure - Den Audio-Player konfigurieren.
preload - Eine Audiodatei laden.
playOnce - Eine Audiodatei einmalig mit automatischem Cleanup abspielen.
isPreloaded - Prüfen, ob eine Audiodatei vorgeladen ist.

Öffentliches API

Methode	Beschreibung
`configure`	Den Audio-Player konfigurieren.
`preload`	Eine Audiodatei laden.
`playOnce`	Eine Audiodatei einmalig mit automatischem Cleanup abspielen.
`isPreloaded`	Prüfen, ob eine Audiodatei vorgeladen ist.
`play`	Eine Audiodatei abspielen.
`pause`	Eine Audiodatei pausieren.
`resume`	Eine Audiodatei fortsetzen.
`loop`	Eine Audiodatei stoppen.
`stop`	Eine Audiodatei stoppen.
`unload`	Eine Audiodatei entladen.
`setVolume`	Lautstärke einer Audiodatei festlegen.
`setRate`	Abspielgeschwindigkeit einer Audiodatei festlegen.
`setCurrentTime`	Aktuelle Zeit einer Audiodatei setzen.
`getCurrentTime`	Aktuelle Zeit einer Audiodatei abrufen.
`getDuration`	Dauer einer Audiodatei in Sekunden abrufen.
`isPlaying`	Prüfen, ob eine Audiodatei abgespielt wird.
`addListener`	Auf das 'complete'-Event hören.
`addListener`	Auf Zeit-Updates hören. Wird alle 100ms gesendet, während Audio läuft.
`addListener`	Auf Playback-Statusänderungen hören (inkl. Lock-Screen-Steuerung). Wird von Android und iOS unterstützt; Web-Implementierung unterstützt dies aktuell nicht.
`clearCache`	Löscht den Audio-Cache für Remote-Audiodateien.
`setDebugMode`	Debug-Logging konfigurieren.
`getPluginVersion`	Die native Capacitor Plugin-Version abrufen.
`deinitPlugin`	Initialisierung des Plugins aufheben und ursprüngliche Audio-Session-Einstellungen wiederherstellen. Diese Methode stoppt alle laufenden Audio-Wiedergaben und setzt alle durch das Plugin vorgenommenen Änderungen an der Audio-Session zurück. Nutze dies, um die Kompatibilität mit anderen Audio-Plugins sicherzustellen.

Source of Truth

Diese Referenz wird synchronisiert von src/definitions.ts in capacitor-native-audio.

Weiterlesen mit @capgo/capacitor-native-audio

Wenn du es nutzt @capgo/capacitor-native-audio , um natives Media- und Interface-Verhalten zu planen, verbinde es mit @capgo/capacitor-native-audio verwenden für die native Funktion bei der Nutzung von @capgo/capacitor-native-audio, @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.