chrome.power

Açıklama

Sistemin güç yönetimi özelliklerini geçersiz kılmak için chrome.power API'yi kullanın.

İzinler

power

Kavramlar ve kullanım

Varsayılan olarak, işletim sistemleri, kullanıcılar etkin olmadığında ekranı karartır ve sonunda sistemi askıya alır. Güç API'si ile bir uygulama veya uzantı, sistemi uyanık tutabilir.

Bu API'yi kullanarak güç yönetiminin devre dışı bırakıldığı Seviyeyi belirtebilirsiniz. "system" düzeyi sistemi etkin tutar ancak ekranın karartılmasına veya kapatılmasına olanak tanır. Örneğin, bir iletişim uygulaması ekran kapalıyken mesaj almaya devam edebilir. "display" düzeyi ise ekranı ve sistemi etkin tutar. Örneğin, e-kitap ve sunum uygulamaları, kullanıcılar okurken ekranı ve sistemi etkin tutabilir.

Bir kullanıcının, her biri kendi güç seviyesine sahip birden fazla uygulaması veya uzantısı olduğunda en yüksek öncelik düzeyi geçerli olur. "display", her zaman "system" uygulamasına göre önceliklidir. Örneğin, A uygulaması "system" güç yönetimini, B uygulaması da "display" isteğinde bulunursa "display", B uygulaması kaldırılana veya isteğini serbest bırakana kadar kullanılır. A uygulaması hâlâ etkinse "system" kullanılır.

Türler

Level

Enum

"system"
Sistemin, kullanıcının etkinlik olmaması durumunda uyku moduna geçmesini önler.

"display"
Ekranın kapatılmasını veya kararmasını ya da kullanıcının işlem yapmamasına bağlı olarak sistemin uyku moduna geçmesini engeller.

Yöntemler

releaseKeepAwake()

chrome.power.releaseKeepAwake()

Daha önce requestKeepAwake() aracılığıyla yapılan bir isteği serbest bırakır.

reportActivity()

Promise Chrome 113 ve sonraki sürümler Yalnızca ChromeOS'te
chrome.power.reportActivity(
  callback?: function,
)

Ekranı karartılmış veya kapalı durumdayken ya da ekran koruyucudan uyandırmak amacıyla yapılan kullanıcı etkinliğini bildirir. Etkin durumdaysa ekran koruyucudan çıkar.

Parametreler

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür:

    ()=>void

İlerlemeler

  • Promise<void>

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

Güç yönetiminin geçici olarak devre dışı bırakılmasına yönelik istekler. level, güç yönetiminin ne kadar devre dışı bırakılması gerektiğini açıklar. Aynı uygulama tarafından daha önce gönderilen bir istek hâlâ etkinse yeni istekle değiştirilir.

Parametreler