开启watcher监听

开启watcher监听 用于在自动化流程运行期间开启后台监听（watcher），自动识别并处理过程中弹出的干扰元素（如系统弹窗、授权提示、广告浮层等）。开启后无需在每个步骤手动处理这些弹窗，监听会在背景里按规则点掉它们，保证主流程顺畅执行。

指令标识：MobileWatcherTask
指令类型：手机指令
指令描述：开启 watcher 监听（自动处理弹窗等）

先选使用方式

工作流支持「可视化编排」和「代码编排」两种创建方式。开启watcher监听 在两种方式里都能用，核心业务参数一致，区别主要是你通过界面配置，还是通过 Python 脚本配置。

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「开启watcher监听」节点，填写要自动点击的按钮名称	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 `bots.mobileWatcherTask(watcherParams='["允许","同意"]')`	熟悉代码、需要复用脚本或批量生成流程的用户

第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。下方「参数说明」同时给出界面字段和代码参数名，方便两种方式对应。

什么时候用？

流程运行中会随机弹出系统弹窗、授权提示，干扰自动化操作。
希望统一在背景里自动点掉「允许」「同意」「我知道了」等按钮。
长流程需要持续抵御不定时出现的浮层，减少失败率。

使用前确认

当前流程已经连接并占用了一台可用的手机设备。
已整理出需要自动处理的弹窗按钮文案（如「允许」「同意」）。
计划在流程结束或不再需要时调用停止watcher监听关闭监听。

可视化编排：从 0 到跑通

下面用一个常见场景演示：在自动化开始前开启监听，自动点掉权限弹窗。按 4 步即可跑起来：

在工作流画布中添加 开启watcher监听 指令，通常放在主流程开始之前。
在右侧配置面板的 需要监控点击的按钮名称 中填写要自动点击的弹窗按钮列表（如「允许」「同意」）。
编排后续主流程操作。
在流程末尾添加停止watcher监听节点关闭监听。

【图片占位 | command-mobilewatchertask-config】
截图内容建议： 截一张可视化编排页面，画布中「开启watcher监听」节点位于主流程开头，右侧属性面板展示「按钮文案」列表区域。
标注建议： 用 ① 标出「开启watcher监听」节点，用 ② 标出「需要监控点击的按钮名称」配置区，用 ③ 标出末尾的「停止watcher监听」节点。
用户看完应能明白： 需要填写按钮名称，监听需要和「停止watcher监听」配合使用。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
需要监控点击的按钮名称	`watcherParams`	String	是	-	需要监听并自动点击的弹窗按钮名称，多个按钮可用 JSON 数组字符串表示，如 `["允许", "同意", "我知道了"]`。

输出参数

该指令无输出参数。监听在后台持续生效，直到执行停止watcher监听。

成功标准

开启watcher监听 节点运行结束后状态为成功。
运行日志中没有参数缺失、超时或执行失败等错误。
后续节点能够继续执行，流程没有因为该节点异常中断。

失败排查

现象 / 报错原文	可能原因	处理建议
日志报 `Mobile device not configured`	流程未连接设备	先执行连接/占用设备节点，或在全局变量中配置设备上下文
日志报 `Mobile API ... business error`	移动端服务异常或设备失联	检查设备在线状态与移动端服务连通性，重连设备后重试
弹窗没有被自动点掉	按钮名称未覆盖	在 `watcherParams` 中补充实际弹窗按钮名称（注意与界面文字一致）
监听一直生效影响后续	未停止监听	在流程结束处添加停止watcher监听

Python 代码编排

代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。

# 开启 watcher 监听，指定要自动点击的按钮名称
bots.mobileWatcherTask(watcherParams='["允许", "同意", "我知道了"]')

# ... 编排主流程操作 ...

# 流程结束时停止监听
bots.mobileStopWatcher()

可视化表单里的「需要监控点击的按钮名称」对应代码里的 watcherParams。

如果你想在工作流中通过节点动态编排指令，可使用执行指令（XML）节点。

常见问题

Q1：监听会一直运行吗？

A：开启后会在后台持续生效，直到执行停止watcher监听或流程结束。建议成对使用，避免影响后续流程。

Q2：按钮文案必须填吗？

A：必填。watcherParams 用于指定需要监听并自动点击的弹窗按钮名称，多个按钮可用 JSON 数组字符串表示，如 ["允许", "同意", "我知道了"]。请尽量与界面实际文字保持一致，以提高命中率。