@capgo/capacitor-live-activities
Ikhtisar
Bagian berjudul “Ringkasan”@capgo/capacitor-live-activities mengelola ActivityKit Live Activities dari Capacitor menggunakan JSON layout DSL (lock screen, Dynamic Island, timer, gambar dalam App Group bersama). Tidak mengimplementasikan Apple App Intents, frasa Siri, aplikasi Shortcuts, indeks Spotlight, atau antrean App Intent yang tertunda.
Untuk permukaan widget Home Screen, template SVG, atau LiveActivityIntent tombol yang terikat pada log event template, gunakan @capgo/capacitor-widget-kit sebagai pengganti atau pelengkap plugin ini. Untuk frasa Siri, Spotlight, dan antrean App Intent yang tertunda di JavaScript, gunakan @capgo/capacitor-app-intents.
Lihat Siri, Shortcuts, dan widget untuk cara plugin Capgo dipetakan ke fitur integrasi sistem.
Mulai dengan areActivitiesSupported() dan metode inti lainnya yang tercantum di bawah ini.
Dukungan platform
Bagian berjudul “Dukungan platform”| Platform | Dukungan | Catatan |
|---|---|---|
| iOS | Ya | Native |
| Android | Ya | Native |
| Web | Tidak | Lindungi dengan Capacitor.getPlatform() |

Kemampuan Utama
Bagian berjudul “Kemampuan Utama”areActivitiesSupported- Cek apakah Live Activities didukung di perangkat ini. Memerlukan 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
Bagian berjudul “Public API”| Metode | Deskripsi |
|---|---|
areActivitiesSupported | Cek apakah Live Activities didukung di perangkat ini. Memerlukan 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 timer sequence. Event-nya meliputi: stepChange, complete, tick, paused, resumed, stopped, loopComplete. |
Sumber Kebenaran
Bagian berjudul “Sumber Kebenaran”Referensi ini disinkronkan dari src/definitions.ts di capacitor-live-activities.
Lanjutkan dari @capgo/capacitor-live-activities
Bagian berjudul “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 kemampuan native di Menggunakan @capgo/capacitor-native-navigation, dan @capgo/capacitor-native-navigation untuk detail implementasi di @capgo/capacitor-native-navigation.