萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 禁止黑屏進入省電模式:FLAG_KEEP_SCREEN_ON 一行代碼搞定

核心代碼

在 Activity.onCreate() 中,必須在 setContentView() 之前 調用:

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // 關鍵:在 setContentView 之前設置
    getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);
    setContentView(R.layout.activity_main);
    // ...
}

等效 XML 寫法(更簡潔)

在佈局文件的根 ViewGroup 上添加屬性:

<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:keepScreenOn="true"
    android:orientation="vertical">
    <!-- 內容 -->
</LinearLayout>

原理解析

  • FLAG_KEEP_SCREEN_ON 告訴 WindowManager:只要該 Window 附著在窗口管理器且可見,就保持屏幕常亮、不進入休眠。
  • 系統自動隨 Window 生命週期(顯示/隱藏、Activity 暫停/恢復)管理底層 WakeLock,開發者無需手動 acquire/release。
  • 不需要 WAKE_LOCK 權限,安裝時無提示,用戶無感知。

適用場景

  • 視頻播放器、直播頁
  • 導航/地圖引導頁
  • 電子書閱讀器
  • 遊戲主界面
  • 長時間表單填寫、文檔查看

注意事項

  1. 位置關鍵:必須在 setContentView() 前調用,否則可能不生效(Window 尚未創建)。
  2. 不要濫用:僅在確實需要的 Activity 設置,退出該頁面系統自動恢復正常休眠策略。
  3. 非 Activity 場景:Service、BroadcastReceiver 無 Window,無法使用此標誌,需改用 PowerManager.PARTIAL_WAKE_LOCK。
  4. 與 WakeLock 互斥:同一界面不要同時用兩種方式,避免衝突。

驗證方法

  1. 啟動該 Activity
  2. 等待超過系統休眠超時時間(通常 30 秒 - 1 分鐘)
  3. 觀察屏幕是否保持常亮,電源鍵是否無法鎖屏(部分 ROM 允許電源鍵強制鎖屏)

總結

一行代碼 getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON) 或 XML android:keepScreenOn="true" 即可優雅實現「禁止黑屏進入省電模式」,零權限、零洩漏、系統級托管,是前台 Activity 保持屏幕常亮的最佳實踐。

copyright © 萬盛學電腦網 all rights reserved