Saltar al contenido principal

Sesión de medios plugin de 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 dispositivo

Descargue la aplicación Capgo, luego escane el código QR code.

Vista previa del plugin de sesión de medios QR code

Usando @capgo/capacitor-media-session

El plugin Capacitor para exponer controles de sesión de medios 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. Correlo de nuevo después de cada actualización del plugin.

Importar

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

Vista general de API

Metodo Descripción
setMetadata Establece metadatos del medio de reproducción actual.
setPlaybackState Actualiza el estado de reproducción de la sesión de medios.
setActionHandler Registra un manejador para una acción de sesión de medios.
setPositionState Actualiza el estado de posición para la sesión de medios activa.

Ejemplos

setMetadata()

Establece metadatos del medio de reproducción actual.

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

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

setPlaybackState()

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

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

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

setActionHandler()

Registra un manejador para una acción de sesión de medios.

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

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

setPositionState()

Actualiza el estado de posición para la sesión de medios activa.

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

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

Documentación completa

Sigue adelante desde el uso de @capgo/capacitor-media-session

Si estás utilizando Usando @capgo/capacitor-media-session Para planificar la consola de instrumentos y las operaciones de API, conecta @capgo/capacitor-sesión de medios para los detalles de implementación en @capgo/capacitor-media-session Getting Started para los detalles de implementación en Inicio Resumen de API para los detalles de implementación en Resumen de API Introducción para los detalles de implementación en Introducción, y API Claves para los detalles de implementación en API Claves.

FAQ

Preguntas Frecuentes del plugin de Sesión de Medios

¿Cómo instalo el plugin de Sesión de Medios en una aplicación Capacitor?

Ejecuta "bun add @capgo/capacitor-media-session" (o "npm install @capgo/capacitor-media-session"), luego ejecuta "bunx cap sync" para que los proyectos de iOS y Android capturen la code nativa. Importa desde "@capgo/capacitor-media-session" en tu aplicación code.

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

Sí. La Sesión de Medios es un paquete 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 soporta @capgo/capacitor-media-session?

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

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

Sí. El código code es público en GitHub en https://github.com/Cap-go/capacitor-media-session/ y el paquete es gratuito para instalar desde npm. Se aceptan informes de errores y solicitudes de cambios.

¿Puedo actualizar code que utiliza Sesión de Medios sin una revisión de la Tienda de Aplicaciones?

Instalando o actualizando el plugin cambia la nativa code, por lo que necesita una nueva compilación de la tienda. Después de eso, los cambios de JavaScript, HTML y CSS que llaman al plugin pueden enviar actualizaciones Capgo en vivo de inmediato.

Envíe cambios de Media Session sin esperar la revisión de la aplicación

Una vez que el plugin esté en tu tienda de construcción, Capgo actualizaciones en vivo envían cambios en JavaScript, HTML y CSS a los usuarios en minutos.

Comienza con Capgo