基于 AScript 安卓引擎的自动化脚本,自动观看汽水音乐广告以获取免费听歌时长。
本项目改造自 wei6718189/qishuiAScriptProject(iOS 版)
原项目是 iOS 专用脚本,依赖 WebDriverAgent +
ascript.ios.*。 本项目在其基础上完成 Android 平台适配,改写为ascript.android.*, 原 iOS 代码完整保留在__init___ios_backup.py。感谢原作者 @wei6718189 的开源工作。
启动 App → 跳开屏广告 → 清弹窗 → 回到首页
↓
自动点右上角「免」字 → 进入广告
↓
┌──────────────────────────────────┐
│ 等广告倒计时结束(最长 60s) │
│ ↓ │
│ 点右上角「领取成功」 │
│ ↓ │
│ 弹窗点「领取奖励」→ 自动进下一轮 │
│ ↓ │
│ 成功次数 +1,重复循环 │
│ │
│ 连续 10 轮没领到 → 自动退出 │
└──────────────────────────────────┘
- 平台:Android(实测 vivo V2055A / Android 14 / 1080×2400)
- AScript App:4.0.17+,运行模式「无障碍模式」
- 必需权限:辅助功能(无障碍)、录屏授权、悬浮窗
- OCR 引擎:paddle(百度 PP-OCR V5,默认)或 mlkit(谷歌,更快)
qishuiAScriptProject/
├── __init__.py # 安卓版主入口(AScript 工程约定,必须叫这个名字)
├── __init___ios_backup.py # 原 iOS 版脚本备份
├── res/img/ # 图标与模板图(安卓版基本用不到)
├── .vscode/settings.json # 平台 / 设备地址 / Python 路径
└── .trae/rules/ascript.md # AScript AI 编码规则
- 装 AScript App,开启无障碍权限
- 进 App 的「开发者」页,开启设备服务(默认端口 9096)
- 记下手机局域网 IP,如
192.168.1.100
- 装 VS Code + AScript 插件
- 确认
uvx --version可用 - 把手机 IP 填进
.vscode/settings.json的ascript.deviceId - 手机和电脑连同一个 WiFi
.vscode/settings.json里的192.168.1.100:9096是占位示例,请换成你自己手机的 IP 和端口。
在 VS Code 里用 AScript 插件运行工程,或让 AI 调用 run_project。
脚本本身已经是全自动的(AUTO_CLICK_MIAN = True),启动后不用管。要彻底脱离电脑,按下面三步做。
- 手机打开 AScript App
- 进「工程管理」→ 找到
qishuiAScriptProject - 点 运行
工程已经上传到手机了,不需要电脑参与。运行后手机会自己点「免」字、看广告、领奖励,一直循环到当日额度用完(连续 10 轮没领到就自动退出)。
这几个设置不做,跑几分钟就会被系统掐掉:
| 设置项 | 路径(vivo 为例) | 作用 |
|---|---|---|
| 电池优化白名单 | 设置 → 电池 → 后台耗电管理 → AScript → 允许后台高耗电 | 防止后台被杀 |
| 自启动 | 设置 → 应用管理 → AScript → 权限 → 自启动 | 允许后台存活 |
| 保持唤醒 | 开发者选项 → 不锁定屏幕(充电时) | 双保险 |
脚本内部已经调了 Device.keep_screen_on(),会保持屏幕常亮;每轮开始还会 Device.wake_up() 唤醒,所以息屏也能恢复。
想更彻底、连 AScript App 都不用开:
- AScript App → 首页找到「打包独立程序」
- 选择
qishuiAScriptProject工程 - 生成 APK 并安装
打包后的 App 可以设桌面图标直接点、配合系统自启动实现开机跑。
AScript 没有内置定时任务,用手机系统自带的能力:
- vivo:设置 → 快捷与辅助 → 自动任务 → 新建(定时启动指定应用)
- 第三方:Tasker / MacroDroid 定时启动 AScript 并运行工程
打开 __init__.py 头部:
| 常量 | 默认 | 说明 |
|---|---|---|
APP_PACKAGE |
com.luna.music |
安卓版汽水音乐包名 |
AUTO_CLICK_MIAN |
True |
是否自动点「免」字(False = 你手动点第一次) |
KEEP_SCREEN_ON |
True |
屏幕常亮,防息屏中断 |
AUTO_RESTART_APP |
True |
连续失败时自动重启 App 恢复 |
MIAN_X_RATIO |
0.937 |
「免」字按钮相对屏幕 X 位置 |
MIAN_Y_RATIO |
0.063 |
「免」字按钮相对屏幕 Y 位置 |
OCR_ENGINE |
"paddle" |
OCR 引擎,识别不准可换 "mlkit" |
LOOP_INTERVAL |
3 |
每轮间隔秒数 |
MAX_LOOP_COUNT |
100 |
最大循环次数(约 40 分钟) |
MAX_IDLE_ROUNDS |
10 |
连续空跑多少轮退出(当日额度用完) |
| 项目 | iOS 版 | 安卓版 |
|---|---|---|
| 模块前缀 | ascript.ios.* |
ascript.android.* |
| 启动 App | app_start(bundle_id=) |
system.open(package) |
| 包名 | com.soda.music |
com.luna.music |
| 控件树 | WDA dump 不稳,走 OCR | 无障碍控件树,Selector 15ms 级 |
| 「免」字定位 | OCR | 坐标(该按钮是图片,无 text 属性) |
| 点击通道 | WDA(易被检测) | 无障碍(不被检测) |
| 屏幕尺寸 | screen_size() |
Device.display() |
- 「免」字是图片按钮:控件树里 87 个节点都没有它,OCR 也识别不出(字体会被识别成乱码)。只能用坐标
(1011, 151)@ 1080×2400,代码里按屏幕比例换算。 - 倒计时文案:
17秒后可领取奖励,位于顶部 y≈40。 - 领取弹窗:显示「再看1个视频得 / 今日免费听」,绿色「领取奖励」按钮在屏幕中央偏下。
- 广告底部有「立即下载」大按钮:绝不能点,会跳到应用商店。代码里所有点击都限定在文字匹配上,不会误触。
- 不要写
if __name__ == "__main__":AScript 工程入口约定不同,主体代码直接写在顶层,末尾main()就是入口。
广告播放到一半会弹窗,两种弹窗的正确操作完全相反,点错就拿不到奖励:
再看05秒继续解锁
第24日免费听
┌─────────────────┐
│ 继续观看 │ ← 绿色主按钮,点这个
└─────────────────┘
坚持退出 ← 灰色小字,别点(放弃奖励)
实测坐标:继续观看 @ (538, 1282) @ 1080×2400
继续互动还是退出?
5 秒后自动进入直播间
- 点「继续互动」→ 进直播间,直播间不算广告时长,白看
- 点「退出」→ 留在广告页,正常拿奖励
代码里的 handle_live_prompt() 专门处理这个:识别到 继续互动 / 继续观看直播 / 进入直播间 / 秒后进入 / 自动进入 / 是否继续 时,只点 退出 / 退出互动 / 不感兴趣 / 取消 / 关闭,绝不点含「继续/进入」的按钮。
代码里的 handle_live_room() 会检测 更多直播 / 说点什么 / 在线观众 等直播间特征,优先点右上角关闭按钮,兜底按返回键。
直播互动弹窗只有 5 秒反应窗口,所以 wait_ad_countdown() 每轮只做一次全屏 OCR(scan_screen_texts()),在内存里按优先级匹配所有条件,而不是反复调用 Ocr.find。实测单次 Ocr.find_all():paddle 约 0.8s,mlkit 约 0.4s。
⚠️ 踩坑:Ocr.find_all()返回的是 dict 列表,而Ocr.paddleocr()返回的是 OcrText 对象,两种要分别处理,否则属性访问会全部拿到空值。
脚本仅用于自动化观看广告领取官方免费权益,请遵守汽水音乐用户协议。每日有领取上限,连续 10 轮领不到会自动退出,不要反复空跑。
- 原项目:wei6718189/qishuiAScriptProject(iOS 版)
- 自动化框架:AScript(Python 移动端自动化引擎)
本项目在其基础上完成安卓平台适配,iOS 原版代码保留在 __init___ios_backup.py。
- 模块从
ascript.ios.*迁移到ascript.android.* - 包名改为安卓版
com.luna.music - 「免」字按钮改用比例坐标定位(实测为图片按钮,无 text 属性)
- 利用无障碍控件树优先查找,OCR 作为兜底
- 新增屏幕常亮、自动唤醒、连续失败自动重启 App
- 新增
AUTO_CLICK_MIAN全自动开关 - 实测环境:vivo V2055A / Android 14 / 1080×2400,连续多轮领取成功