Saltar al contenido principal
Volver a plugins
@capgo/audio-nativo
Tutoriales
por github.com/Cap-go

Audio nativo

Reproduce archivos de audio cortos con baja latencia utilizando el motor de audio nativo para juegos y aplicaciones

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