Vai al contenuto principale
@capgo/capacitor-audio-nativo Rinominato Rinominato da @capgo/native-audio a @capgo/capacitor-native-audio. Media Apre

Icona del plugin Audio nativo Plugin Capacitor

Gioca a file audio brevi con bassa latenza utilizzando il motore audio nativo per giochi e app

Install

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 utilizzare l'audio nativo in Capacitor

Utilizza @capgo/capacitor-audio-nativo

Un plugin nativo per l'engine di audio nativo.

Installa

npm install @capgo/capacitor-native-audio
npx 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 - Controlla se un file audio è caricato in anticipo.

Esempi di utilizzo

configure

Configura il lettore audio.

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

Gioca un file audio una volta con pulizia automatica.

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 è caricato in anticipo.

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 @capgo/capacitor-audio-nativo/

Se stai utilizzando Utilizzo @capgo/capacitor-audio-nativo/ per pianificare il comportamento dei media e dell'interfaccia nativi, connettilo con @capgo/capacitor-audio-nativo per i dettagli di implementazione in @capgo/capacitor-audio-nativo Getting Started per i dettagli di implementazione in Iniziare Utilizzando @capgo/capacitor-attività-vive per la capacità nativa in Utilizzando @capgo/capacitor-attività-vive @capgo/capacitor-attività-vive per i dettagli di implementazione in @capgo/capacitor-attività-vive, e Utilizzando @capgo/capacitor-lettore-video per la capacità nativa in Utilizzando @capgo/capacitor-lettore-video

FAQ

Domande Frequenti per il plugin Audio nativo

Come posso installare il plugin Audio nativo in un'app Capacitor?

Esegui "bun add @capgo/capacitor-audio nativo" (o "npm install @capgo/capacitor-audio nativo"), quindi esegui "bunx cap sync" affinché i progetti iOS e Android recuperino il codice nativo code. Importalo da "@capgo/capacitor-audio nativo" nella tua app code.

Funziona @capgo/capacitor-audio nativo con React, Vue e Angular?

Sì. L'audio nativo è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno di Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Qual è la versione di Capacitor supportata da @capgo/capacitor-native-audio?

I pacchetti Capgo seguono la versione maggiore di Capacitor: utilizza la versione maggiore del plugin che corrisponde alla tua versione maggiore 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 di code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-native-audio/ e il pacchetto è gratuito per l'installazione da npm. I segnalazioni di bug e le richieste di pull sono benvenute.

Posso aggiornare code che utilizza l'audio nativo senza una revisione dell'App Store?

L'installazione o l'aggiornamento del plugin modifica l'code nativo, quindi richiede una nuova costruzione dello store. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere spedite immediatamente con gli aggiornamenti Capgo live.

Invia modifiche di Native Audio senza dover attendere la revisione dell'app

Una volta che il plugin è presente nella tua store build, Capgo le aggiornamenti in tempo reale inviano le tue modifiche JavaScript, HTML e CSS agli utenti in pochi minuti.

Inizia con Capgo