@capgo/capacitor-native-audio

Effetti sonori a bassa latenza e streaming audio con preload, controlli Now Playing e opzioni di riproduzione in background.

Inizia ora GitHub

Panoramica

Usa @capgo/capacitor-native-audio quando la tua app Capacitor richiede una riproduzione reattiva per suoni della UI, clip brevi o sessioni musicali, senza dover gestire diverse API audio native. Precarica gli asset, metti i brani in loop, gestisci il fade del volume, riproduci URL remoti o HLS e, opzionalmente, mostra i controlli di riproduzione sulla lock screen.

Casi d'uso tipici: SFX per giochi, suoni di notifica, meditazione guidata, player per podcast e qualsiasi flusso che debba coesistere con altre app nella sessione audio del dispositivo.

Supporto piattaforme

Piattaforma	Supporto	Note
iOS	Sì	AVFoundation, opzionalmente Now Playing e categorie audio session
Android	Sì	Riproduzione media, notifiche e opzione foreground service per il background
Web	Parziale	Riproduzione core; alcuni eventi listener non vengono emessi su web

Funzionalità principali

configure - Configura l'audio player.
preload - Carica un file audio.
playOnce - Riproduci un file audio una sola volta con cleanup automatico.
isPreloaded - Controlla se un file audio è precaricato.

Pubblico API

Metodo	Descrizione
`configure`	Configura l'audio player.
`preload`	Carica un file audio.
`playOnce`	Riproduci un file audio una sola volta con cleanup automatico.
`isPreloaded`	Controlla se un file audio è precaricato.
`play`	Riproduci un file audio.
`pause`	Metti in pausa un file audio.
`resume`	Riprendi un file audio.
`loop`	Ferma un file audio.
`stop`	Ferma un file audio.
`unload`	Scarica un file audio dalla memoria.
`setVolume`	Imposta il volume di un file audio.
`setRate`	Imposta il rate di un file audio.
`setCurrentTime`	Imposta il tempo corrente di un file audio.
`getCurrentTime`	Ottieni il tempo corrente di un file audio.
`getDuration`	Ottieni la durata di un file audio in secondi.
`isPlaying`	Controlla se un file audio è in riproduzione.
`addListener`	Ascolta l'evento di completamento.
`addListener`	Ascolta gli aggiornamenti del tempo corrente. Emette ogni 100ms durante la riproduzione.
`addListener`	Ascolta i cambiamenti dello stato di riproduzione, inclusi i controlli di notifica e lock-screen. Emesso da Android e iOS. L'attuale implementazione Web non emette questo evento.
`clearCache`	Svuota la cache audio per i file audio remoti.
`setDebugMode`	Imposta il logging della modalità debug.
`getPluginVersion`	Ottieni la versione nativa del plugin Capacitor.
`deinitPlugin`	Disinizializza il plugin e ripristina le impostazioni della sessione audio originale. Questo metodo interrompe tutta la riproduzione audio e annulla le modifiche alla sessione audio apportate dal plugin. Usalo per garantire la compatibilità con altri plugin audio.

Fonte di verità

Questo riferimento è sincronizzato da src/definitions.ts nella capacitor-native-audio.

Continua da @capgo/capacitor-native-audio

Se stai usando @capgo/capacitor-native-audio per pianificare il comportamento dei media nativi e dell'interfaccia, collegalo a Utilizzo di @capgo/capacitor-native-audio per la funzionalità nativa usando @capgo/capacitor-native-audio, Uso di @capgo/capacitor-live-activities per la funzionalità nativa nella pagina Uso di @capgo/capacitor-live-activities, @capgo/capacitor-live-activities per il dettaglio implementativo in @capgo/capacitor-live-activities, Uso di @capgo/capacitor-video-player per la funzionalità nativa nella pagina Uso di @capgo/capacitor-video-player, e @capgo/capacitor-video-player per il dettaglio implementativo in @capgo/capacitor-video-player.