Salta al contenuto principale
@capgo/capacitor-native-audio Rinominato Rinominato da @capgo/native-audio a @capgo/capacitor-native-audio. Media Open source

Native Audio Plugin Capacitor

Riproduci file audio brevi con bassa latenza usando il motore audio nativo per giochi e app

Installa

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

Guida

Come usare Native Audio in Capacitor

Testa sul dispositivo

Scarica l'app Capgo, poi scansiona il QR code.

Anteprima QR plugin Native Audio code

Utilizzo di @capgo/capacitor-native-audio

Un plugin nativo per il motore audio nativo.

Installa

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

Cosa espone questo plugin

  • configure - Configura il player audio.
  • preload - Carica un file audio.
  • playOnce - Riproduci un file audio una volta con pulizia automatica.
  • isPreloaded - Verifica se un file audio è precaricato.

Esempio d'uso

configure

Configura l'audio player.

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

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

preload

Carica un file audio.

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

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

playOnce

Riproduci un file audio una sola volta con cleanup automatico.

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

Controlla se un file audio è precaricato.

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

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

Riferimento completo

Continua da Utilizzo di @capgo/capacitor-native-audio

Se stai usando Utilizzo di @capgo/capacitor-native-audio per pianificare il comportamento dei media nativi e dell'interfaccia, collegalo a @capgo/capacitor-native-audio per i dettagli di implementazione in @capgo/capacitor-native-audio, Per iniziare per i dettagli di implementazione nella guida introduttiva, Uso di @capgo/capacitor-live-activities per la funzionalità nativa nella pagina Uso di @capgo/capacitor-live-activities, @capgo/capacitor-live-activities per i dettagli di implementazione in @capgo/capacitor-live-activities, e Uso di @capgo/capacitor-video-player per la funzionalità nativa in Usare @capgo/capacitor-video-player.

FAQ

FAQ sul plugin Native Audio

Come installo il plugin Native Audio in un'app Capacitor?

Esegui "bun add @capgo/capacitor-native-audio" (o "npm install @capgo/capacitor-native-audio"), poi lancia "bunx cap sync" in modo che i progetti iOS e Android includano le code native. Importalo da "@capgo/capacitor-native-audio" nel tuo code.

@capgo/capacitor-native-audio funziona con React, Vue e Angular?

Sì. Native Audio è un pacchetto Capacitor, quindi funziona con qualsiasi framework web in esecuzione all'interno di Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-native-audio?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-native-audio è gratuito e open source?

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-native-audio/ e il pacchetto si installa gratuitamente da npm. Bug report e pull request sono benvenuti.

Posso aggiornare code che usa Native Audio senza passare per la revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Pubblica modifiche a Native Audio senza aspettare la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo