Guide
Tutoriel sur l'Audio Natif
En utilisant @capgo/native-audio
Un plugin natif pour le moteur audio natif.
Installer
bun add @capgo/native-audio
bunx cap sync
Ce que ce plugin expose
configure- Configurer le lecteur audio.preload- Charger un fichier audio.playOnce- Jouer un fichier audio une fois avec nettoyage automatique.isPreloaded- Vérifiez si un fichier audio est préchargé.
Exemple d'utilisation
configure
Configurez le lecteur audio.
import { NativeAudio } from '@capgo/native-audio';
await NativeAudio.configure({} as ConfigureOptions);
preload
Charger un fichier audio.
import { NativeAudio } from '@capgo/native-audio';
await NativeAudio.preload({} as PreloadOptions);
playOnce
Jouez un fichier audio une fois avec nettoyage automatique.
import { NativeAudio } from '@capgo/native-audio';
// Simple one-shot playback
await NativeAudio.playOnce({ assetPath: 'audio/notification.mp3' });
// Play and delete the file after completion
await NativeAudio.playOnce({
assetPath: 'file:///path/to/temp/audio.mp3',
isUrl: true,
deleteAfterPlay: true
});
// Get the assetId to control playback
const { assetId } = await NativeAudio.playOnce({
assetPath: 'audio/long-track.mp3',
autoPlay: true
});
// Later, you can stop it manually if needed
await NativeAudio.stop({ assetId });
isPreloaded
Vérifiez si un fichier audio est préchargé.
import { NativeAudio } from '@capgo/native-audio';
await NativeAudio.isPreloaded({} as PreloadOptions);
Référence complète
- GitHub: https://github.com/Cap-go/capacitor-native-audio/
- Documentation : /docs/plugins/native-audio/