Zum Hauptinhalt springen

Media-Session Capacitor Plugin

Medienwiedergabe über Sperrbildschirm und Notification Center steuern

Installieren

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

Anleitung

Media Session in Capacitor nutzen

Auf dem Gerät testen

Lade die Capgo App herunter und scanne den QR code.

Media Session Plugin Vorschau-QR code

Verwendung von @capgo/capacitor-media-session

Capacitor Plugin, um die Media Session Steuerung des Geräts bereitzustellen.

Installieren

bun add @capgo/capacitor-media-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 { MediaSession } from '@capgo/capacitor-media-session';

API auf einen Blick

Methode Beschreibung
setMetadata Legt die Metadaten der aktuell abgespielten Medien fest.
setPlaybackState Aktualisiert den Playback-Status der Media Session.
setActionHandler Registriert einen Handler für eine Media Session Action.
setPositionState Aktualisiert den Positionsstatus der aktiven Media Session.

Beispiele

setMetadata()

Legt die Metadaten der aktuell abgespielten Medien fest.

import { MediaSession } from '@capgo/capacitor-media-session';

await MediaSession.setMetadata({ album: 'album' });

setPlaybackState()

Aktualisiert den Playback-Status der Media Session.

import { MediaSession } from '@capgo/capacitor-media-session';

await MediaSession.setPlaybackState({ playbackState: 'none' });

setActionHandler()

Registriert einen Handler für eine Media Session Action.

import { MediaSession } from '@capgo/capacitor-media-session';

await MediaSession.setActionHandler({ action: 'play' }, (details) => {
  console.log(details);
});

setPositionState()

Aktualisiert den Positionsstatus der aktiven Media Session.

import { MediaSession } from '@capgo/capacitor-media-session';

await MediaSession.setPositionState({
  duration: 1000,
  playbackRate: 1,
  position: 10,
});

Vollständige Referenz

Weiter mit der Nutzung von @capgo/capacitor-media-session

Wenn du es nutzt Nutzung von @capgo/capacitor-media-session um Dashboard- und API-Operationen zu planen, verbinde es mit @capgo/capacitor-media-session für die Implementierungsdetails in @capgo/capacitor-media-session, Erste Schritte für die Implementierungsdetails in Erste Schritte, API Übersicht für Details zur Implementierung im API Overview, Einführung für die Implementierungsdetails in der Einleitung und API Schlüssel für die Implementierungsdetails in den API Keys.

FAQ

Media Session Plugin FAQ

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

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

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

Ja. Media 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-media-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-media-session kostenlos und Open Source?

Ja. Der Quellcode (code) ist auf GitHub unter https://github.com/Cap-go/capacitor-media-session/ öffentlich einsehbar, und das Package ist kostenlos über npm installierbar. Bug-Reports und Pull Requests sind willkommen.

Kann ich code, die Media 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.

Media Session Änderungen ohne App-Review ausrollen

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