1. 每个API都配有中文、英文两种使用方法，开发者可根据自己喜好随意选择
2. 每个API都配备了详细的开发文档以及视频形式的讲解，以确保开发者可以完全学会使用
3. 除插件的开发文档外，我们集成了常用工具、公开课、AS-FAQ等多项功能，让开发者从此告别东拼西凑 文档地址：https://www.yuque.com/xianle-skqwj/ld

升级日志：

1.2.4

• 优化链式编程语法提示。
• 修改部分函数参数声明。

1.2.3

• 优化链式编程语法提示。

1.2.2

• 将element和utils注册到ld.android中，现可以通过 from ld.android import *直接引用。
• 修复了旧版本 compare_color 方法的参数处理问题，当前与1.1.9版本处理方式保持一致。
• 修复了ImageQuery中img方法无法查找项目res/img/目录下图片的问题，当前与1.1.9版本处理方式保持一致。
• 修复了旧版本Ocr和Image中的参数和部分方法。
• 优化了链式编程时的语法提示。

1.2.1

本次升级以 1.1.9 为基线进行全面扩充，新增能力覆盖动作、图色、文字、节点、设备、系统、界面、通讯、感知等多个领域，中英文两套 API 同步提供。以下仅列举新增的功能点名称，具体用法请查阅官方文档。

一、框架与链式调用

• 中文入口独立
• 特征库可选初始化
• 元素未命中兜底
• 链式动作策略注册
• 链式历史结果引用
• 链式断言元素
• 链式执行方法
• 全部能力支持链式调用

二、动作与手势

• 滑动_v2
• 触摸按下
• 触摸移动
• 触摸抬起
• 执行路径
• 捕获点击
• 按键Home
• 按键返回
• 按键通知
• 按键任务栏
• 按键截屏
• 按键锁屏

三、输入法

• 输入法_是否可用
• 输入法_输入
• 输入法_清空
• 输入法_发送按键

四、屏幕与位图

• 屏幕_截图
• 屏幕_取色
• 屏幕_取色_全部
• 屏幕_区域内色点数量
• 屏幕_位图存文件
• 屏幕_文件读位图
• 屏幕_位图转Base64
• 屏幕_Base64转位图
• 屏幕_位图缩放
• 屏幕_位图转PIL
• 屏幕_位图转CV
• 屏幕_CV转位图
• 屏幕_横竖屏监听

五、图像识别

• 图像识别_找图
• 图像识别_找图_全部
• 图像识别_找图_模板
• 图像识别_找图_模板_全部
• 图像识别_找图_SIFT
• 图像识别_找图_SIFT_全部
• 二维码_扫描
• 边缘检测

六、图像预处理

• 图像预处理_灰度化
• 图像预处理_二值化
• 图像预处理_自适应二值化
• 图像预处理_腐蚀
• 图像预处理_膨胀
• 图像预处理_形态学运算
• 图像预处理_高斯模糊
• 图像预处理_缩放
• 图像预处理_旋转

七、颜色识别

• 找色
• 找色_全部
• 找单色
• 找单色_全部
• 找色_数量
• 比色_v2
• 多组比色
• 等待_比色成功
• 颜色_创建_十六进制
• 颜色_创建_RGB
• 颜色_距离
• 颜色_是否相似

八、文字识别

• 文字识别_设置_引擎
• 文字识别_查找
• 文字识别_查找_全部
• 文字识别_是否存在
• 文字识别_点击
• 文字识别_等待
• 文字识别_等待_点击
• 文字识别_百度OCR
• 文字识别_百度OCR_V2
• 文字识别_百度OCR_V3
• 文字识别_谷歌OCR_V2
• 文字识别_点阵识别
• 文字识别_点阵识别_全部

九、节点特征与节点动作

• 节点特征：资源ID、文本、类型、描述、提示文本、包名、路径
• 节点信息：子节点数量、输入类型、绘制顺序、深度、最大文本长度
• 节点状态：可点击、可勾选、已勾选、可编辑、可启用、可关闭、可聚焦、已聚焦、可见、可长按
• 节点关系：父节点、子节点、兄弟节点
• 节点动作：点击、长按、滑动、滑动_方向、输入

十、元素特征扩展

• 找图特征：SIFT、彩色、源图、方向、缩放范围、图像
• 找色特征：模式、超时、图像
• 找字特征：位图、文件
• 元素特征全面提供中文写法

十一、设备信息

• 处理器架构
• 处理器架构列表
• 状态栏高度
• 本机手机号
• 是否充电中
• 屏幕是否亮着
• 唤醒屏幕
• 保持屏幕常亮
• 取消屏幕常亮
• 设备信息全面提供属性式中文写法

十二、系统能力

• 关闭
• 重启
• 启动应用
• 打开网页
• 打开应用设置页
• 关闭应用
• 获取当前运行APP
• 获取应用名称
• 等待应用出现
• 获取内存信息
• 获取外部存储信息
• 获取内部存储信息
• 获取导航栏模式
• 执行Shell指令
• Shizuku执行Shell指令

十三、剪贴板、键值存储与权限

• 剪贴板：存入、读取、清空
• 键值存储：保存、获取、移除
• 权限：是否有、是否已授权、申请、确保、列出全部
• 资源路径：相对路径、SD卡目录、工程目录、资源目录、图片目录、UI目录
• 选择文件

十四、弹窗与界面

• 弹窗_吐司
• 弹窗_消息提示
• 弹窗_消息确认
• 弹窗_文本输入
• 弹窗_列表选择
• 图片展示
• 悬浮窗_显示
• 悬浮窗_隐藏
• 悬浮窗_添加按钮

