# autoclick2

**Repository Path**: Ethan-Bai/autoclick2

## Basic Information

- **Project Name**: autoclick2
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-13
- **Last Updated**: 2025-10-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

自动点击（连点器）功能实现文档
一、功能概述
自动点击（连点器）功能，依托 Android 系统的无障碍服务（AccessibilityService）与悬浮窗（System Alert Window）权限，实现对用户触摸点击操作的模拟。该功能可应用于需要重复点击的场景，例如游戏中重复点击某个位置、应用内重复提交操作等，但需特别注意使用场景的合规性，避免违反相关应用的用户协议。
二、核心技术原理
（一）无障碍服务（AccessibilityService）
Android 系统为辅助功能（如自动点击、屏幕朗读等）提供的专用服务。它具备监听界面元素变化的能力，还能模拟用户的触摸、点击等手势操作，是实现自动点击功能的核心技术支撑，通过它可以执行特定的手势来模拟点击行为。
（二）悬浮窗（System Alert Window）
这是 Android 系统提供的一种窗口类型，允许应用的界面元素（如按钮、控制面板等）悬浮在其他应用的界面上方。对于连点器功能而言，悬浮窗可承载 “启动 / 停止” 等控制按钮，让用户在不切换应用的情况下，便捷地操作连点功能，极大提升了交互的便捷性。
三、详细实现步骤
（一）权限与服务声明（AndroidManifest.xml 配置）
在项目的 AndroidManifest.xml 文件中，进行以下关键配置：
悬浮窗权限声明：添加 <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" /> ，向系统声明应用需要悬浮窗权限。
无障碍服务注册：通过 <service> 标签注册自定义的无障碍服务类（如 AutoClickService），并配置相关的 intent-filter 和 meta-data，其中 meta-data 用于指定无障碍服务的配置文件路径。
（二）无障碍服务配置（accessibility_service_config.xml 配置）
在 res/xml/ 目录下创建 accessibility_service_config.xml 文件，对无障碍服务的行为和权限进行详细配置：
事件监听范围：通过 android:accessibilityEventTypes 设置监听的事件类型，如 typeAllMask 表示监听所有类型的事件。
生效应用范围：利用 android:packageNames 指定服务生效的应用包名，若设为 * 则对所有应用生效。
功能权限：配置 android:canPerformGestures="true"，允许服务执行手势操作，这是模拟点击的关键权限；还可根据需求配置是否允许获取窗口内容等权限。
（三）无障碍服务实现（继承 AccessibilityService 类）
创建自定义的无障碍服务类（如 AutoClickService），继承 AccessibilityService 并实现核心逻辑：
状态管理：定义布尔变量（如 isRunning）标记连点是否正在运行。
点击逻辑定义：使用 Handler 和 Runnable 来实现定时点击逻辑，在 Runnable 中通过 dispatchGesture 方法模拟点击手势，可设置点击的坐标和间隔时间。
生命周期方法重写：重写 onAccessibilityEvent（处理界面事件）、onInterrupt（服务中断时的回调，用于停止连点）等方法，确保服务的正常运行和资源管理。
（四）悬浮窗控制界面创建
构建悬浮窗控制界面（如 FloatWindow 类）：
窗口参数配置：获取 WindowManager 服务，配置悬浮窗的布局参数，包括窗口类型（针对不同 Android 版本选择合适的类型）、标志（如 FLAG_NOT_FOCUSABLE 表示不获取焦点）、重力和初始坐标等。
交互按钮实现：创建 “启动 / 停止” 按钮，为按钮设置点击事件监听器，在监听器中与无障碍服务交互，根据连点的运行状态，调用无障碍服务的启动或停止连点方法，并更新按钮文字。
（五）权限申请与启动逻辑（主界面实现）
在主界面（如 MainActivity）中：
悬浮窗权限申请：对于 Android 6.0 及以上版本，通过 Settings.canDrawOverlays() 判断是否拥有悬浮窗权限，若没有则通过 Intent 跳转到悬浮窗权限设置页面（Settings.ACTION_MANAGE_OVERLAY_PERMISSION），申请权限。
无障碍服务引导：提供按钮，点击后通过 Intent 跳转到系统无障碍设置页面（Settings.ACTION_ACCESSIBILITY_SETTINGS），引导用户开启应用的无障碍服务。
悬浮窗管理：在获取到无障碍服务实例和悬浮窗权限后，初始化并显示悬浮窗；在界面销毁时，移除悬浮窗，释放资源。
四、关键说明
（一）无障碍服务开启
无障碍服务无法由应用自动开启，必须由用户手动操作。用户需进入系统 “设置 -> 无障碍”，找到对应应用的无障碍服务并开启，所以应用需要在界面中提供清晰的引导，方便用户完成操作。
（二）悬浮窗权限
Android 6.0 及以上版本，悬浮窗权限需要动态申请。通过 Settings.canDrawOverlays() 方法判断权限状态，若未获取权限，使用 Settings.ACTION_MANAGE_OVERLAY_PERMISSION 跳转到系统的悬浮窗权限授权页面，由用户进行授权。
（三）坐标动态化
在实际应用场景中，点击坐标通常需要支持 “手动选择” 功能（如通过悬浮窗触发 “拾取坐标” 操作）。这需要额外结合触摸事件监听来实现，例如在屏幕上监听用户的触摸操作，获取触摸点的坐标并用于后续的连点操作。