Aller directement au contenu principal
Retour aux plugins
@capgo/audio-natif
Tutoriel
par github.com/Cap-go

Audio natif

Jouez des fichiers audio courts avec une faible latence en utilisant l'engine audio natif pour les jeux et les applications

Guide

Tutoriel sur l'Audio Natif

En utilisant @capgo/native-audio

Un plugin natif pour le moteur audio natif.

Installer

bun add @capgo/native-audio
bunx cap sync

Ce que ce plugin expose

  • configure - Configurer le lecteur audio.
  • preload - Charger un fichier audio.
  • playOnce - Jouer un fichier audio une fois avec nettoyage automatique.
  • isPreloaded - Vérifiez si un fichier audio est préchargé.

Exemple d'utilisation

configure

Configurez le lecteur audio.

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

await NativeAudio.configure({} as ConfigureOptions);

preload

Charger un fichier audio.

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

await NativeAudio.preload({} as PreloadOptions);

playOnce

Jouez un fichier audio une fois avec nettoyage automatique.

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

Vérifiez si un fichier audio est préchargé.

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

await NativeAudio.isPreloaded({} as PreloadOptions);

Référence complète