WakeLock
WakeLock 介面屬於 Screen Wake Lock API,可用於請求鎖定,防止裝置螢幕在應用程式需要保持執行時變暗或鎖定。
此介面以及系統喚醒鎖透過 Navigator.wakeLock 屬性公開。
例項方法
request()-
如果螢幕喚醒鎖被授予,則返回一個
Promise,該 Promise 將解析為WakeLockSentinel物件。
示例
以下程式碼 awaits 請求 WakeLockSentinel 物件,如果請求被授予則繼續執行。
WakeLock.request() 方法被包裝在一個 try...catch 語句中,用於捕獲 promise 可能被拒絕的情況,例如由於裝置電量不足。
js
try {
const wakeLock = await navigator.wakeLock.request("screen");
} catch (err) {
// the wake lock request fails - usually system related, such being low on battery
console.log(`${err.name}, ${err.message}`);
}
請注意,螢幕喚醒鎖在被授予後可能會被裝置撤銷。返回的 WakeLockSentinel 可用於檢查鎖的狀態,和/或手動取消已持有的螢幕喚醒鎖。
規範
| 規範 |
|---|
| Screen Wake Lock API # the-wakelock-interface |
瀏覽器相容性
載入中…