PAYATHON 2026

Android 15 AccessibilityService 全屏放大切到主屏后重置为 1.0

数据小陈

结论:Android 的公开无障碍 API 没有提供能“永久锁定全屏放大”的可靠开关。MagnificationController.setMagnificationConfig() 只是向系统请求放大状态,返回 true 仅表示本次请求被接受,并不保证切换到 Launcher 主屏幕后仍然保持。更实际的做法是监听放大变化和窗口变化,等窗口稳定后检查当前 MagnificationConfig,只在确认被重置时延迟恢复,并做好去重和退避,避免反复闪烁。

为什么会重置

主屏幕通常由 Launcher 窗口承载。切换到主屏幕时,系统可能根据窗口或显示状态重新计算放大状态,把你设置的 1.5 恢复为默认的 1.0。你在检测到重置后立即恢复一次,API 返回 true,但系统随后完成窗口切换并再次覆盖,所以表现为“短暂放大后又恢复”。

这不是 AccessibilityService 断开,也不一定是你 XML 配置漏了 canControlMagnification="true"。该属性是控制放大的必要条件,但不能保证跨任意窗口永久保持。

推荐处理方式

  1. 保留 android:canControlMagnification="true"。
  2. 监听 MagnificationController 的放大变化,同时监听 TYPE_WINDOW_STATE_CHANGED 和 TYPE_WINDOWS_CHANGED。
  3. 不要在收到回调时立刻同步调用 setMagnificationConfig()。先延迟 200~300 ms,等窗口切换稳定后再检查。
  4. 检查当前 MagnificationConfig 是否已经是全屏模式、isActivated 为 true、scale 接近目标值;如果已经是,不要重复设置。
  5. 用一个 applying 标志忽略自己调用触发的回调,用 pendingRestore 去重,避免死循环。
  6. 连续失败时做退避,不要无间隔重试。

示例代码(按 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,判断是系统覆盖还是自己的恢复逻辑造成循环。

备注:内容仅供参考。