बैकग्राउंड में चल रहे ऐप्लिकेशन को टेस्ट मैसेज भेजें

FCM के साथ शुरू करने के लिए, सबसे आसान इस्तेमाल का उदाहरण बनाएं: डिवाइस में बैकग्राउंड में ऐप्लिकेशन होने पर, किसी डेवलपमेंट डिवाइस पर सूचना लिखने वाले व्यक्ति से जांच के तौर पर सूचना भेजने वाला मैसेज भेजें. इस पेज पर, सेटअप से लेकर पुष्टि तक के सभी चरणों की जानकारी दी गई है. अगर आपने FCM के लिए Flutter ऐप्लिकेशन सेट अप कर लिया है, तो हो सकता है कि इस पेज पर वे चरण भी शामिल हों जिन्हें आपने पहले ही पूरा कर लिया है.

FCM प्लग इन इंस्टॉल करें

  1. अगर आपने अब तक Flutter के लिए Firebase SDK टूल इंस्टॉल और शुरू नहीं किए हैं, तो ऐसा करें.

  2. प्लग इन इंस्टॉल करने के लिए, अपने Flutter प्रोजेक्ट के रूट से यह कमांड चलाएं:

    flutter pub add firebase_messaging

  3. इसके बाद, अपना Flutter ऐप्लिकेशन फिर से बनाएं:

    flutter run

रजिस्ट्रेशन टोकन ऐक्सेस करना

किसी डिवाइस पर मैसेज भेजने के लिए, आपके पास उस डिवाइस के रजिस्ट्रेशन टोकन की जानकारी होनी चाहिए. इस ट्यूटोरियल को पूरा करने के लिए, आपको सूचना कंसोल में मौजूद किसी फ़ील्ड में टोकन डालना होगा. इसलिए, टोकन को कॉपी करना न भूलें या वापस पाने के बाद उसे सुरक्षित तरीके से सेव करें.

किसी ऐप्लिकेशन इंस्टेंस का मौजूदा रजिस्ट्रेशन टोकन फिर से पाने के लिए, getToken() को कॉल करें. अगर सूचना पाने की अनुमति नहीं दी गई है, तो इस तरीके में उपयोगकर्ता से सूचना की अनुमतियां मांगी जाएंगी. ऐसा नहीं करने पर, यह टोकन दिखाता है या किसी गड़बड़ी की वजह से, आने वाले समय को अस्वीकार कर देता है.

final fcmToken = await FirebaseMessaging.instance.getToken();

सूचना भेजने की सुविधा की जांच करने के लिए मैसेज भेजना

  1. टारगेट किए गए डिवाइस पर ऐप्लिकेशन इंस्टॉल करें और चलाएं. Apple डिवाइसों पर, आपको रिमोट सूचनाएं पाने के लिए अनुमति का अनुरोध स्वीकार करना होगा.

  2. पक्का करें कि ऐप्लिकेशन, डिवाइस के बैकग्राउंड में चल रहा हो.

  3. Firebase कंसोल में, मैसेज सेवा वाला पेज खोलें.

  4. अगर यह आपका पहला मैसेज है, तो अपना पहला कैंपेन बनाएं चुनें.

    1. Firebase सूचना मैसेज चुनें और बनाएं चुनें.

  5. इसके अलावा, कैंपेन टैब में, नया कैंपेन चुनें. इसके बाद, सूचनाएं चुनें.

  6. मैसेज का टेक्स्ट डालें. अन्य सभी फ़ील्ड ज़रूरी नहीं हैं.

  7. दाएं पैनल से, जांच मैसेज भेजें को चुनें.

  8. FCM रजिस्ट्रेशन टोकन जोड़ें लेबल वाले फ़ील्ड में, वह रजिस्ट्रेशन टोकन डालें जो आपको इस गाइड के पिछले सेक्शन में मिला था.

  9. जांचें को चुनें.

जांच करें चुनने के बाद, टारगेट किए गए क्लाइंट डिवाइस (जिस पर ऐप्लिकेशन बैकग्राउंड में चल रहा है) को सूचना मिलनी चाहिए.

