Iniziare

ℹ️ Supporto piattaforma: La sessione audio API è disponibile su iOS. Le chiamate a Android e il Web si risolvono senza alcun effetto in modo da poter mantenere la logica condivisa.

1. Installa il pacchetto

   npm

   npm i @capgo/capacitor-plugin-audiosession

   pnpm

   pnpm add @capgo/capacitor-plugin-audiosession

   yarn

   yarn add @capgo/capacitor-plugin-audiosession

   bun

   bun add @capgo/capacitor-plugin-audiosession

2. Sincronizza la piattaforma iOS

   npm

   npx cap sync ios

   pnpm

   pnpm cap sync ios

   yarn

   yarn cap sync ios

   bun

   bunx cap sync ios

Controlla gli output disponibili

import { AudioSession, AudioSessionPorts } from '@capgo/capacitor-plugin-audiosession';

const outputs = await AudioSession.currentOutputs();

if (outputs.includes(AudioSessionPorts.BLUETOOTH_A2DP)) {
  console.log('Bluetooth speaker connected');
}

Passa alla modalità altoparlante

import { AudioSession, OutputOverrideType } from '@capgo/capacitor-plugin-audiosession';

await AudioSession.overrideOutput(OutputOverrideType.speaker);

// Restore system routing when you are done
await AudioSession.overrideOutput(OutputOverrideType.default);

Ascolta gli eventi di percorso e di interruzione

import { AudioSession, RouteChangeReasons, InterruptionTypes } from '@capgo/capacitor-plugin-audiosession';

const routeListener = await AudioSession.addListener('routeChanged', (reason) => {
  if (reason === RouteChangeReasons.NEW_DEVICE_AVAILABLE) {
    console.log('User connected a new audio route');
  }
});

const interruptionListener = await AudioSession.addListener('interruption', (type) => {
  if (type === InterruptionTypes.BEGAN) {
    // Pause playback while we are interrupted
  } else {
    // Resume playback
  }
});

// Later during cleanup
await routeListener.remove();
await interruptionListener.remove();

Diritti

• iOS: aggiungi eventuali modalità audio di sottofondo richieste (ad esempio audio, voice) all’interno di ios/App/App/Info.plist se la tua app riproduce l’audio in background.
• Altre piattaforme: non è necessaria alcuna configurazione aggiuntiva; i metodi si risolveranno con risultati vuoti.