chrome.power

ब्यौरा

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

अनुमतियां

power

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

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

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

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

टाइप

Level

Enum

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

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

तरीके

releaseKeepAwake()

chrome.power.releaseKeepAwake()

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

reportActivity()

प्रॉमिस Chrome 113 और उसके बाद वाले वर्शन के लिए सिर्फ़ ChromeOS 
chrome.power.reportActivity(
  callback?: function,
)

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

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

    () => void

रिटर्न

  • प्रॉमिस<void>

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

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

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

पैरामीटर