Android无障碍服务实现截图遇rootNode为空问题求助

核心原因分析 #

rootInActiveWindow返回null通常源于以下几点：

• 无障碍服务未正确配置（未开启canRetrieveWindowContent权限）
• 服务启动后未等待系统发送有效窗口事件
• 使用lateinit强制赋值空对象，引发潜在崩溃
• 定时截图逻辑未绑定正确的触发时机

分步解决方案 #

1. 修正无障碍服务配置 #

确保AndroidManifest和配置xml中开启窗口内容获取权限：

AndroidManifest.xml

<service
    android:name=".ScreenshotService"
    android:permission="android.permission.BIND_ACCESSIBILITY_SERVICE">
    <intent-filter>
        <action android:name="android.accessibilityservice.AccessibilityService" />
    </intent-filter>
    <meta-data
        android:name="android.accessibilityservice"
        android:resource="@xml/accessibility_service_config" />
</service>

res/xml/accessibility_service_config.xml

<?xml version="1.0" encoding="utf-8"?>
<accessibility-service xmlns:android="http://schemas.android.com/apk/res/android"
    android:accessibilityEventTypes="typeWindowStateChanged|typeWindowContentChanged"
    android:accessibilityFeedbackType="feedbackAllMask"
    android:accessibilityFlags="flagDefault|flagIncludeNotImportantViews"
    android:canRetrieveWindowContent="true"
    android:description="@string/accessibility_service_desc" />

关键：canRetrieveWindowContent必须设为true，否则无法获取窗口节点信息

2. 重构代码避免空指针与内存泄漏 #

将lateinit改为可空类型，增加空判断，同时回收节点避免内存泄漏：

class ScreenshotService : AccessibilityService() {

    private var rootNode: AccessibilityNodeInfo? = null
    private val handler = Handler(Looper.getMainLooper())
    private val screenshotTask = object : Runnable {
        override fun run() {
            captureScreen()
            handler.postDelayed(this, 10000) // 10秒间隔截图
        }
    }

    override fun onServiceConnected() {
        super.onServiceConnected()
        // 启动定时截图任务
        handler.post(screenshotTask)
    }

    override fun onAccessibilityEvent(event: AccessibilityEvent?) {
        event ?: return
        // 仅在窗口状态/内容变化时更新root节点
        if (event.eventType == AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED ||
            event.eventType == AccessibilityEvent.TYPE_WINDOW_CONTENT_CHANGED) {
            rootNode?.recycle() // 先回收旧节点
            rootNode = rootInActiveWindow
        }
    }

    private fun captureScreen() {
        val currentRoot = rootNode ?: rootInActiveWindow // 双重兜底获取
        currentRoot ?: run {
            Log.e("ScreenshotService", "无法获取有效窗口节点，跳过截图")
            return
        }

        try {
            // 执行你的截图逻辑，例如：
            val windowBounds = Rect()
            currentRoot.getBoundsInScreen(windowBounds)
            // 基于windowBounds进行截图操作
        } catch (e: Exception) {
            e.printStackTrace()
        } finally {
            currentRoot.recycle() // 必须回收节点
        }
    }

    override fun onInterrupt() {
        handler.removeCallbacks(screenshotTask)
        rootNode?.recycle()
        rootNode = null
    }
}

3. 额外注意事项 #

• 必须在系统设置中手动开启无障碍服务，代码无法自动触发
• 锁屏界面、部分全屏游戏可能限制无障碍服务获取节点，需针对性兼容
• 定时任务必须在主线程执行，rootInActiveWindow仅能在主线程调用

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