Zum Hauptinhalt springen

Medien-Sitzung Capacitor Plugin

Medienwiedergabe steuern von Bildschirm der Anlage und Zentrum der Benachrichtigung

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

Verwenden Sie Media Session in Capacitor

Testen Sie auf Gerät

Laden Sie die Capgo-App herunter, dann scannen Sie das QR-code.

Vorschau-Link für das Media-Sessions-Plugin code

Verwendung von @capgo/capacitor-media-session

Capacitor-Plugin, um die Medien-Sitzungssteuerungen des Geräts freizugeben.

Installieren

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

bunx cap sync kopiert das native code-Plugin in Ihre native Projekte. Führen Sie es erneut aus, nachdem jede Plugin-Upgrade durchgeführt wurde.

Importieren

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

API im Überblick

Methode Beschreibung
setMetadata Setzt die Metadaten der aktuellen Medienwiedergabe.
setPlaybackState Aktualisiert den Wiedergabezustand der Mediensession.
setActionHandler Registriert einen Handler für eine Mediensession-Aktion.
setPositionState Aktualisiert den Positionszustand für die aktive Mediensession.

Beispiele

setMetadata()

Setzt die Metadaten der aktuellen Medienwiedergabe.

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

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

setPlaybackState()

Aktualisiert den Wiedergabezustand der Mediensession.

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

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

setActionHandler()

Registriert einen Handler für eine Mediensession-Aktion.

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

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

setPositionState()

Aktualisiert den Positionszustand für die aktive Mediensession.

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

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

Vollständige Referenz

Mit @capgo/capacitor-media-session weitermachen

Wenn Sie @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-media-session verwenden Verwendung von @capgo/capacitor-media-session um das Dashboard und die API-Operationen zu planen, verbinden Sie es mit @capgo/capacitor-Medien-Sitzung zur Implementierungsdetail in @capgo/capacitor-media-session Getting Started zur Implementierungsdetail in Anleitung API-Übersicht zur Implementierungsdetail in API-Übersicht Einführung zur Implementierungsdetail in Einführung, und API Schlüssel zur Implementierungsdetail in API Schlüssel.

FAQ

FAQ zur Media Session-Plugin

Wie installiere ich den Media Session-Plugin in einer Capacitor-Anwendung?

Laufen Sie "bun add @capgo/capacitor-media-session" (oder "npm install @capgo/capacitor-media-session"), dann laufen Sie "bunx cap sync" so dass die iOS- und Android-Projekte die native code aufnehmen. Importieren Sie es von "@capgo/capacitor-media-session" in Ihrer code-Anwendung.

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

Ja. Media Session ist ein Capacitor-Paket, also funktioniert es mit jedem Webframework, das innerhalb von Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und plain JavaScript.

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

Capgo-Plugins folgen der Capacitor-Version: verwenden Sie die Plugin-Version, die Ihrem Capacitor-Majorversion entspricht (z.B. Plugin v8 mit Capacitor 8). Die Kompatibilitäts-Tabelle im GitHub-README listet die unterstützten Versionen auf.

ist @capgo/capacitor-media-session kostenlos und Open-Source?

Ja. Die Quellcode von code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-media-session/ und das Paket ist kostenlos von npm installierbar. Bug-Reports und Pull-Requests sind willkommen.

Kann ich code aktualisieren, das Media Session verwendet, ohne eine App-Store-Bewertung?

Installieren oder aktualisieren Sie das Plugin ändert die native code, daher benötigt es eine neue Build des Speicherorts. Anschließend können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort mit Capgo Live-Updates verschickt werden.

Schaffe Änderungen an Media Session ohne auf die App-Überprüfung zu warten

Einmal das Plugin in Ihrem Store-Build installiert, werden Capgo lebendige Updates Ihre JavaScript-, HTML- und CSS-Änderungen in Minuten an die Benutzer pushen.

Start mit Capgo