Aller au contenu principal

Session média Plugin Capacitor

Contrôlez la lecture multimédia depuis l'écran de verrouillage et le centre de notifications

Installer

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

Guide

Comment utiliser Media Session dans Capacitor

Tester sur l'appareil

Téléchargez l'application Capgo, puis scannez le QR code.

Aperçu du plugin Media Session via QR code

Utiliser @capgo/capacitor-media-session

Plugin Capacitor pour exposer les contrôles Media Session de l’appareil.

Installer

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

bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.

Importer

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

Aperçu de API

Méthode Description
setMetadata Définit les métadonnées du média en cours de lecture.
setPlaybackState Met à jour l’état de lecture de la session média.
setActionHandler Enregistre un gestionnaire pour une action de session média.
setPositionState Met à jour l’état de position de la session média active.

Exemples

setMetadata()

Définit les métadonnées du média en cours de lecture.

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

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

setPlaybackState()

Met à jour l’état de lecture de la session média.

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

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

setActionHandler()

Enregistre un gestionnaire pour une action de session média.

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

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

setPositionState()

Met à jour l’état de position de la session média active.

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

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

Référence complète

Continuer après « Utiliser @capgo/capacitor-media-session »

Si vous utilisez Utiliser @capgo/capacitor-media-session pour planifier les opérations du dashboard et de API, connectez-l’avec @capgo/capacitor-media-session pour les détails d’implémentation dans @capgo/capacitor-media-session, Prise en main pour les détails d'implémentation dans Getting Started Aperçu de API pour les détails d'implémentation dans « Vue d'ensemble de API », Introduction pour les détails d'implémentation dans l'Introduction, et Clés API pour les détails d'implémentation dans les clés API.

FAQ

FAQ du plugin Media Session

Comment installer le plugin Media Session dans une app Capacitor ?

Exécutez « bun add @capgo/capacitor-media-session » (ou « npm install @capgo/capacitor-media-session »), puis « bunx cap sync » pour que les projets iOS et Android récupèrent le code natif code. Importez-le depuis « @capgo/capacitor-media-session » dans le code de votre app code.

Le plugin @capgo/capacitor-media-session fonctionne-t-il avec React, Vue et Angular ?

Oui. Media Session est un package Capacitor, il fonctionne donc avec n’importe quel framework web exécuté dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et le JavaScript pur.

Quelle version de Capacitor @capgo/capacitor-media-session prend-il en charge ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

Le plugin @capgo/capacitor-media-session est-il gratuit et open source ?

Oui. Le code source code est public sur GitHub à l’adresse https://github.com/Cap-go/capacitor-media-session/ et le package est gratuit à installer depuis npm. Les signalements de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code qui utilise Media Session sans passer par une revue de l’App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez les modifications Media Session sans attendre la revue de l’application

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo