iOS 只開放讀取系統亮度([UIScreen mainScreen].brightness)與設定系統亮度,並沒有提供「僅在 App 內變暗、不影響系統設定」的官方介面。若你的需求是讓畫面看起來更暗,實務上常用的折衷做法是蓋一層半透明黑色窗格,靠調整 alpha 值製造明暗變化——這也就是所謂的偽亮度。
這個技巧只能把畫面變暗,無法變亮超過系統設定值;而且它是「蓋一層黑紗」,本質上不等於降低背光,因此對耗電沒有幫助。若你的目的是閱讀器夜間模式,這個做法很合適;若目的是省電,則只能靠系統亮度 API。
- (void)installBrightnessWindow {
m_brightnessWindow = [[UIWindow alloc] initWithFrame:self.view.window.frame];
// 蓋在狀態列之上,確保整個畫面都被覆蓋
m_brightnessWindow.windowLevel = UIWindowLevelStatusBar + 1;
// 關閉互動,讓觸控事件穿透到下方的內容
m_brightnessWindow.userInteractionEnabled = NO;
m_brightnessWindow.backgroundColor = [UIColor blackColor];
m_brightnessWindow.alpha = 0;
m_brightnessWindow.hidden = NO;
}
建立好窗格後,只要改 alpha 就能控制暗度:0 代表完全不遮,1 代表全黑。若要平滑過渡,加上動畫即可。
- (void)setBrightnessFactor:(CGFloat)factor {
// factor 取 0 ~ 1,0 為最暗、1 為不遮光
[UIView animateWithDuration:0.25 animations:^{
m_brightnessWindow.alpha = 1.0 - factor;
}];
}
userInteractionEnabled 必須設為 NO。 否則這層窗會吃掉所有觸控,使用者會覺得 App 當掉了。
windowLevel 的選擇。 設為 UIWindowLevelStatusBar + 1 是為了蓋過狀態列。若你要蓋住的範圍不含狀態列,把 level 調低即可。
記得在離開時清掉。 若這個 window 被強引用在控制器上,控制器釋放時要一併 nil 掉,避免留下孤兒窗格影響後續頁面。
iOS 13 以後的注意事項。 多 window 場景(Scene)普及後,直接自建 UIWindow 需改用 UIWindowScene 初始化,否則在新版系統上可能不會顯示。