Guía
Cómo utilizar Audio Nativo en Capacitor
Usando @capgo/capacitor-audio nativo
Un plugin nativo para el motor de audio nativo.
Instalar
npm install @capgo/capacitor-native-audio
npx cap sync
¿Qué se expone con 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- Check if an audio file is preloaded.
Uso de ejemplo
configure
Configurar el reproductor de audio.
import { NativeAudio } from '@capgo/capacitor-native-audio';
await NativeAudio.configure({
focus: false,
background: false,
ignoreSilent: false,
showNotification: false,
backgroundPlayback: false,
});
preload
Cargar un archivo de audio.
import { NativeAudio } from '@capgo/capacitor-native-audio';
await NativeAudio.preload({
assetPath: 'path/to/file',
assetId: 'asset-id-123',
});
playOnce
Reproducir un archivo de audio una vez con limpieza automática.
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
Check if an audio file is preloaded.
import { NativeAudio } from '@capgo/capacitor-native-audio';
const result = await NativeAudio.isPreloaded({
assetPath: 'path/to/file',
assetId: 'asset-id-123',
});
console.log(result);
Referencia completa
- GitHub: https://github.com/Cap-go/capacitor-audio-nativo/
- Documentación: /docs/plugins/audio-nativo/
Sigue adelante desde Usando @capgo/capacitor-audio-nativo
Si estás utilizando Usando @capgo/capacitor-audio-nativo para planificar el comportamiento de medios nativos e interfaces, conecta con @capgo/capacitor-audio-nativo para los detalles de implementación en @capgo/capacitor-audio-nativo Getting Started para los detalles de implementación en Getting Started, Usando @capgo/capacitor-actividades-en-vivo para la capacidad nativa en Usando @capgo/capacitor-actividades-en-vivo, @capgo/capacitor-actividades-en-vivo para los detalles de implementación en @capgo/capacitor-actividades-en-vivo, y Usando @capgo/capacitor-reproductor-de-videos para la capacidad nativa en Usando @capgo/capacitor-reproductor-de-videos.