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 implementativi 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" (oppure "npm install @capgo/capacitor-media-session"), poi esegui "bunx cap sync" affinché i progetti iOS e Android recuperino il codice nativo code. Importalo da "@capgo/capacitor-media-session" nel tuo code dell'app.

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

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

Quale versione di Capacitor supporta @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 è gratuito e open source?

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

Posso aggiornare code che usa Media Session senza una 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