chrome.power

Deskripsi

Gunakan chrome.power API untuk mengganti fitur pengelolaan daya sistem.

Izin

power

Konsep dan penggunaan

Secara {i>default<i}, sistem operasi meredupkan layar ketika pengguna tidak aktif dan pada akhirnya menangguhkan sistem file. Dengan API daya, aplikasi atau ekstensi dapat membuat sistem tetap aktif.

Dengan menggunakan API ini, Anda dapat menentukan Level tempat pengelolaan daya dinonaktifkan. "system" membuat sistem tetap aktif, tetapi memungkinkan layar diredupkan atau dimatikan. Sebagai contoh, aplikasi komunikasi dapat terus menerima pesan saat layar mati. Tingkat "display" menjaga layar dan sistem tetap aktif. Aplikasi e-book dan presentasi, misalnya, dapat mempertahankan layar dan sistem aktif sementara pengguna membaca.

Jika pengguna memiliki lebih dari satu aplikasi atau ekstensi yang aktif, masing-masing dengan tingkat dayanya sendiri, tingkat prioritas tertinggi akan berlaku; "display" selalu lebih diprioritaskan daripada "system". Sebagai misalnya, jika aplikasi A meminta pengelolaan daya "system", dan aplikasi B meminta "display", "display" digunakan hingga aplikasi B dihapus muatannya atau melepaskan permintaannya. Jika aplikasi A masih aktif, "system" adalah digunakan.

Jenis

Level

Enum

"system"
Mencegah sistem tidur sebagai respons terhadap ketidakaktifan pengguna.

"display"
Mencegah layar dinonaktifkan atau diredupkan, atau sistem tidak tidur sebagai respons terhadap ketidakaktifan pengguna.

Metode

releaseKeepAwake()

chrome.power.releaseKeepAwake()

Merilis permintaan yang sebelumnya dibuat melalui requestKeepAwake().

reportActivity()

Janji Chrome 113 dan yang lebih baru Khusus ChromeOS 
chrome.power.reportActivity(
  callback?: function,
)

Melaporkan aktivitas pengguna untuk mengaktifkan layar dari status redup atau nonaktif atau dari screensaver. Keluar dari screensaver jika sedang aktif.

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti ini: 

    () => void

Hasil

  • Janji<void>

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

Meminta agar pengelolaan daya dinonaktifkan untuk sementara. level menjelaskan sejauh mana pengelolaan daya harus dinonaktifkan. Jika permintaan yang sebelumnya dibuat oleh aplikasi yang sama masih aktif, permintaan tersebut akan diganti dengan permintaan baru.

Parameter