@capgo/capacitor-native-audio

Efek suara latensi rendah dan streaming audio dengan fitur preload, kontrol Now Playing, serta opsi playback di background.

Mulai sekarang GitHub

Ikhtisar

Gunakan @capgo/capacitor-native-audio saat aplikasi Capacitor Anda butuh playback responsif untuk suara UI, klip pendek, atau sesi musik tanpa harus ribet mengelola banyak native audio API. Preload aset, loop track, fade volume, stream URL remote atau HLS, dan opsional tampilkan kontrol transport di lock screen.

Kegunaan umum: SFX game, bunyi notifikasi, meditasi terpandu, pemutar podcast, dan alur apa pun yang harus berjalan bersamaan dengan aplikasi lain dalam audio session perangkat.

Dukungan platform

Platform	Dukungan	Catatan
iOS	Ya	AVFoundation, opsional Now Playing dan kategori audio session
Android	Ya	Pemutaran media, notifikasi, foreground service opsional untuk background
Web	Parsial	Pemutaran inti; beberapa event listener tidak dipancarkan di web

Kemampuan Utama

configure - Konfigurasikan audio player.
preload - Muat file audio.
playOnce - Putar file audio sekali dengan cleanup otomatis.
isPreloaded - Cek apakah file audio sudah di-preload.

API Publik

Metode	Deskripsi
`configure`	Konfigurasi audio player.
`preload`	Muat file audio.
`playOnce`	Putar file audio sekali dengan pembersihan otomatis.
`isPreloaded`	Cek apakah file audio sudah di-preload.
`play`	Putar file audio.
`pause`	Jeda file audio.
`resume`	Lanjutkan pemutaran audio.
`loop`	Hentikan file audio.
`stop`	Hentikan file audio.
`unload`	Unload file audio.
`setVolume`	Atur volume file audio.
`setRate`	Atur kecepatan file audio.
`setCurrentTime`	Atur waktu saat ini pada file audio.
`getCurrentTime`	Dapatkan waktu saat ini dari file audio.
`getDuration`	Dapatkan durasi file audio dalam detik.
`isPlaying`	Cek apakah file audio sedang diputar.
`addListener`	Dengarkan event complete.
`addListener`	Dengarkan update waktu saat ini. Emit setiap 100ms saat audio diputar.
`addListener`	Dengarkan perubahan status playback, termasuk kontrol pemutaran di notifikasi dan lock-screen. Di-emit oleh Android dan iOS. Implementasi Web saat ini tidak meng-emit event ini.
`clearCache`	Hapus cache audio untuk file audio remote.
`setDebugMode`	Atur logging mode debug.
`getPluginVersion`	Dapatkan versi plugin native Capacitor.
`deinitPlugin`	Deinisialisasi plugin dan kembalikan pengaturan audio session semula. Metode ini menghentikan semua audio yang sedang diputar dan mengembalikan perubahan audio session yang dibuat oleh plugin. Gunakan ini saat Anda perlu memastikan kompatibilitas dengan plugin audio lain.

Sumber Kebenaran

Referensi ini disinkronkan dari src/definitions.ts di capacitor-native-audio.

Lanjutkan dari @capgo/capacitor-native-audio

Jika Anda menggunakan @capgo/capacitor-native-audio untuk merencanakan perilaku media dan antarmuka native, hubungkan dengan Menggunakan @capgo/capacitor-native-audio untuk kapabilitas native di Using @capgo/capacitor-native-audio, Menggunakan @capgo/capacitor-live-activities untuk kemampuan native di Menggunakan @capgo/capacitor-live-activities, @capgo/capacitor-live-activities untuk detail implementasi di @capgo/capacitor-live-activities, Menggunakan @capgo/capacitor-video-player untuk kemampuan native di Menggunakan @capgo/capacitor-video-player, dan @capgo/capacitor-video-player untuk detail implementasi di @capgo/capacitor-video-player.