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

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(): अगर ऐप्लिकेशन को बंद स्थिति से खोला जाता है, तो यह तरीका RemoteMessage वाला Future दिखाता है. इस्तेमाल करने पर, 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 ऐप्लिकेशन में मैसेज पाएं देखें.

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

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

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