Aller directement au contenu principal

Session de médias 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 la session multimédia dans Capacitor

Tester sur appareil

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

Prévisualisation du plugin Media Session QR code

Utilisation de @capgo/capacitor-media-session

Le plugin Capacitor permet d'exposer les contrôles de session multimédia 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. Exécutez-l’à nouveau après chaque mise à jour du plugin.

Importer

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

API en un coup d'œil

Méthode Description
setMetadata Configure les métadonnées de la média en cours de lecture.
setPlaybackState Mise à jour de l'état de lecture de la session multimédia.
setActionHandler Enregistre un gestionnaire pour une action de session de média.
setPositionState Mise à jour de l'état de position pour la session multimédia active.

Examples

setMetadata()

Configure les métadonnées de la média en cours de lecture.

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

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

setPlaybackState()

Mise à jour de l'état de lecture de la session multimédia.

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

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

setActionHandler()

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

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

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

setPositionState()

Met à jour l'état de position pour la session multimédia active.

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

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

Référence complète

Continuez à partir de l'utilisation de @capgo/capacitor-media-session

Si vous utilisez L'utilisation de @capgo/capacitor-media-session Pour planifier le tableau de bord et les opérations de API, connectez-l’avec @capgo/capacitor-session-média Pour les détails d'implémentation dans @capgo/capacitor-media-session, Getting Started pour les détails d'implémentation dans Démarrage API Présentation pour les détails d'implémentation dans API Présentation Introduction pour les détails d'implémentation dans Introduction, et API Clés pour les détails d'implémentation dans API Clés

FAQ

FAQ du plugin Media Session

Comment installer le plugin Media Session dans une application Capacitor?

Exécutez « bun add @capgo/capacitor-media-session » (ou « npm install @capgo/capacitor-media-session »), puis exécutez « bunx cap sync » afin que les projets iOS et Android prennent en compte le code natif. Importez-l’à partir de « @capgo/capacitor-media-session » dans votre application code.

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

Oui. Media Session est un paquet Capacitor, il fonctionne donc avec tout framework web qui s'exécute à l'intérieur de Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript pur.

Quelle version de Capacitor est prise en charge par @capgo/capacitor-media-session?

Les Capgo plugins 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). La table de compatibilité dans le README du GitHub liste les versions maintenues.

Est-ce que @capgo/capacitor-media-session est gratuit et open source ?

Oui. Le code source de code est public sur GitHub à https://github.com/Cap-go/capacitor-media-session/ et le package est gratuit pour l'installer depuis npm. Les rapports de bogues et les demandes de mise à jour sont les bienvenus.

Peut-on 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 de code, il faut donc une nouvelle build de l'application. Après cela, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être envoyées instantanément avec les mises à jour Capgo.

Ship Media Session changes without waiting for app review

Une fois le plugin est dans votre magasin de build, les mises à jour en direct Capgo poussent vos modifications de JavaScript, HTML et CSS vers les utilisateurs en quelques minutes.

Démarrer avec Capgo