अपने ऐप्लिकेशन पर मैसेज डिलीवरी की अहम जानकारी पाने के लिए, FCM रिपोर्टिंग डैशबोर्ड देखें. इसमें, Apple और Android डिवाइसों पर भेजे गए और खोले गए मैसेज की संख्या के साथ-साथ, Android ऐप्लिकेशन के लिए "इंप्रेशन" (उपयोगकर्ताओं को मिली सूचनाएं) का डेटा भी रिकॉर्ड किया जाता है.

इंटरैक्शन मैनेज करना

जब उपयोगकर्ता किसी सूचना पर टैप करते हैं, तो Android और iOS, दोनों पर डिफ़ॉल्ट रूप से ऐप्लिकेशन खुल जाता है. अगर ऐप्लिकेशन बंद कर दिया जाता है, तो उसे शुरू कर दिया जाएगा. अगर ऐप्लिकेशन बैकग्राउंड में है, तो उसे फ़ोरग्राउंड में लाया जाएगा.

सूचना के कॉन्टेंट के आधार पर, हो सकता है कि ऐप्लिकेशन खुलने पर आप उपयोगकर्ता का इंटरैक्शन मैनेज करना चाहें. उदाहरण के लिए, अगर सूचना का इस्तेमाल करके कोई नया चैट मैसेज भेजा जाता है और उपयोगकर्ता उसे चुनता है, तो हो सकता है कि आप ऐप्लिकेशन खुलने पर उस बातचीत को खोलना चाहें.

firebase-messaging पैकेज, इस इंटरैक्शन को मैनेज करने के दो तरीके उपलब्ध कराता है:

  1. getInitialMessage(): अगर ऐप्लिकेशन को बंद होने की स्थिति से खोला जाता है, तो यह तरीका Future दिखाता है, जिसमें RemoteMessage शामिल होता है. इस्तेमाल करने के बाद, RemoteMessage हटा दिया जाएगा.
  2. onMessageOpenedApp: एक Stream जो बैकग्राउंड में ऐप्लिकेशन खोलने पर RemoteMessage पोस्ट करता है.

अपने उपयोगकर्ताओं को बेहतर अनुभव देने के लिए, आपको दोनों स्थितियों को मैनेज करना चाहिए. नीचे दिए गए कोड उदाहरण में बताया गया है कि इसका इस्तेमाल कैसे किया जा सकता है:

class Application extends StatefulWidget {
  @override
  State<StatefulWidget> createState() => _Application();
}

class _Application extends State<Application> {
  // In this example, suppose that all messages contain a data field with the key 'type'.
  Future<void> setupInteractedMessage() async {
    // Get any messages which caused the application to open from
    // a terminated state.
    RemoteMessage? initialMessage =
        await FirebaseMessaging.instance.getInitialMessage();

    // If the message also contains a data property with a "type" of "chat",
    // navigate to a chat screen
    if (initialMessage != null) {
      _handleMessage(initialMessage);
    }

    // Also handle any interaction when the app is in the background via a
    // Stream listener
    FirebaseMessaging.onMessageOpenedApp.listen(_handleMessage);
  }

  void _handleMessage(RemoteMessage message) {
    if (message.data['type'] == 'chat') {
      Navigator.pushNamed(context, '/chat',
        arguments: ChatArguments(message),
      );
    }
  }

  @override
  void initState() {
    super.initState();

    // Run code required to handle interacted messages in an async function
    // as initState() must not be async
    setupInteractedMessage();
  }

  @override
  Widget build(BuildContext context) {
    return Text("...");
  }
}

इंटरैक्शन को मैनेज करने का तरीका, आपके ऐप्लिकेशन के सेटअप पर निर्भर करता है. ऊपर दिए गए उदाहरण में, StatefulWidget इस्तेमाल करने का बुनियादी उदाहरण दिया गया है.

अगले चरण

फ़ोरग्राउंड में चल रहे ऐप्लिकेशन को मैसेज भेजना

ऐप्लिकेशन बैकग्राउंड में होने पर सूचना मैसेज भेजने के बाद, फ़ोरग्राउंड में मौजूद ऐप्लिकेशन पर मैसेज भेजने के लिए, Flutter ऐप्लिकेशन में मैसेज पाने की सुविधा देखें.

सूचना मैसेज के अलावा और भी सुविधाएं

अपने ऐप्लिकेशन में, ज़्यादा बेहतर तरीके से काम करने की सुविधा जोड़ने के लिए, आपको सर्वर लागू करना होगा.

इसके बाद, अपने ऐप्लिकेशन क्लाइंट में: