停止watcher监听
停止watcher监听 用于关闭由 开启watcher监听 启动的后台监听，停止自动处理弹窗等干扰元素。它与「开启watcher监听」配对使用，通常放在主流程结束或不再需要自动处理弹窗的位置。
指令标识：MobileStopWatcher
指令类型：手机指令
指令描述：停止 watcher 监听
先选使用方式
Section titled “先选使用方式”工作流支持「可视化编排」和「代码编排」两种创建方式。停止watcher监听 在两种方式里都能用，核心业务参数一致，区别主要是你通过界面配置，还是通过 Python 脚本配置。
| 方式 | 怎么用 | 适合人群 |
|---|---|---|
| 可视化编排（推荐先学） | 拖入「停止watcher监听」节点，放在主流程末尾，无需额外参数 | 大多数用户，零代码，适合快速搭建和调试 |
| 代码编排（Python） | 在脚本中调用 bots.mobileStopWatcher() | 熟悉代码、需要复用脚本或批量生成流程的用户 |
第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。
什么时候用？
Section titled “什么时候用？”- 主流程已经结束，不再需要自动处理弹窗。
- 后续操作需要保留弹窗（例如要对弹窗本身做断言），需先关闭监听。
- 避免监听长期运行影响后续流程行为。
- 当前流程已经连接并占用了一台可用的手机设备。
- 之前已经执行过 开启watcher监听。
可视化编排：从 0 到跑通
Section titled “可视化编排：从 0 到跑通”下面用一个常见场景演示：主流程结束后关闭弹窗自动处理。按 3 步即可跑起来：
- 在工作流画布中添加 停止watcher监听 指令，放在主流程末尾。
- 该指令无需配置业务参数，直接保留默认即可。
- 点击运行，确认监听已关闭，后续流程不再自动点掉弹窗。
【图片占位 | command-mobilestopwatcher-config】
截图内容建议： 截一张可视化编排页面，画布中「停止watcher监听」节点位于主流程末尾，右侧属性面板显示无业务参数需要配置。
标注建议： 用 ① 标出「停止watcher监听」节点，用 ② 标出开头对应的「开启watcher监听」节点，用 ③ 标出运行按钮。
用户看完应能明白： 这个指令不需要参数，和「开启watcher监听」成对使用，作为监听的终点。
该指令无业务输入参数，仅依赖已连接的设备上下文。
该指令无输出参数。是否成功建议通过运行日志与后续是否还自动处理弹窗判断。
停止watcher监听节点运行结束后状态为成功。- 运行日志中没有参数缺失、超时或执行失败等错误。
- 后续节点能够继续执行，流程没有因为该节点异常中断。
| 现象 / 报错原文 | 可能原因 | 处理建议 |
|---|---|---|
日志报 Mobile device not configured | 流程未连接设备 | 先执行连接/占用设备节点，或在全局变量中配置设备上下文 |
日志报 Mobile API ... business error | 移动端服务异常或设备失联 | 检查设备在线状态与移动端服务连通性，重连设备后重试 |
| 停止后弹窗仍被处理 | 监听未真正关闭或重复开启 | 确认流程中只开启了一次监听，并在正确位置调用停止 |
Python 代码编排
Section titled “Python 代码编排”代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。
# 开启 watcher 监听bots.mobileWatcherTask()
# ... 编排主流程操作 ...
# 停止 watcher 监听bots.mobileStopWatcher()如果你想在工作流中通过节点动态编排指令，可使用 执行指令（XML）节点。
Q1：没开启监听就停止会报错吗？
Section titled “Q1：没开启监听就停止会报错吗？”A： 通常不会产生副作用。建议始终与 开启watcher监听 成对使用，避免遗漏。
Q2：监听一定要手动停止吗？
Section titled “Q2：监听一定要手动停止吗？”A： 建议在不再需要自动处理弹窗时显式停止，避免监听长期运行影响后续操作（如需要对弹窗本身做断言的场景）。