Guide
Comment utiliser Native Audio dans Capacitor
Utiliser @capgo/capacitor-native-audio
Un plugin natif pour le moteur audio natif.
Installer
npm install @capgo/capacitor-native-audio
npx cap sync
Ce que ce plugin expose
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é.
Exemple d'utilisation
configure
Configurer le lecteur audio.
import { NativeAudio } from '@capgo/capacitor-native-audio';
await NativeAudio.configure({
focus: false,
background: false,
ignoreSilent: false,
showNotification: false,
backgroundPlayback: false,
});
preload
Charger un fichier audio.
import { NativeAudio } from '@capgo/capacitor-native-audio';
await NativeAudio.preload({
assetPath: 'path/to/file',
assetId: 'asset-id-123',
});
playOnce
Lire un fichier audio une seule fois avec nettoyage automatique.
import { NativeAudio } from '@capgo/capacitor-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érifier si un fichier audio est préchargé.
import { NativeAudio } from '@capgo/capacitor-native-audio';
const result = await NativeAudio.isPreloaded({
assetPath: 'path/to/file',
assetId: 'asset-id-123',
});
console.log(result);
Référence complète
- GitHub : https://github.com/Cap-go/capacitor-native-audio/
- Docs : /docs/plugins/native-audio/
Continuer à partir de « Utiliser @capgo/capacitor-native-audio »
Si vous utilisez Utiliser @capgo/capacitor-native-audio pour planifier le comportement des médias et de l'interface natifs, connectez-l’à @capgo/capacitor-native-audio pour les détails d'implémentation dans @capgo/capacitor-native-audio, Prise en main pour les détails d'implémentation dans Getting Started Utiliser @capgo/capacitor-live-activities pour la capacité native dans Utiliser @capgo/capacitor-live-activities @capgo/capacitor-live-activities pour les détails d'implémentation dans @capgo/capacitor-live-activities, et Utiliser @capgo/capacitor-video-player pour la fonctionnalité native dans Utilisation de @capgo/capacitor-video-player.