@capgo/capacitor-live-activities

Gestiona los layouts de Live Activities y Dynamic Island de iOS desde Capacitor con plantillas JSON

Resumen

@capgo/capacitor-live-activities gestiona ActivityKit las Live Activities de Capacitor mediante un DSL de diseño JSON (pantalla de bloqueo, Dynamic Island, temporizadores, imágenes en un App Group compartido). No implementa App Intents, frases de Siri, la app Atajos, la indexación de Spotlight o una cola de App Intent pendiente.

Para widgets de la Home Screen, plantillas SVG o LiveActivityIntent botones vinculados a un log de eventos de plantilla, utiliza @capgo/capacitor-widget-kit en su lugar o junto con este plugin. Para frases de Siri, Spotlight y una cola de App Intents pendientes en JavaScript, usa @capgo/capacitor-app-intents.

Ver Siri, Shortcuts y widgets for how Capgo plugins map to system integration features.

Empieza con areActivitiesSupported() y los demás métodos principales detallados abajo.

Soporte de plataformas

Plataforma	Soporte	Notas
iOS	Sí	Nativo
Android	Sí	Nativo
Web	No	Protege con Capacitor.getPlatform()

Demo

Funcionalidades principales

areActivitiesSupported - Comprueba si el dispositivo es compatible con Live Activities. Requiere iOS 16.1+ y soporte de hardware.
startActivity - Inicia una nueva Live Activity con el layout y los datos especificados.
updateActivity - Actualiza una Live Activity existente con nuevos datos.
endActivity - Finaliza una Live Activity.

Público API

Método	Descripción
`areActivitiesSupported`	Comprueba si el dispositivo es compatible con Live Activities. Requiere iOS 16.1+ y soporte de hardware.
`startActivity`	Inicia una nueva Live Activity con el layout y los datos especificados.
`updateActivity`	Actualiza una Live Activity existente con nuevos datos.
`endActivity`	Finalizar una Live Activity.
`getAllActivities`	Obtener todas las Live Activities activas.
`saveImage`	Guarda una imagen en el contenedor compartido del App Group para usarla en Live Activities. Las imágenes deben guardarse en el contenedor compartido para que la extensión del widget pueda acceder a ellas.
`removeImage`	Elimina una imagen guardada del contenedor compartido.
`listImages`	Lista todas las imágenes guardadas en el contenedor compartido.
`cleanupImages`	Elimina todas las imágenes guardadas del contenedor compartido.
`getPluginVersion`	Obtén la versión del plugin nativo Capacitor.
`startTimerSequence`	Inicia una secuencia de temporizador para entrenamientos o deportes. En iOS: se muestra en la Live Activity y en la Dynamic Island. En Android: se muestra como una notificación en primer plano con el temporizador.
`pauseTimerSequence`	Pausar la secuencia del temporizador.
`resumeTimerSequence`	Reanudar una secuencia de temporizador pausada.
`stopTimerSequence`	Detener y descartar la secuencia del temporizador.
`skipTimerStep`	Saltar al siguiente paso de la secuencia.
`previousTimerStep`	Vuelve al paso anterior de la secuencia.
`getTimerState`	Obtén el estado actual de una secuencia de temporizador.
`addListener`	Añade un listener para eventos de la secuencia. Incluye: stepChange, complete, tick, paused, resumed, stopped, loopComplete.

Fuente de verdad

Esta referencia se sincroniza desde src/definitions.ts en capacitor-live-activities.

Continúa desde @capgo/capacitor-live-activities

Si estás usando @capgo/capacitor-live-activities para planificar el comportamiento de los medios nativos y la interfaz, conéctalo con Uso de @capgo/capacitor-live-activities para la capacidad nativa en Uso de @capgo/capacitor-live-activities, Uso de @capgo/capacitor-video-player para la capacidad nativa en Uso de @capgo/capacitor-video-player, @capgo/capacitor-video-player para el detalle de implementación en @capgo/capacitor-video-player, Uso de @capgo/capacitor-native-navigation para la capacidad nativa en Using @capgo/capacitor-native-navigation, y @capgo/capacitor-native-navigation para el detalle de implementación en @capgo/capacitor-native-navigation.