双击坐标
双击坐标 用于在移动端页面的指定屏幕坐标上模拟用户双击行为。它常用于放大图片或地图、点赞收藏、激活隐藏菜单、触发特殊交互等场景，适合无法用元素定位、只能按坐标操作的情况。
指令标识：MobileDoubleTapAtPosition
指令类型：移动端指令
指令描述：在指定坐标上执行双击操作
先选使用方式
Section titled “先选使用方式”工作流支持「可视化编排」和「代码编排」两种创建方式。双击坐标 在两种方式里都能用，核心业务参数一致，区别主要是你通过界面配置，还是通过 Python 脚本配置。
| 方式 | 怎么用 | 适合人群 |
|---|---|---|
| 可视化编排（推荐先学） | 拖入「双击坐标」节点，在右侧表单填写 X、Y 坐标 | 大多数用户，零代码，适合快速搭建和调试 |
| 代码编排（Python） | 在脚本中调用 bots.mobileDoubleTapAtPosition(x=500, y=500) | 熟悉代码、需要复用脚本或批量生成流程的用户 |
第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。下方「参数说明」同时给出界面字段和代码参数名，方便两种方式对应。
什么时候用？
Section titled “什么时候用？”- 需要双击图片或地图区域触发放大缩放。
- 在内容区域双击触发点赞、收藏等快捷操作。
- 双击特定区域激活隐藏功能或开发者菜单。
- 目标元素无法稳定定位，只能按屏幕坐标操作。
- 设备已连接，目标页面已加载完成。
- X、Y 坐标在屏幕范围内，不能为空、不能超出屏幕。
- 不同设备分辨率和缩放比例不同，建议结合 获取设备宽度 和 获取设备高度 动态计算坐标。
- 目标区域确实支持双击交互。
【图片占位 | command-mobiledoubletap-config】 截图内容建议： 截一张可视化编排页面，画布中选中「双击坐标」节点，右侧属性面板展示「x坐标」「y坐标」两个输入区域。 标注建议： 用 ① 标出画布中的「双击坐标」节点，用 ② 标出 X 坐标输入框，用 ③ 标出 Y 坐标输入框，用 ④ 标出运行按钮或成功状态。 用户看完应能明白： 这个节点只需要填写要双击的屏幕坐标。
可视化编排：从 0 到跑通
Section titled “可视化编排：从 0 到跑通”下面用一个常见场景演示：双击图片区域将其放大。按 3 步即可跑起来：
- 在移动端流程中添加 双击坐标 节点。
- 在 x坐标 和 y坐标 中填写目标位置，例如
500和500。 - 点击运行，确认目标区域被双击并触发了预期效果（如图片放大）。
| 界面名称 | 代码属性名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
| x坐标 | x | Double | 是 | - | 双击坐标的 X 轴值，不能为空。 |
| y坐标 | y | Double | 是 | - | 双击坐标的 Y 轴值，不能为空。 |
该指令无输出参数。是否双击成功建议通过页面状态变化或运行日志判断。
- 节点运行成功，日志中没有坐标越界等错误。
- 目标坐标位置被双击，触发了预期的交互效果。
- 后续节点能基于双击后的页面状态继续执行。
运行后你会看到（以上面场景为例）：
- 目标图片区域被双击后放大。
- 运行日志显示双击操作成功。
【图片占位 | command-mobiledoubletap-success】 建议放一张运行成功截图：「双击坐标」节点为成功状态，配合一张双击后页面发生变化（如图片放大）的截图。图片用于说明这个节点跑通后用户应该看到什么。
| 现象 / 报错原文 | 可能原因 | 处理建议 |
|---|---|---|
报错 TAP_COORDINATE_ERROR | 坐标超出屏幕范围 | 根据实际设备屏幕尺寸重新计算坐标，确保在屏幕范围内 |
| 双击无响应 | 目标区域不支持双击，或页面未加载完成 | 确认目标区域支持双击，必要时先等待页面加载 |
| 双击位置偏移 | 不同设备分辨率 / 缩放比例不同 | 通过获取设备宽高动态计算坐标，做适配 |
| 双击被识别为两次单击 | 两次点击间隔过长或设备性能影响 | 重试操作，确认设备状态正常 |
Python 代码编排
Section titled “Python 代码编排”代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。
# 在坐标 (500, 500) 位置双击bots.mobileDoubleTapAtPosition(x=500, y=500)可视化表单里的「x坐标」「y坐标」分别对应代码里的 x、y。如果你想在工作流中通过节点动态编排指令，可使用 执行指令（XML）节点。
Q1：坐标参数有什么要求？
Section titled “Q1：坐标参数有什么要求？”A： 坐标必须为有效的屏幕坐标，不能超出屏幕范围。坐标值为数字类型（支持整数或小数），建议为非负数。
Q2：坐标超出屏幕会怎样？
Section titled “Q2：坐标超出屏幕会怎样？”A： 坐标超出屏幕将抛 TAP_COORDINATE_ERROR 异常。建议根据实际设备动态获取屏幕尺寸并计算坐标。
Q3：不同设备的坐标如何适配？
Section titled “Q3：不同设备的坐标如何适配？”A： 不同设备分辨率和屏幕缩放比例可能影响坐标定位，建议使用 获取设备宽度 和 获取设备高度 指令动态计算坐标。
Q4：双击响应不灵敏怎么办？
Section titled “Q4：双击响应不灵敏怎么办？”A： 可检查页面是否支持双击事件或调整操作时机。在移动端自动化环境下，需确保设备已连接且页面已加载完成。