Guida
Come usare Native Audio in Capacitor
Utilizzo di @capgo/capacitor-native-audio
Un plugin nativo per il motore audio nativo.
Installa
npm install @capgo/capacitor-native-audio
npx cap sync
Cosa espone questo plugin
configure- Configura l'audio player.preload- Carica un file audio.playOnce- Riproduci un file audio una sola volta con cleanup automatico.isPreloaded- Verifica se un file audio è precaricato.
Esempio d'uso
configure
Configura l'audio player.
import { NativeAudio } from '@capgo/capacitor-native-audio';
await NativeAudio.configure({
focus: false,
background: false,
ignoreSilent: false,
showNotification: false,
backgroundPlayback: false,
});
preload
Carica un file audio.
import { NativeAudio } from '@capgo/capacitor-native-audio';
await NativeAudio.preload({
assetPath: 'path/to/file',
assetId: 'asset-id-123',
});
playOnce
Riproduci un file audio una sola volta con cleanup automatico.
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
Verifica se un file audio è precaricato.
import { NativeAudio } from '@capgo/capacitor-native-audio';
const result = await NativeAudio.isPreloaded({
assetPath: 'path/to/file',
assetId: 'asset-id-123',
});
console.log(result);
Riferimento completo
- GitHub: https://github.com/Cap-go/capacitor-native-audio/
- Documentazione: /docs/plugins/native-audio/
Continua da Utilizzo di @capgo/capacitor-native-audio
Se stai usando Utilizzo di @capgo/capacitor-native-audio per pianificare il comportamento dei media nativi e dell'interfaccia, collegalo a @capgo/capacitor-native-audio per i dettagli di implementazione in @capgo/capacitor-native-audio, Per iniziare per i dettagli di implementazione nella guida introduttiva, Uso di @capgo/capacitor-live-activities per la funzionalità nativa nella pagina Uso di @capgo/capacitor-live-activities, @capgo/capacitor-live-activities per i dettagli di implementazione in @capgo/capacitor-live-activities, e Uso di @capgo/capacitor-video-player per la funzionalità nativa in Usare @capgo/capacitor-video-player.