उन विकल्पों को दिखाने वाला इंटरफ़ेस जो FCM के पुराने एपीआई के ज़रिए मैसेज भेजते समय दिए जा सकते हैं.
कोड सैंपल और ज़्यादा जानकारी वाले दस्तावेज़ के लिए, ईमेल भेजने के अनुरोध बनाएं देखें.
हस्ताक्षर:
export interface MessagingOptions
प्रॉपर्टी
प्रॉपर्टी | टाइप | ब्यौरा |
---|---|---|
संक्षिप्त बटन | स्ट्रिंग | मैसेज के उस ग्रुप की पहचान करने वाली स्ट्रिंग (उदाहरण के लिए, "अपडेट उपलब्ध") जिसे छोटा किया जा सकता है. ऐसा इसलिए, ताकि डिलीवरी फिर से शुरू होने पर सिर्फ़ आखिरी मैसेज भेजा जा सके. डिवाइस के वापस ऑनलाइन आने या चालू होने पर, एक ही मैसेज को बहुत ज़्यादा भेजने से बचने के लिए इसका इस्तेमाल किया जाता है.मैसेज भेजे जाने के क्रम की कोई गारंटी नहीं है.किसी भी समय, छोटा करने के लिए ज़्यादा से ज़्यादा चार अलग-अलग कुंजियों का इस्तेमाल किया जा सकता है. इसका मतलब है कि FCM सर्वर हर क्लाइंट ऐप्लिकेशन के लिए सिंक करने के लिए भेजें वाले चार अलग-अलग मैसेज को एक साथ सेव कर सकता है. अगर इस संख्या को पार कर लिया जाता है, तो इस बात की कोई गारंटी नहीं है कि FCM सर्वर, छोटा करने वाली कौनसी चार कुंजियों को बनाए रखेगा.**डिफ़ॉल्ट वैल्यू:** कोई नहीं |
कॉन्टेंट उपलब्ध है | बूलियन | iOS पर, एपीएन पेलोड में content-available को दिखाने के लिए, इस फ़ील्ड का इस्तेमाल करें. जब कोई सूचना या डेटा मैसेज भेजा जाता है और इस सेटिंग को true पर सेट किया जाता है, तो एक बंद क्लाइंट ऐप्लिकेशन चालू हो जाता है. Android पर डेटा मैसेज, डिफ़ॉल्ट रूप से ऐप्लिकेशन को वेक करते हैं. फ़िलहाल, Chrome पर यह फ़्लैग मौजूद नहीं है.**डिफ़ॉल्ट वैल्यू:** false |
ड्रायरन | बूलियन | मैसेज भेजा जाना चाहिए या नहीं. अगर नीति को true पर सेट किया जाता है, तो डेवलपर को कोई मैसेज भेजे बिना ही, किसी अनुरोध की जांच करने की सुविधा मिलती है. false पर सेट करने पर, मैसेज भेजा जाएगा.**डिफ़ॉल्ट वैल्यू:** false |
म्यूटेबल कॉन्टेंट | बूलियन | iOS पर, एपीएन पेलोड में mutable-content को दिखाने के लिए, इस फ़ील्ड का इस्तेमाल करें. जब कोई सूचना भेजी जाती है और इसे true पर सेट किया जाता है, तो सूचना सेवा ऐप्लिकेशन एक्सटेंशन का इस्तेमाल करके, सूचना के कॉन्टेंट में बदलाव किया जा सकता है..Android और वेब पर, इस पैरामीटर को अनदेखा किया जाएगा.**डिफ़ॉल्ट वैल्यू:** false |
प्राथमिकता | स्ट्रिंग | मैसेज की प्राथमिकता. मान्य वैल्यू "normal" और "high". हैं. iOS पर, ये एपीएन की प्राथमिकताओं 5 और 10 के मुताबिक हैं.डिफ़ॉल्ट रूप से, सूचना वाले मैसेज ज़्यादा प्राथमिकता पर भेजे जाते हैं और डेटा मैसेज को सामान्य प्राथमिकता के साथ भेजा जाता है. सामान्य प्राथमिकता, क्लाइंट ऐप्लिकेशन के बैटरी खर्च को ऑप्टिमाइज़ करती है. अगर तुरंत डिलीवरी की ज़रूरत न हो, तो इसका इस्तेमाल किया जाना चाहिए. सामान्य प्राथमिकता वाले मैसेज के लिए, ऐप्लिकेशन को बिना तय देरी के मैसेज मिल सकता है.जब ज़्यादा प्राथमिकता वाला मैसेज भेजा जाता है, तो उसे तुरंत भेजा जाता है. साथ ही, ऐप्लिकेशन स्लीप मोड वाले डिवाइस को चालू करके, आपके सर्वर से इंटरनेट कनेक्ट कर सकता है.ज़्यादा जानकारी के लिए, मैसेज की प्राथमिकता सेट करना देखें.**डिफ़ॉल्ट वैल्यू:** डेटा मैसेज के लिए "normal" "high" |
प्रतिबंधितपैकेज का नाम | स्ट्रिंग | ऐप्लिकेशन का वह पैकेज नाम जिससे मैसेज पाने के लिए रजिस्ट्रेशन टोकन का मिलान होना ज़रूरी है.**डिफ़ॉल्ट मान:** कोई नहीं |
टाइम टूलाइव | नंबर | अगर डिवाइस ऑफ़लाइन है, तो मैसेज को FCM स्टोरेज में कितनी देर (सेकंड में) रखा जाना चाहिए. लाइव स्ट्रीम करने में ज़्यादा से ज़्यादा चार हफ़्ते लग सकते हैं. साथ ही, डिफ़ॉल्ट वैल्यू भी चार हफ़्ते है. ज़्यादा जानकारी के लिए, मैसेज की अवधि तय करना देखें.**डिफ़ॉल्ट वैल्यू:** 2419200 (चार हफ़्ते को सेकंड में दिखाता है) |
मैसेजिंग विकल्प.छोटा करने की कुंजी
मैसेज के उस ग्रुप की पहचान करने वाली स्ट्रिंग (उदाहरण के लिए, "अपडेट उपलब्ध") जिसे छोटा किया जा सकता है. ऐसा इसलिए, ताकि डिलीवरी फिर से शुरू होने पर सिर्फ़ आखिरी मैसेज भेजा जा सके. इसका इस्तेमाल डिवाइस के वापस ऑनलाइन आने या फिर से चालू होने पर एक ही तरह के कई मैसेज भेजने से बचने के लिए किया जाता है.
इस बात की कोई गारंटी नहीं है कि मैसेज किस क्रम में भेजे जाएंगे.
एक समय में, ज़्यादा से ज़्यादा चार अलग-अलग छोटा करने वाले बटनों की अनुमति दी जा सकती है. इसका मतलब है कि FCM सर्वर हर क्लाइंट ऐप्लिकेशन के लिए सिंक करने के लिए भेजें वाले चार अलग-अलग मैसेज को एक साथ सेव कर सकता है. अगर इस संख्या को पार कर लिया जाता है, तो इस बात की कोई गारंटी नहीं है कि FCM सर्वर को छोटा करने के लिए इस्तेमाल की जाने वाली चार कुंजियां संभालकर रखेगी.
**डिफ़ॉल्ट वैल्यू:** कोई नहीं
हस्ताक्षर:
collapseKey?: string;
MessagingOptions.contentAvailable
iOS पर, एपीएन पेलोड में content-available
को दिखाने के लिए, इस फ़ील्ड का इस्तेमाल करें. जब कोई सूचना या डेटा मैसेज भेजा जाता है और इसे true
पर सेट किया जाता है, तो एक इनऐक्टिव क्लाइंट ऐप्लिकेशन चालू हो जाता है. Android पर डेटा मैसेज, डिफ़ॉल्ट रूप से ऐप्लिकेशन को वेक करते हैं. फ़िलहाल, यह फ़्लैग Chrome पर काम नहीं करता.
**डिफ़ॉल्ट वैल्यू:** false
हस्ताक्षर:
contentAvailable?: boolean;
MessagingOptions.dryRun
मैसेज भेजा जाना चाहिए या नहीं. अगर नीति को true
पर सेट किया जाता है, तो डेवलपर बिना कोई मैसेज भेजे, अनुरोध की जांच कर सकते हैं. false
पर सेट करने पर, मैसेज भेजा जाएगा.
**डिफ़ॉल्ट वैल्यू:** false
हस्ताक्षर:
dryRun?: boolean;
मैसेज सेवा के विकल्पों में बदलाव करना
iOS पर, एपीएन पेलोड में mutable-content
को दिखाने के लिए, इस फ़ील्ड का इस्तेमाल करें. जब कोई सूचना भेजी जाती है और इसे true
पर सेट किया जाता है, तो सूचना के कॉन्टेंट को दिखाए जाने से पहले बदला जा सकता है. इसके लिए, सूचना सेवा ऐप्लिकेशन एक्सटेंशन का इस्तेमाल करें.
Android और वेब पर इस पैरामीटर को अनदेखा कर दिया जाएगा.
**डिफ़ॉल्ट वैल्यू:** false
हस्ताक्षर:
mutableContent?: boolean;
मैसेजिंग विकल्प.प्राथमिकता
मैसेज की प्राथमिकता. iOS पर मान्य वैल्यू, "normal"
और "high".
हैं. ये एपीएन की प्राथमिकताओं 5
और 10
के मुताबिक हैं.
डिफ़ॉल्ट रूप से, सूचना वाले मैसेज ज़्यादा प्राथमिकता पर भेजे जाते हैं और डेटा मैसेज, सामान्य प्राथमिकता पर भेजे जाते हैं. सामान्य प्राथमिकता, क्लाइंट ऐप्लिकेशन के बैटरी खर्च को ऑप्टिमाइज़ करती है. अगर तुरंत डिलीवरी की ज़रूरत न हो, तो इसका इस्तेमाल किया जाना चाहिए. सामान्य प्राथमिकता वाले मैसेज के लिए, ऐप्लिकेशन को बिना किसी तय देरी के मैसेज मिल सकते हैं.
जब किसी मैसेज को ज़्यादा प्राथमिकता के साथ भेजा जाता है, तो उसे तुरंत भेज दिया जाता है. इसके बाद, ऐप्लिकेशन स्लीप मोड वाले डिवाइस को चालू कर सकता है और आपके सर्वर से इंटरनेट चालू कर सकता है.
ज़्यादा जानकारी के लिए, मैसेज की प्राथमिकता सेट करना देखें.
**डिफ़ॉल्ट वैल्यू:** सूचना वाले मैसेज के लिए "high"
, डेटा मैसेज के लिए "normal"
हस्ताक्षर:
priority?: string;
मैसेज सेवा के विकल्पों.सीमित पैकेज का नाम
ऐप्लिकेशन का पैकेज नाम, जिससे मैसेज पाने के लिए रजिस्ट्रेशन टोकन का मेल खाना ज़रूरी है.
**डिफ़ॉल्ट वैल्यू:** कोई नहीं
हस्ताक्षर:
restrictedPackageName?: string;
मैसेजिंग ऑप्शन.टाइम टूलाइव
अगर डिवाइस ऑफ़लाइन है, तो मैसेज को FCM स्टोरेज में कितनी देर (सेकंड में) रखा जाना चाहिए. लाइव स्ट्रीम करने में ज़्यादा से ज़्यादा चार हफ़्ते लग सकते हैं. साथ ही, डिफ़ॉल्ट वैल्यू भी चार हफ़्ते है. ज़्यादा जानकारी के लिए, मैसेज की अवधि तय करना देखें.
**डिफ़ॉल्ट वैल्यू:** 2419200
(सेकंड में चार हफ़्तों को दिखाता है)
हस्ताक्षर:
timeToLive?: number;