Metadata-Version: 2.4
Name: ld-as-framework
Version: 1.2.3
Summary: 零动AS插件提示包
Author-email: 零动学院 <1132454419@qq.com>
Project-URL: Homepage, https://www.yuque.com/xianle-skqwj/ld
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: ascript-tip
Dynamic: license-file

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


# 升级日志：

## 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，可能程序会崩溃
```python
elements = {
    "任务": {
        "OCR_Mlkit": OcrQuery().mlkitocr_v2().text("系统应用").rect_center()
    }
}
ld.元素_操作("任务1", "OCR_Mlkit").点击_坐标().执行()

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

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

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

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

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

## 1.1.7
- 修复`元素_等待`函数失效问题

## 1.1.6
- 新增找图/找色/找字支持屏幕区域，以下以找图为例：
```python
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
- 新增统计运行时间日志
```python
# 只需要设置系统日志级别即可
ld.日志_设置级别(LogLevel.INFO)
```
- 新增随机延迟函数
```python
 ld.随机_延迟(second, float_tame)
```
- 新增设备相关函数
```python
ld.获取_设备ID()
ld.获取_设备名称()
ld.获取_设备屏幕信息()
ld.获取_设备品牌()
ld.获取_设备型号()
ld.获取_设备SDK()
ld.获取_设备IP()
ld.获取_当前运行APP信息()
ld.获取_所有安装APP()
ld.获取_当前电量()
ld.获取_设备内存()
```

## 1.1.4
- 新增找图函数可以增加多图片
```python
elements = {
    "测试任务": {
        "多图测试": ImageQuery().find_template().img("小工具-谷歌安装器.png", "小工具-RE文件管理器.png",
                                                     "小工具-主题装扮.png"),
    }
}
```


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

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

### 升级方法
1.AS当中引用代码为：

```python
plug.load("ld:1.1.4")
```
2.更新提示包插件：

```bash
pip install --upgrade ld-as-framework
```
