Saltar al contenido principal
@capgo/capacitor-media-session Multimedia Código abierto

Sesión de medios plugin Capacitor

Controla la reproducción de medios desde la pantalla de bloqueo y el centro de notificaciones

Instalar

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

Guía

Cómo usar Media Session en Capacitor

Probar en el dispositivo

Descarga la app Capgo y escanea el QR code.

Vista previa del plugin Media Session QR code

Uso de @capgo/capacitor-media-session

Plugin Capacitor para exponer los controles de sesión multimedia del dispositivo.

Instalar

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

bunx cap sync copia el code nativo del plugin en tus proyectos nativos. Ejecútalo de nuevo tras cada actualización del plugin.

Importar

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

API de un vistazo

Método Descripción
setMetadata Establece los metadatos del medio que se está reproduciendo.
setPlaybackState Actualiza el estado de reproducción de la sesión multimedia.
setActionHandler Registra un handler para una acción de la sesión multimedia.
setPositionState Actualiza el estado de posición de la sesión multimedia activa.

Ejemplos

setMetadata()

Establece los metadatos del medio que se está reproduciendo.

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

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

setPlaybackState()

Actualiza el estado de reproducción de la sesión multimedia.

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

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

setActionHandler()

Registra un handler para una acción de la sesión multimedia.

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

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

setPositionState()

Actualiza el estado de posición de la sesión multimedia activa.

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

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

Referencia completa

Continúa desde Using @capgo/capacitor-media-session

Si estás usando Uso de @capgo/capacitor-media-session para planificar las operaciones del dashboard y de API, conéctalo con @capgo/capacitor-media-session para los detalles de implementación en @capgo/capacitor-media-session, Primeros pasos para los detalles de implementación en Primeros pasos, Resumen de API para los detalles de implementación en API Overview, Introducción para los detalles de implementación en Introducción, y Claves de API para los detalles de implementación en API Keys.

FAQ

FAQ del plugin Media Session

¿Cómo instalo el plugin Media Session en una app Capacitor?

Ejecuta "bun add @capgo/capacitor-media-session" (o "npm install @capgo/capacitor-media-session") y luego "bunx cap sync" para que los proyectos de iOS y Android reconozcan el code nativo. Impórtalo desde "@capgo/capacitor-media-session" en el code de tu app.

¿Es compatible @capgo/capacitor-media-session con React, Vue y Angular?

Sí. Media Session es un paquete de Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor es compatible con @capgo/capacitor-media-session?

Los plugins de Capgo siguen la versión mayor de Capacitor: usa la versión mayor del plugin que coincida con la versión mayor de tu Capacitor (por ejemplo, el plugin v8 con Capacitor 8). La tabla de compatibilidad del README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-media-session gratuito y de código abierto?

Sí. El código fuente de code es público en GitHub en https://github.com/Cap-go/capacitor-media-session/ y el paquete se puede instalar gratis desde npm. Los reportes de bugs y pull requests son bienvenidos.

¿Puedo actualizar code que usa Media Session sin pasar por la revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

Lanza cambios en Media Session sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo