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

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

सेलर रेटिंग किस तरह दिखती हैं

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

बेसिक इमेज:

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

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

प्रोग्रेस नोटिफ़िकेशन में, प्रोग्रेस बार दिख रहा है:

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

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

सूचनाओं को -2 से 2 के बीच प्राथमिकता असाइन की जा सकती है. प्राथमिकता < 0 ChromeOS के सूचना केंद्र में दिखती है. इससे दूसरे प्लैटफ़ॉर्म पर गड़बड़ी का मैसेज दिखता है. प्राथमिकता 0 डिफ़ॉल्ट प्राथमिकता है. प्राथमिकताएं > 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 भी शामिल होता है. यह उस इमेज का लिंक होता है जिसकी झलक सूचना में देखी गई थी:

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 को सूची के फ़ॉर्मैट में दिखाता है:

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 के बीच होती है:

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.
}

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