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

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 ऐप्लिकेशन में मैसेज पाने की सुविधा देखें.

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

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

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