Aller au contenu principal
@capgo/capacitor-native-audio Renommé Renommé de @capgo/native-audio à @capgo/capacitor-native-audio. Média Open source

Native Audio Plugin Capacitor

Jouez des fichiers audio courts avec une faible latence grâce au moteur audio natif pour vos jeux et applications

Installer

bun add @capgo/capacitor-native-audio bunx cap sync
npm, pnpm ou yarn
  • npm install @capgo/capacitor-native-audio
  • pnpm add @capgo/capacitor-native-audio
  • yarn add @capgo/capacitor-native-audio

Guide

Comment utiliser Native Audio dans Capacitor

Tester sur l'appareil

Téléchargez l'application Capgo, puis scannez le QR code.

Aperçu du plugin Native Audio QR code

Utiliser @capgo/capacitor-native-audio

Un plugin natif pour le moteur audio natif.

Installer

npm install @capgo/capacitor-native-audio
npx cap sync

Ce que ce plugin expose

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

Exemple d'utilisation

configure

Configurer le lecteur audio.

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

await NativeAudio.configure({
  focus: false,
  background: false,
  ignoreSilent: false,
  showNotification: false,
  backgroundPlayback: false,
});

preload

Charger un fichier audio.

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

await NativeAudio.preload({
  assetPath: 'path/to/file',
  assetId: 'asset-id-123',
});

playOnce

Lire un fichier audio une seule fois avec nettoyage automatique.

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

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

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

const result = await NativeAudio.isPreloaded({
  assetPath: 'path/to/file',
  assetId: 'asset-id-123',
});
console.log(result);

Référence complète

Continuer à partir de « Utiliser @capgo/capacitor-native-audio »

Si vous utilisez Utiliser @capgo/capacitor-native-audio pour planifier le comportement des médias et de l'interface natifs, connectez-l’à @capgo/capacitor-native-audio pour les détails d'implémentation dans @capgo/capacitor-native-audio, Prise en main pour les détails d'implémentation dans Getting Started Utiliser @capgo/capacitor-live-activities pour la capacité native dans Utiliser @capgo/capacitor-live-activities @capgo/capacitor-live-activities pour les détails d'implémentation dans @capgo/capacitor-live-activities, et Utiliser @capgo/capacitor-video-player pour la fonctionnalité native dans Utilisation de @capgo/capacitor-video-player.

FAQ

FAQ du plugin Native Audio

Comment installer le plugin Native Audio dans une application Capacitor ?

Exécutez « bun add @capgo/capacitor-native-audio » (ou « npm install @capgo/capacitor-native-audio »), puis lancez « bunx cap sync » pour que les projets iOS et Android prennent en compte le code natif. Importez-le depuis « @capgo/capacitor-native-audio » dans votre code.

Est-ce que @capgo/capacitor-native-audio fonctionne avec React, Vue et Angular ?

Oui. Native Audio est un package Capacitor, il fonctionne donc avec n'importe quel framework web tournant dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et le JavaScript pur.

Quelle version de Capacitor est supportée par @capgo/capacitor-native-audio ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

Est-ce que @capgo/capacitor-native-audio est gratuit et open source ?

Oui. Le code source code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-native-audio/ et le package est gratuit à installer via npm. Les rapports de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code utilisant Native Audio sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez les changements de Native Audio sans attendre la validation de l'app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo