FCM JavaScript API की मदद से, सूचना वाले मैसेज Chrome ब्राउज़र पर चल रहे वेब ऐप्लिकेशन Push API. इसमें, इस सहायता मैट्रिक्स में दिए गए ब्राउज़र वर्शन और Push API की मदद से काम करने वाले Chrome एक्सटेंशन शामिल हैं.
FCM SDK टूल सिर्फ़ एचटीटीपीएस पर दिखाए जाने वाले पेजों पर काम करता है. ऐसा इसलिए है, क्योंकि इसमें सेवा वर्कर का इस्तेमाल किया जाता है. ये वर्कर सिर्फ़ एचटीटीपीएस साइटों पर उपलब्ध होते हैं. अगर आपको सेवा देने वाली कंपनी की ज़रूरत है, तो हमारा सुझाव है कि आप Firebase होस्टिंग का इस्तेमाल करें. यह आपके डोमेन पर एचटीटीपीएस होस्टिंग के लिए, बिना किसी शुल्क के टियर उपलब्ध कराती है.
FCM JavaScript API का इस्तेमाल शुरू करने के लिए, आपको अपने वेब ऐप्लिकेशन में Firebase जोड़ना होगा. साथ ही, रजिस्ट्रेशन टोकन ऐक्सेस करने के लिए लॉजिक जोड़ना होगा.
FCM SDK टूल जोड़ना और उसे शुरू करना
अगर आपने अब तक ऐसा नहीं किया है, तो Firebase JS SDK टूल इंस्टॉल करें और Firebase को शुरू करें.
Firebase Cloud Messaging JS SDK जोड़ें और Firebase Cloud Messaging शुरू करें:
Web
import { initializeApp } from "firebase/app"; import { getMessaging } from "firebase/messaging"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase const app = initializeApp(firebaseConfig); // Initialize Firebase Cloud Messaging and get a reference to the service const messaging = getMessaging(app);
Web
import firebase from "firebase/compat/app"; import "firebase/compat/messaging"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase firebase.initializeApp(firebaseConfig); // Initialize Firebase Cloud Messaging and get a reference to the service const messaging = firebase.messaging();
अगर फ़िलहाल, वेब के लिए FCM का इस्तेमाल किया जा रहा है और SDK टूल पर अपग्रेड करना है 6.7.0 या उसके बाद के वर्शन पर, आपको FCM रजिस्ट्रेशन एपीआई Google Cloud Console में जोड़ा जा सकता है. एपीआई चालू करते समय,पक्का करें कि आपने Cloud Console में उसी Google खाते से लॉग इन किया है जिसका इस्तेमाल आपने किया है Firebase में बदलाव करें और पक्का करें कि सही प्रोजेक्ट चुना गया हो. FCM SDK टूल जोड़ने वाले नए प्रोजेक्ट में, यह एपीआई डिफ़ॉल्ट रूप से चालू होता है.
FCM की मदद से वेब क्रेडेंशियल कॉन्फ़िगर करें
FCM वेब इंटरफ़ेस, वेब क्रेडेंशियल का इस्तेमाल करता है. इन्हें "Voluntary Application Server Identification" या "VAPID" कुंजियां कहा जाता है. इनका इस्तेमाल, वेब पर पुश नोटिफ़िकेशन की सेवाओं को अनुरोध भेजने की अनुमति देने के लिए किया जाता है. पुश नोटिफ़िकेशन के लिए अपने ऐप्लिकेशन की सदस्यता लेने के लिए, को अपने Firebase प्रोजेक्ट के साथ कुंजियों की एक जोड़ी जोड़ने की ज़रूरत होती है. इनमें से कोई एक विकल्प चुनें Firebase की मदद से, कुंजी का नया जोड़ा जनरेट करें या अपने मौजूदा कुंजी के जोड़े को इंपोर्ट करें कंसोल.
कुंजी का नया जोड़ा जनरेट करें
- Firebase कंसोल के सेटिंग पैनल में, क्लाउड मैसेजिंग टैब खोलें और वेब कॉन्फ़िगरेशन सेक्शन पर स्क्रोल करें.
- वेब पुश सर्टिफ़िकेट टैब में, कुंजी का जोड़ा जनरेट करें पर क्लिक करें. कॉन्टेंट बनाने कंसोल एक सूचना दिखाता है कि कुंजी का जोड़ा जनरेट हुआ है, और सार्वजनिक पासकोड स्ट्रिंग और तारीख जोड़ी गई.
कोई मौजूदा पासकोड जोड़ना
अगर आपके पास कोई मौजूदा पासकोड जोड़ा गया है और उसका इस्तेमाल पहले से ही आपके वेब ऐप्लिकेशन के साथ किया जा रहा है, तो उसे FCM में इंपोर्ट किया जा सकता है. इससे, FCM एपीआई की मदद से, अपने मौजूदा वेब ऐप्लिकेशन इंस्टेंस तक पहुंचा जा सकता है. पासकोड इंपोर्ट करने के लिए, आपके पास Firebase प्रोजेक्ट का मालिक-लेवल ऐक्सेस होना चाहिए. अपनी मौजूदा सार्वजनिक और निजी कुंजी को base64 यूआरएल सेफ़ कोड में बदलकर इंपोर्ट करें:
- खोलें क्लाउड से मैसेज भेजने वाला टैब, Firebase कंसोल की सेटिंग में देखा जा सकता है पैनल में जाकर, वेब कॉन्फ़िगरेशन सेक्शन तक स्क्रोल करें.
- वेब पुश सर्टिफ़िकेट टैब में, लिंक टेक्स्ट ढूंढें और उसे चुनें, "किसी मौजूदा कुंजी का जोड़ा इंपोर्ट करें."
- कुंजी जोड़ी इंपोर्ट करें डायलॉग में, अपने सार्वजनिक और निजी कुंजियों को उनके संबंधित फ़ील्ड में डालें और इंपोर्ट करें पर क्लिक करें. कंसोल सार्वजनिक तौर पर दिखता है की स्ट्रिंग और तारीख जोड़ी गई.
अपने ऐप्लिकेशन में कुंजी जोड़ने के तरीके से जुड़े निर्देशों के लिए, यहां देखें अपने ऐप्लिकेशन में वेब क्रेडेंशियल कॉन्फ़िगर करना. कुंजियों के फ़ॉर्मैट और उन्हें जनरेट करने के तरीके के बारे में ज़्यादा जानकारी के लिए, ऐप्लिकेशन सर्वर कुंजियां देखें.
अपने ऐप्लिकेशन में वेब क्रेडेंशियल कॉन्फ़िगर करना
तरीका getToken(): Promise<string>
मैसेज भेजते समय, FCM को VAPID कुंजी के क्रेडेंशियल का इस्तेमाल करने की अनुमति देता है
अलग-अलग पुश सेवाओं के लिए अनुरोध भेज सकते हैं. FCM की मदद से वेब क्रेडेंशियल कॉन्फ़िगर करें में दिए गए निर्देशों के मुताबिक जनरेट की गई या इंपोर्ट की गई कुंजी का इस्तेमाल करके, मैसेजिंग ऑब्जेक्ट वापस पाने के बाद उसे अपने कोड में जोड़ें:
import { getMessaging, getToken } from "firebase/messaging";
const messaging = getMessaging();
// Add the public key generated from the console here.
getToken(messaging, {vapidKey: "BKagOny0KF_2pCJQ3m....moL0ewzQ8rZu"});
रजिस्ट्रेशन टोकन ऐक्सेस करना
जब आपको किसी ऐप्लिकेशन इंस्टेंस के लिए मौजूदा रजिस्ट्रेशन टोकन को फिर से पाने की ज़रूरत हो, तो सबसे पहले
Notification.requestPermission()
वाले उपयोगकर्ता से सूचना की अनुमतियों का अनुरोध करें.
जब इस तरह कॉल किया जाता है, तब यह एक टोकन दिखाता है. हालांकि, ऐसा तब होता है, जब प्रॉमिस को अनुमति दी गई हो या प्रॉमिस को अस्वीकार कर दिया गया हो
अगर अस्वीकार किया जाता है, तो:
function requestPermission() { console.log('Requesting permission...'); Notification.requestPermission().then((permission) => { if (permission === 'granted') { console.log('Notification permission granted.');
FCM के लिए firebase-messaging-sw.js
फ़ाइल ज़रूरी है.
अगर आपके पास पहले से कोई firebase-messaging-sw.js
फ़ाइल नहीं है, तो टोकन पाने से पहले, उस नाम की एक खाली फ़ाइल बनाएं और उसे अपने डोमेन के रूट में डालें.
क्लाइंट सेटअप करने की प्रोसेस के दौरान, फ़ाइल में काम का कॉन्टेंट जोड़ा जा सकता है.
मौजूदा टोकन वापस पाने के लिए:
Web
import { getMessaging, getToken } from "firebase/messaging"; // Get registration token. Initially this makes a network call, once retrieved // subsequent calls to getToken will return from cache. const messaging = getMessaging(); getToken(messaging, { vapidKey: '<YOUR_PUBLIC_VAPID_KEY_HERE>' }).then((currentToken) => { if (currentToken) { // Send the token to your server and update the UI if necessary // ... } else { // Show permission request UI console.log('No registration token available. Request permission to generate one.'); // ... } }).catch((err) => { console.log('An error occurred while retrieving token. ', err); // ... });
Web
// Get registration token. Initially this makes a network call, once retrieved // subsequent calls to getToken will return from cache. messaging.getToken({ vapidKey: '<YOUR_PUBLIC_VAPID_KEY_HERE>' }).then((currentToken) => { if (currentToken) { // Send the token to your server and update the UI if necessary // ... } else { // Show permission request UI console.log('No registration token available. Request permission to generate one.'); // ... } }).catch((err) => { console.log('An error occurred while retrieving token. ', err); // ... });
टोकन मिलने के बाद, उसे अपने ऐप्लिकेशन सर्वर पर भेजें और अपने पसंदीदा तरीके का इस्तेमाल करके उसे सेव करें.
अगले चरण
सेटअप के चरण पूरे करने के बाद, डेटा ट्रांसफ़र करने के लिए यहां कुछ विकल्प दिए गए हैं वेब (JavaScript) के लिए FCM से फ़ॉरवर्ड करें:
- अपने ऐप्लिकेशन में कुछ सुविधाएं जोड़ें मैसेज पाना न हो.
- हमारे इन ट्यूटोरियल में से किसी एक को आज़माएं: बैकग्राउंड में चल रहे ऐप्लिकेशन पर अपना पहला मैसेज भेजना या एक से ज़्यादा डिवाइसों पर मैसेज भेजना.
- GitHub पर पूरा सैंपल देखें.
- JavaScript रेफ़रंस देखें.
- एपीआई को लागू करने के बारे में वीडियो वॉकथ्रू देखें.