@capgo/capacitor-native-audio

Resumen

Usa @capgo/capacitor-native-audio cuando tu app Capacitor requiere reproducción fluida para sonidos de la UI, clips cortos o sesiones musicales sin lidiar con múltiples APIs de audio nativas. Precarga assets, reproduce loops, aplica fades, transmite URLs remotas o HLS y, opcionalmente, muestra controles de reproducción en la pantalla de bloqueo.

Casos de uso: SFX de juegos, sonidos de notificación, meditación guiada, reproductores de podcast y cualquier flujo que deba coexistir con otras apps en la sesión de audio del dispositivo.

Soporte de plataformas

Plataforma	Soporte	Notas
iOS	Sí	AVFoundation, Now Playing opcional y categorías de audio session
Android	Sí	Reproducción de medios, notificaciones y servicio en primer plano opcional para segundo plano
Web	Parcial	Reproducción principal; algunos eventos de listener no se emiten en web

Funcionalidades principales

• configure - Configura el reproductor de audio.
• preload - Carga un archivo de audio.
• playOnce - Reproduce un archivo de audio una vez con limpieza automática.
• isPreloaded - Comprueba si un archivo de audio está precargado.

Público API

Método	Descripción
configure	Configura el reproductor de audio.
preload	Carga un archivo de audio.
playOnce	Reproduce un archivo de audio una vez con limpieza automática.
isPreloaded	Comprueba si un archivo de audio está precargado.
play	Reproduce un archivo de audio.
pause	Pausa un archivo de audio.
resume	Reanuda un archivo de audio.
loop	Detiene un archivo de audio.
stop	Detiene un archivo de audio.
unload	Descarga un archivo de audio.
setVolume	Ajusta el volumen de un archivo de audio.
setRate	Ajusta la velocidad de un archivo de audio.
setCurrentTime	Establece el tiempo actual de un archivo de audio.
getCurrentTime	Obtén el tiempo actual de un archivo de audio.
getDuration	Obtén la duración de un archivo de audio en segundos.
isPlaying	Check if an audio file is playing.
addListener	Escucha el evento de finalización.
addListener	Escucha las actualizaciones del tiempo actual. Se emite cada 100ms mientras el audio se reproduce.
addListener	Escucha cambios en el estado de reproducción, incluyendo controles de notificación y pantalla de bloqueo. Emitido por Android e iOS. La implementación Web actual no emite este evento.
clearCache	Limpia la caché de audio para archivos remotos.
setDebugMode	Configura el registro del modo debug.
getPluginVersion	Obtén la versión del plugin nativo Capacitor.
deinitPlugin	Desinicializa el plugin y restaura la configuración original de la sesión de audio. Este método detiene todo el audio en reproducción y revierte cualquier cambio en la sesión de audio realizado por el plugin. Úsalo cuando necesites asegurar la compatibilidad con otros plugins de audio.

Fuente de verdad

Esta referencia se sincroniza desde src/definitions.ts en capacitor-native-audio.

Continúa desde @capgo/capacitor-native-audio

Si estás usando @capgo/capacitor-native-audio para planificar el comportamiento de los medios nativos y la interfaz, conéctalo con Uso de @capgo/capacitor-native-audio para la capacidad nativa en el uso de @capgo/capacitor-native-audio, Uso de @capgo/capacitor-live-activities para la capacidad nativa en Uso de @capgo/capacitor-live-activities, @capgo/capacitor-live-activities para los detalles de implementación en @capgo/capacitor-live-activities, Uso de @capgo/capacitor-video-player para la capacidad nativa en Uso de @capgo/capacitor-video-player, y @capgo/capacitor-video-player para el detalle de implementación en @capgo/capacitor-video-player.