@capgo/capacitor-live-activities

Panoramica

@capgo/capacitor-live-activities gestisce ActivityKit le Live Activities di Capacitor tramite un DSL di layout JSON (lock screen, Dynamic Island, timer, immagini in un App Group condiviso). Non implementa le funzionalità Apple Intent dell'app, le frasi di Siri, l'app Shortcuts, l'indicizzazione Spotlight o una coda di App Intent in sospeso.

Per i widget della Home Screen, i template SVG o LiveActivityIntent pulsanti collegati a un log di eventi del template, usa @capgo/capacitor-widget-kit in alternativa o insieme a questo plugin. Per frasi di Siri, Spotlight e una coda di App Intent in JavaScript, usa @capgo/capacitor-app-intents.

Vedi Siri, Shortcuts e widget su come i plugin Capgo si mappano alle funzionalità di integrazione di sistema.

Inizia con areActivitiesSupported() e gli altri metodi principali elencati qui sotto.

Supporto piattaforme

Piattaforma	Supporto	Note
iOS	Sì	Nativo
Android	Sì	Nativo
Web	No	Proteggi con Capacitor.getPlatform()

Demo

Aggiornamenti Live Activity e Dynamic Island

Funzionalità principali

• areActivitiesSupported - Verifica se le Live Activities sono supportate su questo dispositivo. Richiede iOS 16.1+ e supporto del dispositivo.
• startActivity - Avvia una nuova Live Activity con il layout e i dati specificati.
• updateActivity - Aggiorna una Live Activity esistente con nuovi dati.
• endActivity - Termina una Live Activity.

Pubblico API

Metodo	Descrizione
areActivitiesSupported	Verifica se le Live Activities sono supportate su questo dispositivo. Richiede iOS 16.1+ e supporto del dispositivo.
startActivity	Avvia una nuova Live Activity con il layout e i dati specificati.
updateActivity	Aggiorna una Live Activity esistente con nuovi dati.
endActivity	Termina una Live Activity.
getAllActivities	Recupera tutte le Live Activities attualmente attive.
saveImage	Salva un'immagine nel container condiviso dell'App Group per usarla nelle Live Activities. Le immagini devono essere salvate nel container condiviso per essere accessibili dall'estensione del widget.
removeImage	Rimuovi un'immagine salvata dal container condiviso.
listImages	Elenca tutte le immagini salvate nel container condiviso.
cleanupImages	Rimuovi tutte le immagini salvate dal container condiviso.
getPluginVersion	Ottieni la versione nativa del plugin Capacitor.
startTimerSequence	Avvia una sequenza di timer per allenamenti o sport. Su iOS: appare nella Live Activity e nella Dynamic Island. Su Android: appare come notifica in primo piano con il timer.
pauseTimerSequence	Metti in pausa la sequenza del timer.
resumeTimerSequence	Riprendi una sequenza del timer in pausa.
stopTimerSequence	Ferma e chiudi la sequenza del timer.
skipTimerStep	Salta al passaggio successivo della sequenza.
previousTimerStep	Torna allo step precedente della sequenza.
getTimerState	Ottieni lo stato attuale di una sequenza timer.
addListener	Aggiungi un listener per gli eventi della sequenza timer. Gli eventi includono: stepChange, complete, tick, paused, resumed, stopped, loopComplete.

Fonte di verità

Questo riferimento è sincronizzato da src/definitions.ts nella capacitor-live-activities.

Continua da @capgo/capacitor-live-activities

Se stai usando @capgo/capacitor-live-activities per pianificare il comportamento dei media nativi e dell'interfaccia, collegalo a Uso di @capgo/capacitor-live-activities per la funzionalità nativa nella pagina Uso di @capgo/capacitor-live-activities, Uso di @capgo/capacitor-video-player per la funzionalità nativa in Utilizzo di @capgo/capacitor-video-player, @capgo/capacitor-video-player per i dettagli di implementazione in @capgo/capacitor-video-player, Usando @capgo/capacitor-native-navigation per la funzionalità nativa in Using @capgo/capacitor-native-navigation, e @capgo/capacitor-native-navigation per i dettagli di implementazione in @capgo/capacitor-native-navigation.