Guide
Comment utiliser l'audio natif dans Capacitor
Utiliser @capgo/capacitor-audio natif
Un plugin natif pour l'engine audio native
Installer
npm install @capgo/capacitor-native-audio
npx cap sync
Ce que ce plugin expose
configure- Configurer le lecteur audiopreload- Charger un fichier audioplayOnce- Jouer un fichier audio une fois avec nettoyage automatiqueisPreloaded- 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
Jouer un fichier audio une 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érifiez 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-audio-natif/
- Documentation : /docs/plugins/audio-natif/
Continuez à partir de l'utilisation de @capgo/capacitor-audio-natif
Si vous utilisez L'utilisation de @capgo/capacitor-audio-natif pour planifier le comportement des médias et de l'interface natives, connectez-l’avec @capgo/capacitor-audio-natif pour les détails d'implémentation dans @capgo/capacitor-audio-natif Prise en main pour les détails d'implémentation dans Getting Started, Utilisation de @capgo/capacitor-activités-en-vivre pour la capacité native dans Utilisation de @capgo/capacitor-activités-en-vivre, @capgo/capacitor-activités-en-vivre pour les détails d'implémentation dans @capgo/capacitor-activités-en-vivre, et Utilisation de @capgo/capacitor-joueur-de-videos pour la capacité native dans Utilisation de @capgo/capacitor-joueur-de-videos.