Vai al contenuto principale
Torna ai plugin
@capgo/audio-nativo
Tutorial
da github.com/Cap-go

Audio nativo

Gioca a file audio brevi con bassa latenza utilizzando l'engine di audio nativo per giochi e app

Guida

Tutorial su Audio Nativo

Utilizzo di @capgo/native-audio

Un plugin nativo per l'engine di audio nativo.

Installa

bun add @capgo/native-audio
bunx cap sync

Cosa Questo Plugin Espone

  • configure - Configura il lettore di audio.
  • preload - Carica un file audio.
  • playOnce - Gioca un file audio una volta con pulizia automatica.
  • isPreloaded - Verifica se un file audio è caricato.

Esempio di utilizzo

configure

Configura il lettore di audio.

import { NativeAudio } from '@capgo/native-audio';

await NativeAudio.configure({} as ConfigureOptions);

preload

Carica un file audio.

import { NativeAudio } from '@capgo/native-audio';

await NativeAudio.preload({} as PreloadOptions);

playOnce

Gioca un file audio una volta con pulizia automatica.

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

Verifica se un file audio è caricato.

import { NativeAudio } from '@capgo/native-audio';

await NativeAudio.isPreloaded({} as PreloadOptions);

Riferimento completo