Allez directement au contenu principal
@capgo/capacitor-audio-natif Renommé Renommé à partir de @capgo/audio-natif en @capgo/capacitor-audio-natif. Médias Source ouverte

Audio natif plugin Capacitor

Jouez des fichiers audio courts avec une latence basse en utilisant l'engin audio natif pour les jeux et les 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 l'audio natif dans Capacitor

Utiliser @capgo/capacitor-audio natif

Un plugin natif pour l'engine audio native

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 - Jouer un fichier audio une 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

Jouer un fichier audio une 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érifiez 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

Continuez à partir de l'utilisation de @capgo/capacitor-audio-natif

Si vous utilisez L'utilisation de @capgo/capacitor-audio-natif pour planifier le comportement des médias et de l'interface natives, connectez-l’avec @capgo/capacitor-audio-natif pour les détails d'implémentation dans @capgo/capacitor-audio-natif Prise en main pour les détails d'implémentation dans Getting Started, Utilisation de @capgo/capacitor-activités-en-vivre pour la capacité native dans Utilisation de @capgo/capacitor-activités-en-vivre, @capgo/capacitor-activités-en-vivre pour les détails d'implémentation dans @capgo/capacitor-activités-en-vivre, et Utilisation de @capgo/capacitor-joueur-de-videos pour la capacité native dans Utilisation de @capgo/capacitor-joueur-de-videos.

FAQ

FAQ du constructeur de build natif

Comment installez-vous le plugin Audio natif dans une application Capacitor ?

Run "bun add @capgo/capacitor-native-audio" (or "npm install @capgo/capacitor-native-audio"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-native-audio" in your app code.

Does @capgo/capacitor-native-audio work with React, Vue and Angular?

Yes. Native Audio is a Capacitor package, so it works with any web framework that runs inside Capacitor, including Ionic, React, Vue, Angular, Svelte and plain JavaScript.

Quelle version de Capacitor est prise en charge par @capgo/capacitor-native-audio ?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

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

Yes. La source code est publique sur GitHub à https://github.com/Cap-go/capacitor-audio-natif/ et le package est gratuit pour l'installation depuis npm.

Peut-on mettre à jour code qui utilise l'audio natif sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin modifie l'audio natif code, il faut donc une nouvelle mise à jour de l'application. Une fois cela fait, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être envoyées instantanément avec les mises à jour Capgo en direct.

Expédiez les modifications d'audio natif sans attendre la revue de l'application

Une fois le plugin dans votre magasin de build, Capgo les mises à jour en temps réel poussent vos modifications JavaScript, HTML et CSS chez les utilisateurs en quelques minutes.

Démarrez avec Capgo