在 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);
// ...
}
在佈局文件的根 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 附著在窗口管理器且可見,就保持屏幕常亮、不進入休眠。WAKE_LOCK 權限,安裝時無提示,用戶無感知。setContentView() 前調用,否則可能不生效(Window 尚未創建)。PowerManager.PARTIAL_WAKE_LOCK。一行代碼 getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON) 或 XML android:keepScreenOn="true" 即可優雅實現「禁止黑屏進入省電模式」,零權限、零洩漏、系統級托管,是前台 Activity 保持屏幕常亮的最佳實踐。