iPadOS 16 下Pan手势无法连续调节屏幕亮度的技术问题及临时方案

问题背景 #

升级到iPadOS 16后，原本在iPadOS 15上正常的连续亮度调节功能出现异常：

• 滑动Pan手势调节亮度时，屏幕经常无反馈
• 只有大幅度滑动（大力执行Pan手势）时才会生效
• 控制台持续打印Brightness Change，说明手势触发正常，但亮度无变化
• 已将废弃的UIScreen.main.brightness替换为(UIApplication.shared.connectedScenes.first as! UIWindowScene).screen.brightness，但问题依旧

原iPadOS 15可用代码 #

private var screen: UIScreen {return (UIApplication.shared.connectedScenes.first as! UIWindowScene).screen}
private var previousLocationY: CGFloat = 0.0
private var direction: Bool = true //going down (darker)
@IBAction func handlePanGesture(_ sender: UIPanGestureRecognizer) {
    switch sender.state {
    case .began:
        self.previousLocationY = sender.location(in: self.view).y
        break
    case .changed:
        self.direction = sender.location(in: self.view).y > self.previousLocationY // down = darker
        if abs(sender.velocity(in: self.view).x) < abs(sender.velocity(in: self.view).y) { // Vertical Pan
            let change = (sender.location(in: self.view).y - self.previousLocationY) * 0.002
            print("***** Brightness Change: \(change), Direction: \(self.direction) *****")
            if self.screen.brightness > 0.01 {
                self.screen.brightness -= change
            }
            self.previousLocationY = sender.location(in: self.view).y
        }
        break
    case .ended:
        break
    default:
        break
    }
}

临时解决方案 #

经过测试，发现iPadOS 16对亮度调节的最小生效幅度做了限制，极小的步长（比如0.002）会被系统忽略。我通过累积调节量，达到阈值（0.025）后再一次性调整亮度，解决了功能失效的问题。

不过这个方案有个缺点：因为是步进式调节，屏幕会出现轻微闪烁，而且无法实现原来的极小步长平滑调节，只能作为临时过渡方案。

更新后的代码：

private var screen: UIScreen {return (UIApplication.shared.connectedScenes.first as! UIWindowScene).screen}
private var previousLocationY: CGFloat = 0.0
private var direction: Bool = true //going down (darker)
private var change: CGFloat = 0.0
@IBAction func handlePanGesture(_ sender: UIPanGestureRecognizer) {
    switch sender.state {
    case .began:
        self.previousLocationY = sender.location(in: self.view).y
        break
    case .changed:
        self.direction = sender.location(in: self.view).y > self.previousLocationY // down = darker
        if abs(sender.velocity(in: self.view).x) < abs(sender.velocity(in: self.view).y) { // Vertical Pan
            let currentChange = (sender.location(in: self.view).y - self.previousLocationY) * 0.002
            change += currentChange
            print("***** Brightness Change: \(change), Direction: \(self.direction) *****")
            if abs(self.change) >= 0.025 { // 累积到指定步长再执行调节
                if direction == true { // 向下滑动（调暗）
                    if self.screen.brightness > 0.01 {
                        self.screen.brightness -= change
                    }
                } else { // 向上滑动（调亮）
                    self.screen.brightness -= change
                }
                self.change = 0.0
            }
            self.previousLocationY = sender.location(in: self.view).y
        }
        break
    case .ended:
        break
    default:
        break
    }
}

后续思考 #

推测这是iPadOS 16对屏幕亮度调节机制做了优化或限制，可能是为了减少系统资源消耗，或者是引入了新的亮度调节精度规则。期待苹果在后续版本中修复这个体验问题，或者提供更明确的API说明。

内容的提问来源于stack exchange，提问作者KaasCoder