Inizia

1. Installa il plugin

   npm

   npm i @capgo/capacitor-mux-player

   pnpm

   pnpm add @capgo/capacitor-mux-player

   yarn

   yarn add @capgo/capacitor-mux-player

   bun

   bun add @capgo/capacitor-mux-player

2. Sincronizza i progetti nativi

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

Preparazione iOS

1. Apri l’area di lavoro Xcode in ios/App/.
2. Aggiungi il pacchetto Swift https://github.com/muxinc/mux-player-swift al target della tua app in modo che il modulo MuxPlayerSwift sia disponibile.
3. Assicurati che il target di distribuzione sia iOS 15+ e ricompila.

Preparazione Android

Il modulo Gradle viene fornito con i repository e le dipendenze corretti. Se utilizzi un proxy aziendale personalizzato, consenti le richieste a https://muxinc.jfrog.io/artifactory/default-maven-release-local.

Avvia il player

import { MuxPlayer } from '@capgo/capacitor-mux-player';

await MuxPlayer.play({
  playbackId: 'your-playback-id',
  environmentKey: 'your-mux-data-key',
  title: 'Launch Announcement',
  subtitle: 'Filmed live at Capgo HQ',
  poster: 'https://stream.example.com/poster.jpg',
});

Ascolta gli eventi del player

const readyHandle = await MuxPlayer.addListener('ready', ({ playerName }) => {
  console.log('Mux player pronto', playerName);
});

const errorHandle = await MuxPlayer.addListener('error', ({ message }) => {
  console.error('Errore Mux player:', message);
});

// Pulisci dopo aver chiuso il player
const dismissPlayer = async () => {
  await MuxPlayer.dismiss();
  await readyHandle.remove();
  await errorHandle.remove();
};

Riproduzione basata su token

await MuxPlayer.play({
  playbackId: 'signed-playback-id',
  playbackToken: signedPlaybackToken,
  drmToken: signedDrmToken, // Facoltativo se hai abilitato le politiche DRM
  autoPlay: true,
  startTime: 120, // inizia a 2 minuti
});

Reagisci al ciclo di vita del player

const { active } = await MuxPlayer.isActive();
if (active) {
  console.log('Player attualmente visibile');
}

// Rimuovi tutte le registrazioni dei listener durante lo smontaggio
await MuxPlayer.removeAllListeners();

Suggerimenti

• Genera token di riproduzione firmati e DRM sul tuo backend utilizzando le chiavi di firma Mux.
• Passa un playerName per separare l’analisi quando esegui più player nella tua app.
• Combina con enableSmartCache per migliorare la resilienza offline sulle piattaforme supportate.