Salta al contenuto principale

Sessione multimediale Plugin Capacitor

Controlla la riproduzione media dalla schermata di blocco e dal centro notifiche

Installa

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

Guida

Come usare Media Session in Capacitor

Testa sul dispositivo

Scarica l'app Capgo, poi scansiona il QR code.

QR di anteprima del plugin Media Session code

Utilizzo di @capgo/capacitor-media-session

Plugin Capacitor per esporre i controlli Media Session del dispositivo.

Installa

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

bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.

Importa

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

API in breve

Metodo Descrizione
setMetadata Imposta i metadati del media in riproduzione.
setPlaybackState Aggiorna lo stato di riproduzione della media session.
setActionHandler Registra un handler per un'azione della media session.
setPositionState Aggiorna lo stato della posizione per la media session attiva.

Esempi

setMetadata()

Imposta i metadati del media in riproduzione.

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

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

setPlaybackState()

Aggiorna lo stato di riproduzione della media session.

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

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

setActionHandler()

Registra un handler per un'azione della media session.

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

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

setPositionState()

Aggiorna lo stato della posizione per la media session attiva.

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

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

Riferimento completo

Continua da Usare @capgo/capacitor-media-session

Se stai usando Utilizzo di @capgo/capacitor-media-session per pianificare le operazioni della dashboard e di API, collegalo a @capgo/capacitor-media-session per i dettagli di implementazione in @capgo/capacitor-media-session, Per iniziare per i dettagli di implementazione nella guida introduttiva, Panoramica API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli implementativi nell'Introduzione, e Chiavi API per i dettagli implementativi in API Keys.

FAQ

FAQ del plugin Media Session

Come installo il plugin Media Session in un'app Capacitor?

Esegui "bun add @capgo/capacitor-media-session" (o "npm install @capgo/capacitor-media-session"), poi lancia "bunx cap sync" in modo che i progetti iOS e Android integrino il code nativo. Importalo da "@capgo/capacitor-media-session" nel tuo code.

@capgo/capacitor-media-session funziona con React, Vue e Angular?

Sì. Media Session è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che giri all'interno di Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor è supportata da @capgo/capacitor-media-session?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-media-session è free e open source?

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-media-session/ e il pacchetto è gratuito su npm. Bug report e pull request sono i benvenuti.

Posso aggiornare code che usa Media Session senza passare per la revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Pubblica modifiche alla Media Session senza attendere la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo