Local Notifications

परिचय

Nylo Website LocalNotification क्लास के माध्यम से एक लोकल नोटिफ़िकेशन सिस्टम प्रदान करता है। यह आपको iOS और Android पर रिच कंटेंट के साथ तत्काल या शेड्यूल्ड नोटिफ़िकेशन भेजने की अनुमति देता है।

लोकल नोटिफ़िकेशन्स वेब पर सपोर्टेड नहीं हैं। वेब पर इन्हें उपयोग करने का प्रयास करने पर NotificationException थ्रो होगा।

बेसिक उपयोग

बिल्डर पैटर्न या स्टैटिक मेथड का उपयोग करके नोटिफ़िकेशन भेजें:

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",
);

शेड्यूल्ड नोटिफ़िकेशन्स

किसी विशिष्ट समय पर डिलीवर होने के लिए नोटिफ़िकेशन शेड्यूल करें:

// 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,
);

बिल्डर पैटर्न

LocalNotification क्लास एक फ्लुएंट बिल्डर API प्रदान करता है। सभी चेनेबल मेथड्स LocalNotification इंस्टेंस लौटाते हैं:

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();

चेनेबल मेथड्स

send()

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

यदि at प्रदान किया गया है, तो उस समय के लिए नोटिफ़िकेशन शेड्यूल करता है। अन्यथा तुरंत दिखाता है।

प्लेटफ़ॉर्म कॉन्फ़िगरेशन

प्लेटफ़ॉर्म-विशिष्ट विकल्प AndroidNotificationConfig और IOSNotificationConfig ऑब्जेक्ट्स के माध्यम से कॉन्फ़िगर किए जाते हैं।

Android कॉन्फ़िगरेशन

setAndroidConfig() में AndroidNotificationConfig पास करें:

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 प्रॉपर्टीज़

iOS कॉन्फ़िगरेशन

setIOSConfig() में IOSNotificationConfig पास करें:

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 प्रॉपर्टीज़

अटैचमेंट्स (केवल iOS)

iOS नोटिफ़िकेशन में इमेज, ऑडियो, या वीडियो अटैचमेंट जोड़ें। अटैचमेंट URL से डाउनलोड किए जाते हैं:

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

नोटिफ़िकेशन्स प्रबंधित करना

किसी विशिष्ट नोटिफ़िकेशन को रद्द करें

await LocalNotification.cancelNotification(42);

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

सभी नोटिफ़िकेशन्स रद्द करें

await LocalNotification.cancelAllNotifications();

बैज काउंट क्लियर करें

await LocalNotification.clearBadgeCount();

अनुमतियाँ

यूज़र से नोटिफ़िकेशन अनुमतियाँ अनुरोध करें:

// 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',
);

अनुमतियाँ NyScheduler.taskOnce के माध्यम से पहले नोटिफ़िकेशन भेजने पर स्वचालित रूप से अनुरोध की जाती हैं।

प्लेटफ़ॉर्म सेटअप

iOS सेटअप

अपनी Info.plist में जोड़ें:

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

Android सेटअप

अपनी AndroidManifest.xml में जोड़ें:

<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 रेफरेंस

स्टैटिक मेथड्स

इंस्टेंस मेथड्स (चेनेबल)