基于 AScript 安卓引擎的自动化脚本:自动点「免」、看互动广告、领奖励,
给小米音乐(com.miui.player)刷「免费听」时长。
- 平台:Android,AScript 4.0.17+(无障碍模式)
- 实测设备:REDMI K80(1440×3200,Android)
- OCR:paddle(百度 PP-OCR V5)
本项目的整体结构源于 wei6718189/qishuiAScriptProject —— 汽水音乐 iOS 版自动化脚本,作者 @wei6718189。
「分阶段拆解 → 关键动作前判定前置条件 → 多次 OCR 只做一次全屏扫描 → 危险按钮前置拦截」 这套骨架,以及广告中途弹窗的正确处理思路,都来自原项目。小米音乐的具体交互 (「免」徽标两种形态、互动广告浏览 10 秒、允许启动弹窗、淘宝吞返回键)是在其基础上重新实现的。
原 iOS 代码未被复制进本仓库,仅作思路参考。感谢原作者的开源工作。
自动化框架:AScript(Python 移动端自动化引擎)。
入口是发现页右上角的「免」徽标,它有两种形态:
| 状态 | 徽标样式 | 点下去 |
|---|---|---|
| 无时长 | 单颗灰边圆徽标 (1320, 232) |
直接进广告 |
| 有时长 | 绿色圆环「免」+ 15:21 胶囊 (1194, 233) |
跳到「免费听」页 |
启动 App → 跳开屏广告 → 清弹窗(含豪华绿钻续费弹窗)
↓
第 1 轮:切「发现」→ 点「免」→(落到广告页或免费听页)
↓
免费听页 → 点「加时长」(失败→任务卡「观看」)→ 广告页
↓
点「点击浏览10秒」→(可能弹「是否允许启动淘宝」→ 点允许)→ 跳淘宝
↓
等 12s → 拉起小米音乐 → 左上角「🎁 恭喜已获得奖励」→ 点右上角 ✕
↓
App 自动回到「免费听」页 → 读顶部倒计时 00:15:35
↓
第 2 轮起:不绕发现页,直接点「加时长」→ 循环
↓
比上一轮多 → 成功 +1;连续 6 轮没收益 → 当日额度用完,退出
- 手机装 AScript App,开无障碍权限;「开发者」页开设备服务(端口 9096)
.vscode/settings.json里把192.168.1.100:9096换成你手机的局域网 IP(端口固定 9096)- VS Code 装 AScript 插件 → 命令面板
AScript: 扫描设备添加设备 →AScript: 选择运行设备 AScript: 在设备上运行当前工程
⚠️ 插件的设备列表存在globalState,不是settings.json。ascript.deviceId只是引用, 设备列表为空时报「未找到 Android 设备」,必须先扫描/手动添加一次。
脱机运行:AScript「工程管理」→ 运行;或「打包独立程序」生成 APK。
__init__.py 头部:
| 常量 | 默认 | 说明 |
|---|---|---|
APP_PACKAGE |
com.miui.player |
包名 |
MAX_LOOP_COUNT |
20 |
最大轮数(约 10~12 分钟) |
MAX_IDLE_ROUNDS |
6 |
连续多少轮没收益退出 |
LOOP_INTERVAL |
2.5 |
每轮间隔 |
AD_TIMEOUT |
80 |
单轮广告最长等待 |
BROWSE_SECONDS |
12 |
点进第三方后停留(广告要求 10s) |
SKIP_AFTER_SEC |
12 |
有「跳过」时至少等多久再点 |
AUTO_BROWSE_AD |
True |
自动点「点击浏览N秒」 |
KEEP_SCREEN_ON |
True |
屏幕常亮 |
AUTO_RESTART_APP |
True |
连续卡住自动重开 |
OCR_ENGINE |
"paddle" |
可换 "mlkit"(更快) |
SELF_TEST |
False |
体检模式:只识别不点广告 |
SELF_TEST_ENTER_AD |
False |
体检时点一次「免」看落地 |
MIAN_X_RATIO / MIAN_Y_RATIO |
0.9167 / 0.0725 |
无时长时「免」坐标 |
NAV_DISCOVER_RATIO |
(0.0986, 0.958) |
底部「发现」兜底 |
AD_CLOSE_RATIO |
(0.9329, 0.0839) |
广告页右上角 ✕ |
VERIFY_BY_FREE_TIME |
True |
广告后在免费听页读倒计时核对 |
| 元素 | 坐标 | 相对位置 |
|---|---|---|
| 「免」·无时长 | (1320, 232) | 0.9167W / 0.0725H |
| 「免」·有时长(圆心) | (1194, 233) | 0.829W / 0.0728H |
| 免费听页「加时长」 | (1217, 489) | 0.845W / 0.153H |
| 广告页「点击浏览10秒」 | (719, 2856) | 0.50W / 0.893H |
| 广告页关闭 ✕ | (1343, 268) | 0.9329W / 0.0839H |
| 底部「发现」/「免费听」 | (142, 3066) / (719, 3067) | 0.0986W / 0.50W,y≈0.958H |
坐标由 864×1920 截图量取后等比换算(系数 1.6667)。换机型按同样方法重测。
有时长时右侧多出 15:21,胶囊右边缘不动,圆心被挤到左边 126px。
脚本不是死点坐标:find_mian_xy() 先读旁边的时长文字,再按 x = time_cx - W×(0.038+0.006×字符数) 反推圆心;
读不到才退回固定坐标。
广告页底部白卡有「点击浏览10秒」,光等不发奖,必须点进去浏览满 10 秒。 点击范围限定在 y 70%~98%(底部白卡),避免误点顶部那句「点击广告浏览10秒可获得奖励」。
不点允许就跳不过去。allow_app_jump() 的处理:
- 只在屏幕出现「允许」时才动作 —— 否则会把免费听页任务卡的「打开"元宝"聊天并浏览1秒」当按钮
- 优先
允许本次启动→仅此一次→始终允许→允许 - 排除
不允许/禁止/拒绝("允许" in "不允许"会误点,必须显式排除)
实测连按 3 次返回都还在 com.taobao.taobao。
所以 return_to_app() 是直接 system.open(APP_PACKAGE) 拉起,返回键只兜底。
播放页会弹「已过期 851 天」+ 绿色按钮「¥1.88立即续费豪华绿钻」,点错真扣钱。
全局 DANGER_WORDS(续费/开通/支付/购买/充值/下载/安装/¥/¥/会员/详情页)+ is_danger(),
所有点击前置过滤,任何路径都点不到它。
这个坑词会命中广告页特征 "点击浏览",把免费听页误判成广告页。
所以 AD_HINTS 不含这个泛词,且 wait_entry_result() 先认免费听页,再认广告页。
system.open() 后 3 秒 get_foreground_app() 可能仍报 com.miui.home。
wait_app() 用 wait_for_package + 前台包名轮询,最多等 12 秒。
不靠文案猜,读数字:
点广告前:00:15:35 → 935 秒
跑完一轮:00:35:35 → 2135 秒
差值 > 0 → 真成功
读不到倒计时(OCR 失败)时才退化为「有奖励提示即成功」,日志会标明。
- 比例坐标按 1440×3200 实测,换分辨率要重测(改
r_*()与*_RATIO) Ocr.find_all()单次约 0.8s(paddle),每轮至少一次全屏 OCR- 不点「去浏览」类限时任务(会拉起「元宝」App,与广告无关)
- 只适配竖屏
- 每日额度由服务端控制,跑完
加时长变灰后脚本会自动退出
- wei6718189/qishuiAScriptProject — 原作者 @wei6718189。本项目的阶段划分、弹窗清理策略、 「一次全屏 OCR + 内存里按优先级匹配」的性能取舍,以及所有点击前做危险词拦截的设计, 都直接来自这份 iOS 版脚本。没有它就没有这个项目。
- AScript — 提供 Python 移动端自动化引擎与 MCP 工具链。
原仓库未声明 LICENSE(无 LICENSE 文件),因此本仓库不套用任何开源许可证, 沿用「保留原作者署名 + 仅供个人学习自用」的方式。 如需商用或再分发,请先联系原作者 @wei6718189 取得授权。
仅用于自动化领取官方提供的免费听权益,请遵守小米音乐用户协议。