Salta al contenuto principale

Sessione Audio Plugin Capacitor

Configura la sessione audio iOS per il playback in background, il mixing e il controllo del routing

Installa

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

Guida

Come usare Audio Session in Capacitor

Testa sul dispositivo

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

Anteprima QR del plugin Audio Session code

Utilizzo di @capgo/capacitor-audio-session

Plugin solo per iOS per interrogare e controllare l'audio session output e monitorare cambi di rotta e interruzioni.

Installa

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

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

Importa

import { AudioSession } from '@capgo/capacitor-audio-session';

API in breve

Metodo Descrizione
currentOutputs Ottieni le route di output audio attive.
overrideOutput Sovrascrivi la route di output audio corrente.

Esempi

currentOutputs()

Ottieni le route di output audio attive.

import { AudioSession } from '@capgo/capacitor-audio-session';

const result = await AudioSession.currentOutputs();
console.log(result);

overrideOutput()

Sovrascrivi la route di output audio corrente.

import { AudioSession } from '@capgo/capacitor-audio-session';

const result = await AudioSession.overrideOutput('default');
console.log(result);

Ascolta gli eventi

addListener restituisce un handle. Chiama handle.remove() quando la schermata viene smontata.

Riferimento completo

Continua da Usare @capgo/capacitor-audio-session

Se stai usando Utilizzo di @capgo/capacitor-audio-session per pianificare il comportamento dei media nativi e dell'interfaccia, collegalo a @capgo/capacitor-audio-session per i dettagli implementativi in @capgo/capacitor-audio-session, 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 Audio Session

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

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

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

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

Quale versione di Capacitor è supportata da @capgo/capacitor-audio-session?

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

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

Posso aggiornare code che usa Audio Session 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.

Distribuisci modifiche alla Audio Session senza attendere 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