Zum Hauptinhalt springen

Audio-Session Capacitor Plugin

Konfiguriere die iOS-Audio-Session für Background-Playback, Mixing und Routing-Steuerung

Installieren

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

Anleitung

So nutzt du Audio Session in Capacitor

Auf dem Gerät testen

Lade die Capgo App herunter und scanne den QR code.

QR-Code zur Audio Session Plugin-Vorschau code

@capgo/capacitor-audio-session verwenden

Nur für iOS: Plugin zum Abfragen und Steuern der Audio Session sowie zum Überwachen von Routenänderungen und Unterbrechungen.

Installieren

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

bunx cap sync kopiert den nativen code des Plugins in deine nativen Projekte. Nach jedem Plugin-Upgrade erneut ausführen.

Importieren

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

API auf einen Blick

Methode Beschreibung
currentOutputs Die aktuell aktiven Audio-Ausgabewege abrufen.
overrideOutput Den aktuellen Audio-Ausgabeweg überschreiben.

Beispiele

currentOutputs()

Die aktuell aktiven Audio-Ausgabewege abrufen.

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

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

overrideOutput()

Den aktuellen Audio-Ausgabeweg überschreiben.

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

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

Events abonnieren

addListener gibt ein Handle zurück. Rufe handle.remove() wenn der Screen unmountet wird.

Vollständige Referenz

Weiter mit „@capgo/capacitor-audio-session“ verwenden

Wenn du es nutzt @capgo/capacitor-audio-session verwenden , um natives Media- und Interface-Verhalten zu planen, verbinde es mit @capgo/capacitor-audio-session für die Implementierungsdetails in @capgo/capacitor-audio-session, Erste Schritte für die Implementierungsdetails in Erste Schritte, @capgo/capacitor-live-activities verwenden für die native Funktion in „@capgo/capacitor-live-activities verwenden“, @capgo/capacitor-live-activities für die Implementierungsdetails in @capgo/capacitor-live-activities und Verwendung von @capgo/capacitor-video-player für die native Funktionalität in „Verwendung von @capgo/capacitor-video-player.“

FAQ

Audio Session Plugin FAQ

Wie installiere ich das Audio Session Plugin in einer Capacitor-App?

Führe "bun add @capgo/capacitor-audio-session" (oder "npm install @capgo/capacitor-audio-session") aus, danach "bunx cap sync", damit die iOS- und Android-Projekte die nativen code übernehmen. Importiere es in deiner code-App aus "@capgo/capacitor-audio-session".

Funktioniert @capgo/capacitor-audio-session mit React, Vue und Angular?

Ja. Audio Session ist ein Capacitor Package und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

Welche Capacitor-Version unterstützt @capgo/capacitor-audio-session?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capgo/capacitor-audio-session kostenlos und Open Source?

Ja. Der code-Code ist auf GitHub öffentlich einsehbar unter https://github.com/Cap-go/capacitor-audiosession/ und das Package lässt sich kostenlos über npm installieren. Bug-Reports und Pull Requests sind willkommen.

Kann ich code, das Audio Session nutzt, ohne App Store Review aktualisieren?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

Audio-Session-Änderungen ausrollen, ohne auf das App-Review zu warten

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo