Commencer

1. Installez le 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. Synchroniser les projets natifs

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

iOS préparation

1. Ouvrez l’espace de travail Xcode sous ios/App/.
2. Ajoutez le package Swift https://github.com/muxinc/mux-player-swift à la cible de votre application afin que le module MuxPlayerSwift soit disponible.
3. Assurez-vous que la cible de déploiement est iOS 15+ et reconstruisez.

Android préparation

Le module Gradle est livré avec les référentiels et dépendances appropriés. Si vous utilisez un proxy d’entreprise personnalisé, autorisez les requêtes adressées à https://muxinc.jfrog.io/artifactory/default-maven-release-local.

Lancez le lecteur

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',
});

Écoutez les événements des joueurs

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

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

// Clean up after dismissing the player
const dismissPlayer = async () => {
  await MuxPlayer.dismiss();
  await readyHandle.remove();
  await errorHandle.remove();
};

Lecture basée sur des jetons

await MuxPlayer.play({
  playbackId: 'signed-playback-id',
  playbackToken: signedPlaybackToken,
  drmToken: signedDrmToken, // Optional if you enabled DRM policies
  autoPlay: true,
  startTime: 120, // begin at 2 minutes
});

Réagissez au cycle de vie du joueur

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

// Remove all listener registrations when unmounting
await MuxPlayer.removeAllListeners();

Conseils

• Générez des jetons de lecture et DRM signés sur votre backend à l’aide des clés de signature Mux.
• Transmettez un playerName pour séparer les analyses lors de l’exécution de plusieurs lecteurs dans votre application.
• Combinez avec enableSmartCache pour améliorer la résilience hors ligne sur les plateformes prises en charge.