Salta al contenuto principale

Registratore Audio plugin Capacitor

Registra audio su iOS, Android e Web con controlli e formati semplici

Installazione

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

Guida

Come usare Audio Recorder in Capacitor

Test sul dispositivo

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

QR di anteprima del plugin Audio Recorder code

Utilizzo di @capgo/capacitor-audio-recorder

Contratto del plugin Capacitor per la registrazione audio.

Installazione

bun add @capgo/capacitor-audio-recorder
bunx cap sync

bunx cap sync copia il code nativo del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.

Importa

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';

API in breve

Metodo Descrizione
startRecording Avvia la registrazione audio tramite il microfono del dispositivo.
pauseRecording Metti in pausa la registrazione in corso. Disponibile solo su Android (API 24+), iOS e Web.
resumeRecording Riprendi una registrazione precedentemente in pausa.
stopRecording Interrompi la registrazione attuale e salva l'audio registrato.
cancelRecording Annulla la registrazione attuale e scarta l'audio catturato.
getRecordingStatus Recupera lo stato attuale della registrazione.
getCurrentAmplitude Recupera l'ampiezza dell'input attuale (livello microfono) come valore normalizzato nell' [0, 1] intervallo.
checkPermissions Restituisce lo stato attuale dei permessi per l'accesso al microfono.
requestPermissions Richiede l'autorizzazione per accedere al microfono.

Esempi

startRecording()

Avvia la registrazione audio tramite il microfono del dispositivo.

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';

await CapacitorAudioRecorder.startRecording();

pauseRecording()

Metti in pausa la registrazione in corso. Disponibile solo su Android (API 24+), iOS e Web.

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';

await CapacitorAudioRecorder.pauseRecording();

resumeRecording()

Riprendi una registrazione precedentemente in pausa.

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';

await CapacitorAudioRecorder.resumeRecording();

stopRecording()

Interrompe la registrazione attuale e salva l'audio registrato.

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';

const result = await CapacitorAudioRecorder.stopRecording();
console.log(result);

cancelRecording()

Annulla la registrazione attuale e scarta l'audio catturato.

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';

await CapacitorAudioRecorder.cancelRecording();

getRecordingStatus()

Recupera lo stato attuale della registrazione.

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';

const result = await CapacitorAudioRecorder.getRecordingStatus();
console.log(result);

La tabella sopra elenca i 9 metodi core. Listener, helper di versione e il contratto completo di ogni metodo sono documentati nella repository GitHub.

Ascolta gli eventi

addListener restituisce un handle. Chiama handle.remove() quando la schermata viene smontata, o CapacitorAudioRecorder.removeAllListeners() per rimuovere tutti i listener.

Riferimento completo

Continua da Using @capgo/capacitor-audio-recorder

Se stai usando Utilizzo di @capgo/capacitor-audio-recorder per pianificare il comportamento dei media nativi e dell'interfaccia, collegalo a @capgo/capacitor-audio-recorder per i dettagli di implementazione in @capgo/capacitor-audio-recorder, Guida rapida per i dettagli di implementazione in Getting Started, Usare @capgo/capacitor-live-activities per la funzionalità nativa nella guida Usare @capgo/capacitor-live-activities, @capgo/capacitor-live-activities per i dettagli di implementazione in @capgo/capacitor-live-activities, e Usare @capgo/capacitor-video-player per la funzionalità nativa in Utilizzo di @capgo/capacitor-video-player.

FAQ

FAQ del plugin Audio Recorder

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

Esegui "bun add @capgo/capacitor-audio-recorder" (o "npm install @capgo/capacitor-audio-recorder"), poi lancia "bunx cap sync" in modo che i progetti iOS e Android includano il code nativo. Importalo da "@capgo/capacitor-audio-recorder" nel code della tua app.

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

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

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

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-audio-recorder è free e open source?

Sì. Il codice sorgente di code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-audio-recorder/ e il pacchetto è gratuito su npm. Bug report e pull request sono i benvenuti.

Posso aggiornare code che usa Audio Recorder 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 i live update di Capgo.

Distribuisci le modifiche ad Audio Recorder senza attendere la revisione dell'app

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

Inizia con Capgo