更新记录

1.0.0(2025-08-28) 下载此版本

经过 华为、荣耀、小米、oppo、vivo 真机测试,正常运行。需开发人员根据业务自己适配具体功能。


平台兼容性

uni-app(4.76)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
- - × ×
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 快应用-华为 快应用-联盟
× × × × × × × × × × ×

uni-app x(4.76)

Chrome Safari Android iOS 鸿蒙 微信小程序
× × 8.0 × × ×

插件简介

本插件为 Android 平台的 UTS 原生无障碍操作插件,集成多种自动化辅助功能,支持节点查找、点击、滑动、应用管理等操作,适用于需要自动化或辅助功能的场景。

权限说明

无需额外权限,仅需用户手动开启系统无障碍服务。

快速开始

在需要使用的页面引入插件:

import * as accessibility from "@/uni_modules/laoqianjunzi-accessibility"

主要功能及示例

检查无障碍服务是否已开启

const enabled = accessibility.isAccessibilityServiceEnabled()
console.log("无障碍服务是否开启:", enabled)

打开系统无障碍设置页面

accessibility.openAccessibilitySettings()

启动指定应用到前台

const success = accessibility.startAppToForeground("com.android.settings")

启动指定包名的应用

accessibility.launchApp("com.android.settings")

关闭指定包名的应用

accessibility.closeApplication("com.android.settings")

获取当前窗口节点树结构

const nodeTree = accessibility.getCurrentNodeTree()
console.log(nodeTree)

查找包含指定文本的节点

const hasNode = accessibility.hasNodeWithText("设置")

点击包含指定文本的节点

const clicked = accessibility.clickNodeByText("设置")

在指定坐标执行点击操作

const result = accessibility.clickAtCoordinates(100, 200)

获取开关控件状态

const switchStatus = accessibility.getSwitchStatus("Wi-Fi", "text")

获取复选框控件状态

const checkBoxStatus = accessibility.getCheckBoxStatus("自动同步", "text")

设置复选框控件状态

const setResult = accessibility.setCheckBoxStatus("自动同步", true)

执行全屏滑动操作

accessibility.performScreenSwipe()

返回桌面

accessibility.navigateToHome()

返回上一级页面

accessibility.navigateBack()

购买与支持

建议先试用插件,确认功能满足需求后再购买。如遇问题请联系作者,提供技术支持与协助。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

<!-- 声明绑定无障碍服务的权限,必须用于 AccessibilityService --> <uses-permission android:name="android.permission.BIND_ACCESSIBILITY_SERVICE" /> <!-- 允许使用全屏意图,部分通知场景需要 --> <uses-permission android:name="android.permission.USE_FULL_SCREEN_INTENT" /> <!-- 允许应用在后台唤醒设备或保持设备唤醒 --> <uses-permission android:name="android.permission.WAKE_LOCK" /> <!-- 允许重新排序任务栈中的 Activity --> <uses-permission android:name="android.permission.REORDER_TASKS" /> <!-- 获取当前和最近运行的任务信息(Android 5.0 后已废弃,仅部分场景可用) --> <uses-permission android:name="android.permission.GET_TASKS" /> <!-- 允许应用创建系统级悬浮窗(如辅助功能浮窗) --> <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" /> <!-- 允许应用创建系统覆盖窗口(部分设备支持) --> <uses-permission android:name="android.permission.SYSTEM_OVERLAY_WINDOW" /> <!-- 允许应用在前台运行服务,提升服务存活率 --> <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

暂无用户评论。