Erste Schritte

ℹ️ Plattformunterstützung: Die Audio-Session-API ist auf iOS verfügbar. Aufrufe auf Android und im Web werden ohne Auswirkung aufgelöst, sodass Sie gemeinsame Logik beibehalten können.

1. Paket installieren

   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. iOS-Plattform synchronisieren

   npm

   npx cap sync ios

   pnpm

   pnpm cap sync ios

   yarn

   yarn cap sync ios

   bun

   bunx cap sync ios

Verfügbare Ausgänge überprüfen

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

const outputs = await AudioSession.currentOutputs();

if (outputs.includes(AudioSessionPorts.BLUETOOTH_A2DP)) {
  console.log('Bluetooth-Lautsprecher verbunden');
}

Auf Lautsprecher-Modus umschalten

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

await AudioSession.overrideOutput(OutputOverrideType.speaker);

// System-Routing wiederherstellen, wenn Sie fertig sind
await AudioSession.overrideOutput(OutputOverrideType.default);

Auf Routen- und Unterbrechungsereignisse hören

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

const routeListener = await AudioSession.addListener('routeChanged', (reason) => {
  if (reason === RouteChangeReasons.NEW_DEVICE_AVAILABLE) {
    console.log('Benutzer hat eine neue Audio-Route verbunden');
  }
});

const interruptionListener = await AudioSession.addListener('interruption', (type) => {
  if (type === InterruptionTypes.BEGAN) {
    // Wiedergabe während der Unterbrechung pausieren
  } else {
    // Wiedergabe fortsetzen
  }
});

// Später während der Bereinigung
await routeListener.remove();
await interruptionListener.remove();

Berechtigungen

• iOS: Fügen Sie alle erforderlichen Hintergrund-Audio-Modi (z.B. audio, voice) in ios/App/App/Info.plist hinzu, wenn Ihre App Audio im Hintergrund abspielt.
• Andere Plattformen: Keine zusätzliche Einrichtung erforderlich; Methoden werden mit leeren Ergebnissen aufgelöst.