Yerel Bildirimler

Giriş

Nylo Website, LocalNotification sınıfı aracılığıyla yerel bir bildirim sistemi sunar. Bu, iOS ve Android üzerinde zengin içerikli anlık veya zamanlanmış bildirimler göndermenize olanak tanır.

Yerel bildirimler web'de desteklenmez. Web'de kullanmaya çalışmak bir NotificationException fırlatır.

Temel Kullanım

Builder deseni veya statik metodu kullanarak bir bildirim gönderin:

import 'package:nylo_framework/nylo_framework.dart';

// Builder pattern
await LocalNotification(title: "Hello", body: "World").send();

// Using the helper function
await localNotification("Hello", "World").send();

// Using the static method
await LocalNotification.sendNotification(
  title: "Hello",
  body: "World",
);

Zamanlanmış Bildirimler

Belirli bir zamanda teslim edilecek bir bildirim zamanlayın:

// Schedule for tomorrow
final tomorrow = DateTime.now().add(Duration(days: 1));

await LocalNotification(
  title: "Reminder",
  body: "Don't forget your appointment!",
).send(at: tomorrow);

// Using the static method
await LocalNotification.sendNotification(
  title: "Reminder",
  body: "Don't forget your appointment!",
  at: tomorrow,
);

Builder Deseni

LocalNotification sınıfı akıcı bir builder API sunar. Tüm zincirleme metotlar LocalNotification örneğini döndürür:

await LocalNotification(title: "New Photo", body: "Check this out!")
    .addPayload("photo_id:123")
    .addId(42)
    .addSubtitle("From your friend")
    .addBadgeNumber(3)
    .addSound("custom_sound.wav")
    .send();

Zincirleme Metotlar

send()

Future<void> send({
  DateTime? at,
  AndroidScheduleMode? androidScheduleMode,
})

at sağlanırsa, bildirimi o zaman için zamanlar. Aksi takdirde hemen gösterir.

Platform Yapılandırması

Platforma özgü seçenekler AndroidNotificationConfig ve IOSNotificationConfig nesneleri aracılığıyla yapılandırılır.

Android Yapılandırması

setAndroidConfig() metoduna bir AndroidNotificationConfig geçirin:

await LocalNotification(
  title: "Android Notification",
  body: "With custom configuration",
)
.setAndroidConfig(AndroidNotificationConfig(
  channelId: "custom_channel",
  channelName: "Custom Channel",
  channelDescription: "Notifications from custom channel",
  importance: Importance.max,
  priority: Priority.high,
  enableVibration: true,
  vibrationPattern: [0, 1000, 500, 1000],
  enableLights: true,
  ledColor: Color(0xFF00FF00),
))
.send();

AndroidNotificationConfig Özellikleri

iOS Yapılandırması

setIOSConfig() metoduna bir IOSNotificationConfig geçirin:

await LocalNotification(
  title: "iOS Notification",
  body: "With custom configuration",
)
.setIOSConfig(IOSNotificationConfig(
  presentAlert: true,
  presentBanner: true,
  presentSound: true,
  threadIdentifier: "thread_1",
  interruptionLevel: InterruptionLevel.active,
))
.addBadgeNumber(1)
.addSound("custom_sound.wav")
.send();

IOSNotificationConfig Özellikleri

Ekler (Yalnızca iOS)

iOS bildirimlerine resim, ses veya video ekleri ekleyin. Ekler bir URL'den indirilir:

await LocalNotification(
  title: "New Photo",
  body: "Check out this image!",
)
.addAttachment(
  "https://example.com/image.jpg",
  "photo.jpg",
  showThumbnail: true,
)
.send();

Bildirimleri Yönetme

Belirli Bir Bildirimi İptal Etme

await LocalNotification.cancelNotification(42);

// With a tag (Android)
await LocalNotification.cancelNotification(42, tag: "my_tag");

Tüm Bildirimleri İptal Etme

await LocalNotification.cancelAllNotifications();

Rozet Sayısını Temizleme

await LocalNotification.clearBadgeCount();

İzinler

Kullanıcıdan bildirim izinleri isteyin:

// Request with defaults
await LocalNotification.requestPermissions();

// Request with specific options
await LocalNotification.requestPermissions(
  alert: true,
  badge: true,
  sound: true,
  provisional: false,
  critical: false,
  vibrate: true,
  enableLights: true,
  channelId: 'default_notification_channel_id',
  channelName: 'Default Notification Channel',
);

İzinler, ilk bildirim gönderiminde NyScheduler.taskOnce aracılığıyla otomatik olarak istenir.

Platform Kurulumu

iOS Kurulumu

Info.plist dosyanıza ekleyin:

<key>UIBackgroundModes</key>
<array>
    <string>remote-notification</string>
</array>

Android Kurulumu

AndroidManifest.xml dosyanıza ekleyin:

<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.USE_FULL_SCREEN_INTENT" />

API Referansı

Statik Metotlar

Örnek Metotlar (Zincirleme)