十五、屏幕画布

• 显示、关闭、清空、移除
• 画矩形、画圆、画椭圆、画线、画点、画十字、画箭头、画文字、画区域、画多边形

十六、日志窗口与网页窗口

• 日志窗口：显示、关闭、消息通道、获取消息通道
• 网页窗口：显示、关闭、监听、消息通道、模式、尺寸、背景、拖拽、遮罩、引力、页面回退、页面前进、调用JS

十七、多媒体

• 设置音量
• 获取音量
• 获取最大音量
• 设置亮度
• 获取亮度
• 震动
• 取消震动
• 播放音频
• 录音
• 开始录音
• 结束录音
• 语音朗读
• 保存到相册
• 发送邮件

十八、短信

• 短信_是否有权限
• 短信_申请权限
• 短信_获取第一条
• 短信_获取收件箱第一条
• 短信_获取已发送第一条
• 短信_获取最近
• 短信_获取收件箱最近
• 短信_按号码获取
• 短信_查询
• 短信_获取范围
• 短信_诊断信息

十九、定位

• 定位_监听GPS位置刷新
• 定位_关闭GPS监听
• 定位_获取最后一次位置
• 定位_模拟_启动
• 定位_模拟_停止
• 定位_模拟_查看状态

二十、事件监听

• 事件_按键监听
• 事件_按键停止
• 事件_触摸监听
• 事件_触摸停止
• 事件_通知监听
• 事件_通知停止
• 事件_点击通知

二十一、传感器

• 传感器_加速度监听、传感器_加速度停止
• 传感器_陀螺仪监听、传感器_陀螺仪停止
• 传感器_光线监听、传感器_光线停止
• 传感器_接近监听、传感器_接近停止
• 传感器_GPS监听、传感器_GPS停止

二十二、常量库

• 按键码
• 输入法按键码
• OCR引擎
• 颜色模式
• 找色方向
• 位图像素格式
• 图像预处理标志
• 边缘检测模式
• 边缘检测绘制模式
• 引力
• 滑动插值器
• 坐标系
• 媒体类型
• 短信类型
• 权限类型
• 权限结果
• 传感器采样速率
• 陀螺仪采样速率
• 按键事件
• 触摸动作
• 关闭模式

二十三、工具库

• 路径对象
• 工具类方法命名统一
• 工具类中文别名统一

升级方法

1. AS 当中引用插件版本更新为 1.2.1
2. 通过 pip 升级提示包插件至最新版本

1.1.9

• 统一点击函数名称
• 修复获取_全部元素查找失败返回None问题
• 新增获取_设备版本方法
• 新增循环执行方法函数
• 修复重复使用查询全部元素可能失败问题
• 修复链式操作等待失效的问题
• 增加点击函数持续时间参数
• 修复在循环中链式操作逻辑错误问题

1.1.8

• 新增谷歌OCR识别，该函数是调用官网的谷歌OCR，可能程序会崩溃

elements = {
    "任务": {
        "OCR_Mlkit": OcrQuery().mlkitocr_v2().text("系统应用").rect_center()
    }
}
ld.元素_操作("任务1", "OCR_Mlkit").点击_坐标().执行()

# 此外也可以直接识别屏幕某个区域文字
print(ld.文字识别_MlkitV2([85, 1088, 250, 1142]))

• 点击、滑动相关函数支持百分比坐标

# 直接使用如下
ld.滑动(["50%", "40%"], ["50%", "60%"])

ld.点击_坐标("50%", "50%")

# 也可以在链式中使用，滑动一样，这里不再过多演示
ld.元素_操作("任务1", "找图_游戏中心").点击_坐标("50%", "50%").随机_延迟(2).执行()

1.1.7

• 修复元素_等待函数失效问题

1.1.6

• 新增找图/找色/找字支持屏幕区域，以下以找图为例：

elements = {
    "任务1": {
        "找图_游戏中心": ImageQuery().find().img("yxzx.png").rect_center()
    },
}
# 以上的rect_center()代表找屏幕中心位置，除此之外还支持
# rect_left_top() - 获取右上角范围
# rect_left_top() - 获取左上角范围
# rect_left_bottom() - 获取左下角范围
# rect_right_bottom() - 获取右下角范围
# rect_half_left() - 获取左半屏范围
# rect_half_right() - 获取右半屏范围
# rect_half_top() - 获取上半屏范围
# rect_half_bottom() - 获取下半屏范围

1.1.5

• 新增统计运行时间日志

# 只需要设置系统日志级别即可
ld.日志_设置级别(LogLevel.INFO)

• 新增随机延迟函数

 ld.随机_延迟(second, float_tame)

• 新增设备相关函数

ld.获取_设备ID()
ld.获取_设备名称()
ld.获取_设备屏幕信息()
ld.获取_设备品牌()
ld.获取_设备型号()
ld.获取_设备SDK()
ld.获取_设备IP()
ld.获取_当前运行APP信息()
ld.获取_所有安装APP()
ld.获取_当前电量()
ld.获取_设备内存()

1.1.4

• 新增找图函数可以增加多图片

elements = {
    "测试任务": {
        "多图测试": ImageQuery().find_template().img("小工具-谷歌安装器.png", "小工具-RE文件管理器.png",
                                                     "小工具-主题装扮.png"),
    }
}

• 新增字符串函数可以统计字符出现个数

print(文本.字符出现次数("abcabcabc", "ab"))

升级方法

1.AS当中引用代码为：

plug.load("ld:1.1.4")

2.更新提示包插件：

pip install --upgrade ld-as-framework