chrome.power

ब्यौरा

सिस्टम की पावर मैनेजमेंट सुविधाओं को बदलने के लिए, chrome.power एपीआई का इस्तेमाल करें.

अनुमतियां

power

इस्तेमाल

डिफ़ॉल्ट रूप से, ऑपरेटिंग सिस्टम उपयोगकर्ताओं के डिवाइस इस्तेमाल न करने पर स्क्रीन की रोशनी कम कर देते हैं. इसके बाद, सिस्टम को बंद कर देते हैं. पावर एपीआई की मदद से, कोई ऐप्लिकेशन या एक्सटेंशन सिस्टम को चालू रख सकता है.

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

जब किसी उपयोगकर्ता के पास एक से ज़्यादा ऐप्लिकेशन या एक्सटेंशन चालू होते हैं, तो हर ऐप्लिकेशन या एक्सटेंशन का अपना पावर लेवल होता है. ऐसे में, सबसे ज़्यादा प्राथमिकता वाले लेवल को लागू किया जाता है. "display" को हमेशा "system" से ज़्यादा प्राथमिकता मिलती है. उदाहरण के लिए, अगर ऐप्लिकेशन A, "system" पावर मैनेजमेंट का अनुरोध करता है और ऐप्लिकेशन B, "display" का अनुरोध करता है, तो ऐप्लिकेशन B के अनलोड होने या अनुरोध जारी करने तक "display" का इस्तेमाल किया जाता है. अगर ऐप्लिकेशन A अब भी चालू है, तो "system" का इस्तेमाल किया जाता है.

टाइप

Level

Enum

"system"
इससे सिस्टम को उपयोगकर्ता की निष्क्रियता के जवाब में स्लीप मोड में जाने से रोका जाता है.

"display"
इस विकल्प का इस्तेमाल करने पर, उपयोगकर्ता की गतिविधि न होने पर डिसप्ले बंद नहीं होता है, उसकी रोशनी कम नहीं होती है या सिस्टम स्लीप मोड में नहीं जाता है.

तरीके

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

यह फ़ंक्शन, requestKeepAwake() के ज़रिए किए गए अनुरोध को रिलीज़ करता है.

reportActivity()

Promise Chrome 113 या इसके बाद का वर्शन सिर्फ़ ChromeOS के लिए 
chrome.power.reportActivity(
  callback?: function,
): Promise<void>

यह कुकी, उपयोगकर्ता की गतिविधि की रिपोर्ट करती है, ताकि स्क्रीन को कम रोशनी या बंद होने की स्थिति या स्क्रीन सेवर से चालू किया जा सके. अगर स्क्रीन सेवर चालू है, तो उसे बंद कर देता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

    callback पैरामीटर ऐसा दिखता है: 

    () => void

रिटर्न

  • Promise<void>

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म को कॉलबैक का इस्तेमाल करना होगा.

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
): void

ऐसे अनुरोध जो पावर मैनेजमेंट की सुविधा को कुछ समय के लिए बंद करने के लिए किए जाते हैं. level से पता चलता है कि पावर मैनेजमेंट को किस हद तक बंद किया जाना चाहिए. अगर उसी ऐप्लिकेशन का कोई पिछला अनुरोध अब भी चालू है, तो उसे नए अनुरोध से बदल दिया जाएगा.

पैरामीटर