@capgo/capacitor-native-audio

Aperçu

Utiliser @capgo/capacitor-native-audio lorsque votre application Capacitor nécessite une lecture réactive pour des sons d'interface, des clips courts ou des sessions musicales sans avoir à jongler avec plusieurs API audio natives. Préchargez les assets, bouclez des pistes, gérez le fondu du volume, streamez des URL distantes ou du HLS, et affichez optionnellement les commandes de lecture sur l'écran de verrouillage.

Cas d'usage types : SFX de jeux, sons de notification, méditation guidée, lecteurs de podcasts ou tout flux devant coexister avec d'autres applications via la session audio de l'appareil.

Support des plateformes

Plateforme	Support	Notes
iOS	Oui	AVFoundation, Now Playing optionnel et catégories de session audio
Android	Oui	Lecture média, notifications, service de premier plan optionnel pour l'arrière-plan
Le Web	Partielle	Lecture de base ; certains événements d'écoute ne sont pas émis sur le web

Fonctionnalités clés

• configure - Configurer le lecteur audio.
• preload - Charger un fichier audio.
• playOnce - Lire un fichier audio une seule fois avec nettoyage automatique.
• isPreloaded - Vérifier si un fichier audio est préchargé.

API public

Méthode	Description
configure	Configurer le lecteur audio.
preload	Charger un fichier audio.
playOnce	Lire un fichier audio une seule fois avec nettoyage automatique.
isPreloaded	Vérifier si un fichier audio est préchargé.
play	Lire un fichier audio.
pause	Mettre en pause un fichier audio.
resume	Reprendre la lecture d'un fichier audio.
loop	Arrêter un fichier audio.
stop	Arrêter un fichier audio.
unload	Décharger un fichier audio.
setVolume	Régler le volume d'un fichier audio.
setRate	Régler la vitesse d'un fichier audio.
setCurrentTime	Régler le temps actuel d'un fichier audio.
getCurrentTime	Récupérer le temps actuel d'un fichier audio.
getDuration	Récupérer la durée d'un fichier audio en secondes.
isPlaying	Check if an audio file is playing.
addListener	Écouter l'événement de fin de lecture.
addListener	Écouter les mises à jour du temps actuel. Émis toutes les 100 ms pendant la lecture.
addListener	Écouter les changements d'état de lecture, incluant les contrôles de notification et d'écran de verrouillage. Émis par Android et iOS. L'implémentation Web actuelle ne l'émet pas.
clearCache	Vider le cache audio des fichiers audio distants.
setDebugMode	Configurer le logging du mode debug.
getPluginVersion	Récupère la version du plugin natif Capacitor.
deinitPlugin	Désinitialise le plugin et restaure les paramètres de la session audio d'origine. Cette méthode arrête toute lecture audio en cours et annule les modifications de session audio effectuées par le plugin. Utilisez cette méthode pour garantir la compatibilité avec d'autres plugins audio.

Source de vérité

Cette référence est synchronisée depuis src/definitions.ts dans capacitor-native-audio.

Continuer depuis @capgo/capacitor-native-audio

Si vous utilisez @capgo/capacitor-native-audio pour planifier le comportement des médias et de l'interface natifs, connectez-l’à Utiliser @capgo/capacitor-native-audio pour la fonctionnalité native dans « Utiliser @capgo/capacitor-native-audio », Utiliser @capgo/capacitor-live-activities pour la capacité native dans Utiliser @capgo/capacitor-live-activities @capgo/capacitor-live-activities pour le détail d'implémentation dans @capgo/capacitor-live-activities Utiliser @capgo/capacitor-video-player pour la capacité native dans Utiliser @capgo/capacitor-video-player, et @capgo/capacitor-video-player pour le détail d'implémentation dans @capgo/capacitor-video-player.