Ana içeriğe atla
Bu sayfa, gerçek bir uygulamayı baştan sona takip eden Örnek uygulama: eksiksiz bir OneSignal entegrasyonu kılavuzunun bir parçasıdır. Uygulama, ortak yaşanan evler için bir temizlik nöbet çizelgesi olan Clean Beans’tir ve Expo (React Native) ile bir Supabase backend’i kullanılarak geliştirilmiştir. Live Activity, iOS Kilit Ekranı’nda ve Dynamic Island’da canlı olarak güncellenen küçük bir görünümdür. Clean Beans iki tane kullanır: kullanıcının temizlik zaman aralığına geri sayım ve bir seri sona ermek üzereyken bir uyarı.
iOS Kilit Ekranı'nda bir temizlik hatırlatıcısı Live Activity'si

Kilit Ekranı'nda geri sayım yapan temizlik hatırlatıcısı.

Live Activities normalde uygulama tarafından başlatılır. Clean Beans bunları backend’den başlatır, çünkü uygulama açık olsun ya da olmasın belirli bir zamanda görünmeleri gerekir. Bunu OneSignal’ın push-to-start özelliği mümkün kılar.

Uygulamayı kurun \

Platformlar arası bir uygulama, Live Activity’nin yaşam döngüsünü OneSignal’ın yönetmesine bırakabilir. Gereken tüm JavaScript, başlangıçta yapılan tek bir çağrıdır.
app/_layout.tsx
Yazdığınız tek yerel kod, SwiftUI ile widget’ın düzenidir. Clean Beans widget uzantısını iOS projesine küçük bir Expo yapılandırma eklentisiyle ekler. Böylece proje her derlemede sıfırdan oluşturulabilir.
plugins/withLiveActivityWidget.js

Widget’ı çizin \

Widget, serbest biçimli veri taşıyan OneSignal’ın DefaultLiveActivityAttributes türünü kullanır. Tek bir widget, bir type değerini okuyup bir düzen seçerek her iki etkinliğe de hizmet eder.
plugins/widget/CleanBeansWidgetLiveActivity.swift
Her düzen değerlerini backend’in gönderdiği verilerden okur. attributes, etkinlik başladığında sabitlenir. state her güncellemede değişebilir.
plugins/widget/CleanBeansWidgetLiveActivity.swift
Geri sayım, SwiftUI’ın zamanlayıcı stiliyle çizilir. Bu stil, sunucudan başka güncelleme gelmeden cihazda ilerler.

Seri uyarısı: backend’den bir etkinlik başlatın \

Yerel saatle 19:00’da, serisi olan ve bugün henüz temizlik yapmamış herkes gece yarısına kadar bir geri sayım alır. Saatlik fonksiyon bu kişileri push hatırlatıcılarıyla aynı saat dilimi eşleştirmesiyle bulur, ardından her biri için bir etkinlik başlatır.
supabase/functions/streak-warning/index.ts
Gece yarısına geri sayım yapan bir seri uyarısı Live Activity'si

Gece yarısına geri sayım yapan seri uyarısı.

Temizlik hatırlatıcısı: başlat, güncelle, sonlandır \

Temizlik hatırlatıcısı üç aşamadan geçer. Her biri aynı etkinlik için ayrı bir istektir. Fonksiyon, her kullanıcının hangi aşamada olması gerektiğini hesaplar.
supabase/functions/cleaning-activity/index.ts
Geçerli aşamayı kullanıcının profilinde saklar ve yalnızca istenen aşama farklı olduğunda istek gönderir. Bu, saatlik işin tekrar tekrar çalıştırılmasını güvenli hale getirir. Güncelleme ve sonlandırma, başlatmadan farklı bir uç nokta kullanır. Etkinlik URL’de belirtildiği için bu istekler hedefleme içermez.
supabase/functions/cleaning-activity/index.ts
Bu istekler priority: 10 kullanır, çünkü her biri hemen görünmesi gereken bir aşama değişikliğidir ve bir kişi günde en fazla birkaç tane alır. 10 önceliği, Apple’ın her cihaza Live Activity güncellemeleri için tanıdığı bütçeden düşülür. Skor veya ilerleme çubuğu gibi sık güncellenen her şey için 5 ile başlayın.
Güncellemeleri ve sonlandırmaları başlatma uç noktasına değil, /apps/{app_id}/live_activities/{activity_id}/notifications adresine gönderin. Clean Beans başlangıçta üçünü de başlatma uç noktasına gönderiyordu ve her güncelleme ile sonlandırma “Missing required parameter - event_attributes” hatasıyla reddedildi.
Her etkinliğe kendi activity_id değerini verin ve etkinlik başladığında saklayın. OneSignal, bir etkinlik sona erdikten sonra o activity_id için başka güncelleme kabul etmez. Bu yüzden kullanıcı başına sabit bir kimlik ilk günden sonra çalışmayı bırakır.

Platformlar arası kurulum

setupDefault ve widget uzantısı.

Live Activity başlatma

Push-to-start API’si.

Live Activity güncelleme

Güncelleme ve sonlandırma istekleri.