रिच नोटिफ़िकेशन एपीआई

प्लैटफ़ॉर्म में अंतर: Chrome के वर्शन 59 में, Mac OS X उपयोगकर्ताओं के लिए सूचनाएं अलग तरीके से दिखती हैं. Chrome की अपनी सूचनाओं के बजाय, उपयोगकर्ताओं को Mac OS X की मूल सूचनाएं दिखती हैं. इस लेख में ज़्यादा जानें.

रिच नोटिफ़िकेशन एपीआई से आपको टेंप्लेट का इस्तेमाल करके सूचनाएं बनाने और उन्हें दिखाने की सुविधा मिलती है उपयोगकर्ता की सिस्टम ट्रे में उपयोगकर्ताओं को सूचनाएं भेजने के लिए:

सिस्टम उपयोगकर्ता ट्रे में सूचनाएं

स्ट्रक्चर्ड स्निपेट कैसे दिखते हैं

बेहतर सूचनाएं चार अलग-अलग फ़्लेवर में आती हैं: बेसिक, इमेज, लिस्ट, और प्रोग्रेस. सभी सूचनाओं में टाइटल, मैसेज, और सूचना की बाईं ओर दिखने वाला छोटा आइकॉन शामिल होता है एक संदर्भ मैसेज फ़ील्ड है, जो हल्के रंग के फ़ॉन्ट में तीसरे टेक्स्ट फ़ील्ड के तौर पर दिखता है.

बुनियादी इमेज:

सामान्य सूचना

सूची की सूचनाएं, सूची में आइटम की संख्या दिखाती हैं:

सूची की सूचना

इमेज की सूचनाओं में इमेज की झलक शामिल होती है:

इमेज की सूचना

प्रोग्रेस की सूचनाओं में प्रोग्रेस बार दिखता है:

प्रोग्रेस की सूचना

उनका व्यवहार कैसा है

ChromeOS पर, सूचनाएं उपयोगकर्ता के सिस्टम ट्रे में दिखती हैं. साथ ही, ये सूचनाएं सिस्टम ट्रे में तब तक रहती हैं, जब तक उपयोगकर्ता उन्हें खारिज कर देता है. सिस्टम ट्रे, सभी नई सूचनाओं की गिनती रखती है. जब कोई उपयोगकर्ता सूचनाएं मिलने पर, संख्या शून्य पर रीसेट हो जाती है.

सूचनाओं के लिए, प्राथमिकता को दो से दो के बीच रखा जा सकता है. प्राथमिकताएं < ChromeOS में कोई भी यूआरएल नहीं दिखता है सूचना केंद्र पर जाकर, अन्य प्लैटफ़ॉर्म पर गड़बड़ी का मैसेज दिखा सकता है. डिफ़ॉल्ट प्राथमिकता, प्राथमिकता 0 है. प्राथमिकताएं > शून्य, बढ़ी हुई अवधि के लिए दिखाए जाते हैं. साथ ही, ज़्यादा प्राथमिकता वाली सूचनाएं जो सिस्टम ट्रे में दिखती है.

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

सूचना में कार्रवाई

उन्हें कैसे डेवलप करें

इस एपीआई का इस्तेमाल करने के लिए, notifications.create तरीके को कॉल करें और इसके ज़रिए सूचना पास करें options पैरामीटर:

chrome.notifications.create(id, options, creationCallback);

notifications.NotificationOptions में एक notifications.TemplateType शामिल होना चाहिए, जो सूचना की उपलब्ध जानकारी और उसे दिखाने के तरीके के बारे में बताता है.

बुनियादी सूचना बनाएं

सभी तरह के टेंप्लेट (basic, image, list, और progress) में सूचना title और message और iconUrl होते हैं, जो एक छोटे आइकॉन का लिंक होता है जो बाईं ओर दिखाई देता है उस ईमेल पते से,

यहां basic टेंप्लेट का एक उदाहरण दिया गया है:

var opt = {
  type: "basic",
  title: "Primary Title",
  message: "Primary message to display",
  iconUrl: "url_to_small_icon"
}

इमेज के लिए सूचना बनाएं

image टेंप्लेट में एक imageUrl भी शामिल होता है. यह उस इमेज का लिंक होता है जिसकी झलक देखी जा चुकी है सूचना में:

प्लैटफ़ॉर्म में अंतर: Mac OS X पर Chrome वर्शन 59 के बाद के वर्शन का इस्तेमाल करने वाले लोगों को इमेज नहीं दिखेंगी.
var opt = {
  type: "basic",
  title: "Primary Title",
  message: "Primary message to display",
  iconUrl: "url_to_small_icon",
  imageUrl: "url_to_preview_image"
}

Chrome ऐप्स में, कॉन्टेंट की सुरक्षा के बारे में सख्त नीति की वजह से, ये यूआरएल या किसी ब्लॉब या डेटा यूआरएल का इस्तेमाल करें. अपनी इमेज के लिए 3:2 के अनुपात का इस्तेमाल करें; अगर ऐसा नहीं है, तो काला बॉर्डर फ़्रेम करता है.

सूची बनाने की सूचना

list टेंप्लेट, items को सूची के फ़ॉर्मैट में दिखाता है:

प्लैटफ़ॉर्म में अंतर: Mac OS X पर Chrome वर्शन 59+ का इस्तेमाल करने वाले लोगों को, सूची का सिर्फ़ पहला आइटम दिखाया जाता है.
var opt = {
  type: "list",
  title: "Primary Title",
  message: "Primary message to display",
  iconUrl: "url_to_small_icon",
  items: [{ title: "Item1", message: "This is item 1."},
          { title: "Item2", message: "This is item 2."},
          { title: "Item3", message: "This is item 3."}]
}

प्रोग्रेस की सूचना बनाएं

progress टेंप्लेट, प्रोग्रेस बार दिखाता है. इसमें मौजूदा प्रोग्रेस की रेंज 0 से 100 तक होती है:

प्लैटफ़ॉर्म के बीच में अंतर: Mac OS X पर Chrome के 59 या उसके बाद के वर्शन में, प्रोग्रेस बार, प्रोग्रेस बार दिखाने के बजाय सूचना के टाइटल में प्रतिशत के तौर पर दिखता है.
var opt = {
  type: "progress",
  title: "Primary Title",
  message: "Primary message to display",
  iconUrl: "url_to_small_icon",
  progress: 42
}

इवेंट को सुनना और उनका जवाब देना

सभी सूचनाओं में इवेंट लिसनर और इवेंट हैंडलर शामिल हो सकते हैं जो उपयोगकर्ता की कार्रवाइयों का जवाब देते हैं (देखें chrome.events). उदाहरण के लिए, notifications.onButtonClicked इवेंट.

इवेंट लिसनर:

chrome.notifications.onButtonClicked.addListener(replyBtnClick);

इवेंट हैंडलर:

function replyBtnClick {
    //Write function to respond to user action.
}

इवेंट पेज में इवेंट लिसनर और हैंडलर को शामिल करें, ताकि सूचनाएं मिल सकें जब ऐप्लिकेशन या एक्सटेंशन न चल रहा हो, तब भी पॉप-अप हो सकता है.