Guía
Tutorial sobre Audio Nativo
Usando @capgo/audio-nativo
Un plugin nativo para el motor de audio nativo.
Instalar
bun add @capgo/native-audio
bunx cap sync
¿Qué se Exposición de este Plugin?
configure- Configurar el reproductor de audio.preload- Cargar un archivo de audio.playOnce- Reproducir un archivo de audio una vez con limpieza automática.isPreloaded- Verifique si un archivo de audio está cargado previamente.
Ejemplo de uso
configure
Configure el reproductor de audio.
import { NativeAudio } from '@capgo/native-audio';
await NativeAudio.configure({} as ConfigureOptions);
preload
Cargar un archivo de audio.
import { NativeAudio } from '@capgo/native-audio';
await NativeAudio.preload({} as PreloadOptions);
playOnce
Reproducir un archivo de audio una vez con limpieza automática.
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
Verifique si un archivo de audio está cargado previamente.
import { NativeAudio } from '@capgo/native-audio';
await NativeAudio.isPreloaded({} as PreloadOptions);
Referencia completa
- GitHub: https://github.com/Cap-go/capacitor-native-audio/
- Documentación: /docs/plugins/native-audio/