chrome.power

ब्यौरा

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

अनुमतियां

power

सिद्धांत और इस्तेमाल

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

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

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

टाइप

Level

Enum

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

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

तरीके

releaseKeepAwake()

chrome.power.releaseKeepAwake()

requestKeepAwake() की मदद से पहले किए गए अनुरोध को रिलीज़ करता है.

reportActivity()

वादा करें Chrome 113+ सिर्फ़ ChromeOS के लिए
chrome.power.reportActivity(
  callback?: function,
)

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

पैरामीटर

  • कॉलबैक

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

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

    ()=>void

रिटर्न

  • Promise<void>

    प्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

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

पैरामीटर