> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Örnek uygulama: Live Activities

> Clean Beans örnek uygulamasının iOS Live Activities'i backend'inden nasıl başlattığı, güncellediği ve sonlandırdığı; widget kodu ve API istekleriyle birlikte.

Bu sayfa, gerçek bir uygulamayı baştan sona takip eden [Örnek uygulama: eksiksiz bir OneSignal entegrasyonu](https://documentation.onesignal.com/docs/tr/example-full-integration-overview.md) 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](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-LiveActivity-countdown.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=d3e51363076f6271d5f47cfec850e5e2)

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.

```typescript app/_layout.tsx theme={null}
// Enable Live Activities with the default attributes type
OneSignal.LiveActivities.setupDefault({
  enablePushToStart: true,
  enablePushToUpdate: true,
});
```

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.

```javascript plugins/withLiveActivityWidget.js theme={null}
const WIDGET_TARGET_NAME = "CleanBeansWidgetExtension";
const WIDGET_BUNDLE_ID_SUFFIX = ".CleanBeansWidgetExtension";
const DEPLOYMENT_TARGET = "16.2";
```

## 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.

```swift plugins/widget/CleanBeansWidgetLiveActivity.swift theme={null}
struct CleanBeansWidgetLiveActivity: Widget {
    var body: some WidgetConfiguration {
        ActivityConfiguration(for: DefaultLiveActivityAttributes.self) { context in
            // Dispatch based on activity type
            let activityType = context.attributes.data["type"]?.asString() ?? "streak-warning"

            if activityType == "cleaning-reminder" {
                CleaningReminderLockScreen(context: context)
            } else {
                StreakWarningLockScreen(context: context)
            }

        } dynamicIsland: { context in
            let activityType = context.attributes.data["type"]?.asString() ?? "streak-warning"

            if activityType == "cleaning-reminder" {
                return cleaningReminderDynamicIsland(context: context)
            } else {
                return streakWarningDynamicIsland(context: context)
            }
        }
    }
}
```

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.

```swift plugins/widget/CleanBeansWidgetLiveActivity.swift theme={null}
let title = context.attributes.data["title"]?.asString() ?? "Streak Warning"
let message = context.state.data["message"]?.asDict()?["en"]?.asString()
    ?? "Your streak is at risk!"
let streakCount = context.state.data["streakCount"]?.asInt() ?? 0
let midnightTs = context.state.data["midnightTs"]?.asInt() ?? 0
let midnightDate = Date(timeIntervalSince1970: Double(midnightTs))
```

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.

```typescript supabase/functions/streak-warning/index.ts theme={null}
const payload = {
  event: 'start',
  activity_id: activityId,
  include_aliases: {
    external_id: [user.id],
  },
  target_channel: 'push',
  event_attributes: {
    data: {
      title: 'Streak Warning',
    },
  },
  event_updates: {
    data: {
      message: {
        en: `Your ${user.streakCount}-day streak ends at midnight!`,
      },
      streakCount: user.streakCount,
      midnightTs: user.midnightTs,
      userName: user.name,
    },
  },
  name: 'Streak Warning',
  contents: {
    en: `Your ${user.streakCount}-day streak ends at midnight!`,
  },
  headings: {
    en: 'Streak at risk!',
  },
  priority: 10,
};

const res = await fetch(
  `https://api.onesignal.com/apps/${ONESIGNAL_APP_ID}/activities/activity/DefaultLiveActivityAttributes`,
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      Authorization: `Key ${ONESIGNAL_REST_API_KEY}`,
    },
    body: JSON.stringify(payload),
  }
);
```

![Gece yarısına geri sayım yapan bir seri uyarısı Live Activity'si](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-LA-warning.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=586ca54b6a57f7d1647d5e9bb5aa874f)

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.

| Aşama | Ne zaman | İstek | Widget'ın gösterdiği |
| - | - | - | - |
| Geri sayım | Zaman aralığından bir saat önce | `start` | Başlangıç saatine geri sayan bir zamanlayıcı |
| Etkin | Zaman aralığı başladığında | `update` | "It's your scheduled cleaning time, jump to it!" |
| Sona erdi | Zaman aralığı bittiğinde | `end` | Beş saniye sonra kapatılır |

Fonksiyon, her kullanıcının hangi aşamada olması gerektiğini hesaplar.

```typescript supabase/functions/cleaning-activity/index.ts theme={null}
function getDesiredPhase(
  currentHour: number,
  window: CleaningWindow,
): 'countdown' | 'active' | null {
  const reminderHour = (window.start - 1 + 24) % 24;

  // Active: inside the cleaning window
  if (isHourInRange(currentHour, window.start, window.end)) return 'active';

  // Countdown: the single hour before the window starts
  if (currentHour === reminderHour) return 'countdown';

  return null;
}
```

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.

```typescript supabase/functions/cleaning-activity/index.ts theme={null}
async function updateCleaningActivity(activityId: string): Promise<boolean> {
  const payload = {
    event: 'update',
    event_updates: {
      data: {
        message: { en: "It's your scheduled cleaning time, jump to it!" },
        phase: 'active',
        targetTs: 0,
      },
    },
    name: 'Cleaning Active',
    contents: { en: "It's your scheduled cleaning time!" },
    priority: 10,
  };

  // ...
}

async function endCleaningActivity(activityId: string): Promise<boolean> {
  const payload = {
    event: 'end',
    event_updates: {
      data: {
        message: { en: 'Cleaning window ended' },
        phase: 'ended',
      },
    },
    name: 'Cleaning Ended',
    dismissal_date: Math.floor(Date.now() / 1000) + 5, // dismiss after 5s
    priority: 10,
  };

  // ...
}
```

> [!NOTE]
>
> 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.

> [!WARNING]
>
> 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.

> [!NOTE]
>
> 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.

> [card] [Platformlar arası kurulum](https://documentation.onesignal.com/docs/tr/cross-platform-live-activity-setup.md)
>
> `setupDefault` ve widget uzantısı.

> [card] [Live Activity başlatma](https://documentation.onesignal.com/reference/start-live-activity.md)
>
> Push-to-start API'si.

> [card] [Live Activity güncelleme](https://documentation.onesignal.com/reference/update-live-activity-api.md)
>
> Güncelleme ve sonlandırma istekleri.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.