@capgo/capacitor-live-activities

Ikhtisar

@capgo/capacitor-live-activities mengelola ActivityKit Live Activities dari Capacitor menggunakan JSON layout DSL (lock screen, Dynamic Island, timer, gambar dalam shared App Group). Plugin ini tidak mengimplementasikan Apple App Intents, frasa Siri, aplikasi Shortcuts, pengindeksan Spotlight, atau antrean App Intent yang tertunda.

Untuk tampilan widget Home Screen, template SVG, atau LiveActivityIntent tombol yang terhubung ke log event template, gunakan @capgo/capacitor-widget-kit sebagai pengganti atau pendamping plugin ini. Untuk frasa Siri, Spotlight, dan antrean App Intent dalam JavaScript, gunakan @capgo/capacitor-app-intents.

Lihat Siri, Shortcuts, dan widget tentang bagaimana plugin Capgo memetakan fitur integrasi sistem.

Mulai dengan areActivitiesSupported() dan metode inti lainnya yang tercantum di bawah ini.

Dukungan platform

Platform	Dukungan	Catatan
iOS	Ya	Native
Android	Ya	Native
Web	Tidak	Lindungi dengan Capacitor.getPlatform()

Demo

Update Live Activity dan Dynamic Island

Kemampuan Utama

• areActivitiesSupported - Cek apakah Live Activities didukung di perangkat ini. Membutuhkan iOS 16.1+ dan dukungan perangkat.
• startActivity - Mulai Live Activity baru dengan layout dan data yang ditentukan.
• updateActivity - Update Live Activity yang sudah ada dengan data baru.
• endActivity - Akhiri Live Activity.

API Publik

Metode	Deskripsi
areActivitiesSupported	Cek apakah Live Activities didukung di perangkat ini. Membutuhkan iOS 16.1+ dan dukungan perangkat.
startActivity	Mulai Live Activity baru dengan layout dan data yang ditentukan.
updateActivity	Update Live Activity yang sudah ada dengan data baru.
endActivity	Akhiri Live Activity.
getAllActivities	Dapatkan semua Live Activities yang sedang aktif.
saveImage	Simpan gambar ke container App Group bersama untuk digunakan di Live Activities. Gambar harus disimpan di container bersama agar bisa diakses dari widget extension.
removeImage	Hapus gambar yang tersimpan dari container bersama.
listImages	Tampilkan daftar semua gambar yang tersimpan di container bersama.
cleanupImages	Hapus semua gambar yang tersimpan dari container bersama.
getPluginVersion	Dapatkan versi plugin native Capacitor.
startTimerSequence	Mulai urutan timer untuk workout/olahraga. Di iOS: Muncul di Live Activity dan Dynamic Island. Di Android: Muncul sebagai notifikasi foreground dengan timer.
pauseTimerSequence	Jeda urutan timer.
resumeTimerSequence	Lanjutkan urutan timer yang dijeda.
stopTimerSequence	Hentikan dan tutup urutan timer.
skipTimerStep	Lewati ke langkah berikutnya dalam urutan.
previousTimerStep	Kembali ke langkah sebelumnya dalam urutan.
getTimerState	Dapatkan status terkini dari urutan timer.
addListener	Tambahkan listener untuk event urutan timer. Event meliputi: stepChange, complete, tick, paused, resumed, stopped, loopComplete.

Sumber Kebenaran

Referensi ini disinkronkan dari src/definitions.ts di capacitor-live-activities.

Lanjutkan dari @capgo/capacitor-live-activities

Jika Anda menggunakan @capgo/capacitor-live-activities untuk merencanakan perilaku media dan antarmuka native, hubungkan dengan Menggunakan @capgo/capacitor-live-activities untuk kemampuan native di Menggunakan @capgo/capacitor-live-activities, Menggunakan @capgo/capacitor-video-player untuk kapabilitas native saat menggunakan @capgo/capacitor-video-player, @capgo/capacitor-video-player untuk detail implementasi di @capgo/capacitor-video-player, Menggunakan @capgo/capacitor-native-navigation untuk kapabilitas native di Menggunakan @capgo/capacitor-native-navigation, dan @capgo/capacitor-native-navigation untuk detail implementasi di @capgo/capacitor-native-navigation.