Android无障碍服务实战：用dispatchGesture实现自动化手势操作（附完整代码）

最新推荐文章于 2026-06-22 12:05:28 发布

原创

最新推荐文章于 2026-06-22 12:05:28 发布 · 549 阅读

Android无障碍服务深度实战：从dispatchGesture到自动化手势的进阶之路

如果你曾经尝试过为Android应用编写自动化测试脚本，或者开发过辅助功能应用，那么你一定对AccessibilityService这个强大的系统服务不陌生。但你是否真正深入探索过它的手势模拟能力？今天，我们就来聊聊dispatchGesture这个在Android 7.0（API 24）中引入的关键方法，以及如何在实际项目中高效地使用它。

我最初接触dispatchGesture是在一个自动化测试项目中，当时需要模拟用户在屏幕上的复杂手势操作。传统的performAction方法在某些场景下显得力不从心，特别是当需要精确控制触摸轨迹时。经过多次尝试和调试，我发现dispatchGesture不仅能够模拟点击、滑动等基础操作，还能实现更复杂的连续手势，这为自动化测试和辅助功能开发打开了新的可能性。

1. 理解Android无障碍服务与手势模拟的核心机制

在深入代码之前，我们需要先理解AccessibilityService在整个Android系统中的位置。无障碍服务运行在系统级别，能够监听用户的交互事件，并代表用户执行操作。这种设计初衷是为了帮助残障人士更好地使用设备，但开发者们很快发现了它在自动化测试和辅助工具中的巨大潜力。

1.1 手势模拟的底层原理

当你调用dispatchGesture时，实际上触发了一系列复杂的系统级操作。让我们看看这个过程的简化流程：

// 手势分发的核心调用链
AccessibilityService.dispatchGesture()
    ↓
IAccessibilityServiceConnection.dispatchGesture()
    ↓
AccessibilityServiceConnection.dispatchGesture()
    ↓
MotionEventInjector.injectEvents()
    ↓
Native层输入事件注入

这个过程涉及到多个系统组件，包括AccessibilityInteractionClient、AccessibilityServiceConnection和MotionEventInjector。其中最关键的是MotionEventInjector，它负责将手势描述转换为实际的MotionEvent事件，并注入到系统的输入事件流中。

注意：手势注入的优先级很高，当你的服务分发手势时，系统会取消当前正在进行的所有手势（包括用户的实际触摸操作）。这是设计上的一个重要考虑，避免多个输入源同时操作导致的冲突。

1.2 权限与配置要求

要使用手势模拟功能，首先需要在服务配置中明确声明。这是很多开发者容易忽略的一步：

<!-- res/xml/accessibility_service_config.xml -->
<accessibility-service xmlns:android="http://schemas.android.com/apk/res/android"
    android:description="@string/accessibility_service_description"
    android:accessibilityFeedbackType="feedbackAllMask"
    android:canRetrieveWindowContent="true"
    android:canPerformGestures="true"
    android:notificationTimeout="100"
    android:accessibilityFlags="flagDefault" />

关键属性android:canPerformGestures必须设置为true，否则dispatchGesture调用会失败。同时，还需要在AndroidManifest.xml中声明相应的权限：

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

2. dispatchGesture的实战应用：从基础到高级

2.1 基础手势实现

让我们从一个最简单的点击手势开始。假设我们需要在屏幕中心位置执行一次点击：

class MyAccessibilityService : AccessibilityService() {
    
    fun performClick(x: Int, y: Int) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
            val path = Path().apply {
                moveTo(x.toFloat(), y.toFloat())
                // 对于点击，只需要moveTo，不需要lineTo
            }
            
            val stroke = StrokeDescription(path, 0, 50) // 持续50毫秒
            val gesture = GestureDescription.Builder()
                .addStroke(stroke)
                .build()
            
            dispatchGesture(gesture, object : GestureResultCallback() {
                override fun onCompleted(gestureDescription: GestureDescription?) {
                    Log.d("Gesture", "点击完成")
                }
                
                override fun onCancelled(gestureDescription: GestureDescription?) {
                    Log.w("Gesture", "点击被取消")
                }
            }, null)
        }
    }
}

这里有几个关键点需要注意：

路径定义：对于点击操作，只需要moveTo到目标位置，不需要lineTo
持续时间：StrokeDescription的第三个参数是手势持续时间，对于点击来说，50-100毫秒是比较合适的值
回调处理：通过GestureResultCallback可以知道手势是否成功执行

2.2 滑动与复杂手势

滑动操作需要定义起点和终点：

fun performSwipe(startX: Int, startY: Int, endX: Int, endY: Int, duration: Long = 500) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
        val path = Path().apply {
            moveTo(startX.toFloat(), startY.toFloat())
            lineTo(endX.toFloat(), endY.toFloat())
        }
        
        val stroke = StrokeDescription(path, 0, duration)
        val gesture = GestureDescription.Builder()
            .addStroke(stroke)
            .buil

标签