Inizia

1. Installa il plugin

   npm

   npm i @capgo/capacitor-media-session

   pnpm

   pnpm add @capgo/capacitor-media-session

   yarn

   yarn add @capgo/capacitor-media-session

   bun

   bun add @capgo/capacitor-media-session

2. Sincronizza le piattaforme

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

ℹ️ L’API Media Session è disponibile su Android (browser basati su Chrome, WebView) e molti browser desktop. Su piattaforme non supportate le chiamate si risolvono senza effetto, quindi proteggi di conseguenza la tua interfaccia.

Pubblica metadati

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

await MediaSession.setMetadata({
  title: 'Weekly Tech Podcast',
  artist: 'Capgo Studio',
  album: 'Season 2',
  artwork: [
    { src: 'https://cdn.example.com/covers/s02e05-512.png', sizes: '512x512', type: 'image/.png' },
  ],
});

Aggiorna lo stato di riproduzione

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

// Metti in pausa in seguito se necessario
await MediaSession.setPlaybackState({ playbackState: 'paused' });

Gestisci azioni multimediali

const pauseHandler = async () => {
  player.pause();
  await MediaSession.setPlaybackState({ playbackState: 'paused' });
};

await MediaSession.setActionHandler({ action: 'pause' }, pauseHandler);
await MediaSession.setActionHandler({ action: 'play' }, async () => {
  await player.play();
  await MediaSession.setPlaybackState({ playbackState: 'playing' });
});

// Rimuovi un gestore quando elimini il player
await MediaSession.setActionHandler({ action: 'pause' }, null);

Mantieni la posizione sincronizzata

const updatePosition = async () => {
  await MediaSession.setPositionState({
    duration: player.duration,
    position: player.currentTime,
    playbackRate: player.playbackRate,
  });
};

player.ontimeupdate = updatePosition;
player.onratechange = updatePosition;

Raccomandazioni

• Aggiorna i metadati quando cambia la traccia in modo che le notifiche e gli altoparlanti intelligenti rimangano aggiornati.
• Limita gli aggiornamenti di posizione (es. ogni 250 ms) per evitare di sovraccaricare il livello nativo.
• Rimuovi sempre i gestori di azione quando elimini un’istanza del player per prevenire perdite accidentali.