Android 15 AccessibilityService 全屏放大切到主屏后重置为 1.0
数据小陈
结论:Android 的公开无障碍 API 没有提供能“永久锁定全屏放大”的可靠开关。MagnificationController.setMagnificationConfig() 只是向系统请求放大状态,返回 true 仅表示本次请求被接受,并不保证切换到 Launcher 主屏幕后仍然保持。更实际的做法是监听放大变化和窗口变化,等窗口稳定后检查当前 MagnificationConfig,只在确认被重置时延迟恢复,并做好去重和退避,避免反复闪烁。
为什么会重置
主屏幕通常由 Launcher 窗口承载。切换到主屏幕时,系统可能根据窗口或显示状态重新计算放大状态,把你设置的 1.5 恢复为默认的 1.0。你在检测到重置后立即恢复一次,API 返回 true,但系统随后完成窗口切换并再次覆盖,所以表现为“短暂放大后又恢复”。
这不是 AccessibilityService 断开,也不一定是你 XML 配置漏了 canControlMagnification="true"。该属性是控制放大的必要条件,但不能保证跨任意窗口永久保持。
推荐处理方式
- 保留
android:canControlMagnification="true"。 - 监听
MagnificationController的放大变化,同时监听TYPE_WINDOW_STATE_CHANGED和TYPE_WINDOWS_CHANGED。 - 不要在收到回调时立刻同步调用
setMagnificationConfig()。先延迟 200~300 ms,等窗口切换稳定后再检查。 - 检查当前
MagnificationConfig是否已经是全屏模式、isActivated为 true、scale 接近目标值;如果已经是,不要重复设置。 - 用一个
applying标志忽略自己调用触发的回调,用pendingRestore去重,避免死循环。 - 连续失败时做退避,不要无间隔重试。
示例代码(按 Android 14+ 的 MagnificationConfig 回调编写;如果你的编译 SDK 回调签名不同,以 IDE 提示为准):
class MyAccessibilityService : AccessibilityService() {
private lateinit var magnificationController: AccessibilityService.MagnificationController
private val handler = Handler(Looper.getMainLooper())
private var pendingRestore = false
private var applying = false
private val targetScale = 1.5f
private val restoreRunnable = Runnable {
pendingRestore = false
restoreMagnificationIfNeeded()
}
override fun onServiceConnected() {
super.onServiceConnected()
magnificationController = getMagnificationController()
magnificationController.addListener { controller, config ->
if (applying) return@addListener
if (!config.isActivated || config.scale < targetScale - 0.01f) {
scheduleRestore(250L)
}
}
restoreMagnificationIfNeeded()
}
override fun onAccessibilityEvent(event: AccessibilityEvent?) {
when (event?.eventType) {
AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED,
AccessibilityEvent.TYPE_WINDOWS_CHANGED -> scheduleRestore(250L)
}
}
override fun onInterrupt() {}
private fun scheduleRestore(delayMs: Long) {
if (pendingRestore) return
pendingRestore = true
handler.removeCallbacks(restoreRunnable)
handler.postDelayed(restoreRunnable, delayMs)
}
private fun restoreMagnificationIfNeeded() {
if (applying) return
val current = magnificationController.magnificationConfig
if (current != null &&
current.isActivated &&
current.mode == MagnificationConfig.MAGNIFICATION_MODE_FULLSCREEN &&
abs(current.scale - targetScale) < 0.01f
) {
return
}
val config = MagnificationConfig.Builder()
.setMode(MagnificationConfig.MAGNIFICATION_MODE_FULLSCREEN)
.setScale(targetScale)
.setActivated(true)
.build()
applying = true
val ok = magnificationController.setMagnificationConfig(config, false)
applying = false
if (!ok) {
// 可做指数退避重试,但不要无间隔死循环
}
}
}
注意事项
setMagnificationConfig(config, true)的第二个参数是是否使用动画。恢复时可以考虑传false,减少动画期间的额外回调,但它不能保证系统不覆盖。- 如果你的
accessibilityEventTypes以后从typeAllMask改成更细的过滤,记得保留TYPE_WINDOW_STATE_CHANGED和TYPE_WINDOWS_CHANGED,否则主屏幕切换事件可能收不到。 - 如果延迟恢复仍然被覆盖,可以增加延迟或改为监听窗口内容稳定后再恢复;但不要无限缩短重试间隔,否则更容易和系统状态打架。
- Launcher、锁屏、系统设置、权限弹窗等界面可能由系统控制放大状态,第三方无障碍服务不一定能强制保持。应以目标设备和 Android 版本的实际行为为准。
- 先确认无障碍服务已启用且
canControlMagnification="true",再用日志打印每次回调的config.isActivated、config.mode和config.scale,判断是系统覆盖还是自己的恢复逻辑造成循环。
备注:内容仅供参考。
