点击坐标
点击坐标 用于在移动设备上点击指定的 X、Y 坐标位置。它适用于无法通过常规选择器定位、固定位置控件或游戏等场景下的精确点击，支持 Android 和 iOS。
指令标识：MobileTapAtPosition
指令类型：移动端指令
指令描述：在移动设备上点击指定坐标位置
先选使用方式
Section titled “先选使用方式”工作流支持「可视化编排」和「代码编排」两种创建方式。点击坐标 在两种方式里都能用，核心业务参数一致，区别主要是你通过界面配置，还是通过 Python 脚本配置。
| 方式 | 怎么用 | 适合人群 |
|---|---|---|
| 可视化编排（推荐先学） | 拖入「点击坐标」节点，填写 X、Y 坐标 | 大多数用户，零代码，适合快速搭建和调试 |
| 代码编排（Python） | 在脚本中调用 bots.mobileTapAtPosition(x=100, y=100) | 熟悉代码、需要复用脚本或批量生成流程的用户 |
第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。下方「参数说明」同时给出界面字段和代码参数名，方便两种方式对应。
什么时候用？
Section titled “什么时候用？”- 元素无法通过常规选择器定位时，改用坐标点击。
- 点击固定位置的 UI 元素，如屏幕角落的按钮。
- 在游戏自动化场景中点击特定坐标位置。
- 处理特殊布局或自定义控件的点击操作。
- 已经获取设备分辨率，确认坐标在屏幕范围内。
- 坐标原点为屏幕左上角，坐标值必须为非负数。
- 配合 获取文本坐标 等指令可先取得目标坐标。
- 本指令属于页面操作类，默认失败处理为「报错中止」（
STOP_ON_FAILURE）。
可视化编排：从 0 到跑通
Section titled “可视化编排：从 0 到跑通”- 先获取目标位置坐标，例如通过 获取文本坐标，或根据分辨率计算。
- 在工作流画布中添加 点击坐标 节点。
- 在 x坐标、y坐标 中填写目标坐标，例如
100、100。 - 运行后确认点击位置符合预期。
【图片占位 | command-mobiletapatposition-config】 建议放一张配置截图：右侧属性面板展示「x坐标」「y坐标」。图片用于说明只需填写坐标即可点击对应位置。
| 界面名称 | 代码属性名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
| x坐标 | x | Float | 是 | - | 点击位置的 X 坐标，原点为屏幕左上角。 |
| y坐标 | y | Float | 是 | - | 点击位置的 Y 坐标，原点为屏幕左上角。 |
该指令无输出参数。是否成功建议通过界面变化或后续节点判断。
- 点击落在预期坐标位置。
- 页面出现预期变化，如跳转、弹窗或控件状态变化。
- 后续节点能基于点击结果继续执行。
【图片占位 | command-mobiletapatposition-success】 建议放一张运行成功截图：设备屏幕在目标坐标处触发了预期交互。图片用于说明点击坐标后应看到的效果。
| 现象 | 可能原因 | 处理建议 |
|---|---|---|
| 点击位置不对 | 不同分辨率/缩放比例导致坐标偏移 | 先获取当前分辨率，使用相对坐标或比例坐标提高兼容性 |
| 点击无响应（iOS） | 点击落在安全区域（刘海/底栏） | 避开安全区域或适当偏移坐标 |
| 点击落点偏移（Android） | 沉浸模式下坐标系与实际像素存在差异 | 点击前先获取设备宽高，按实际像素换算坐标 |
| 坐标无效报错 | 坐标为负或超出屏幕 | 确认坐标为非负数且在屏幕范围内 |
Python 代码编排
Section titled “Python 代码编排”代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。
# 点击坐标 (100, 100)bots.mobileTapAtPosition(x=100, y=100)结合「获取文本坐标」可先定位再点击：
position = bots.mobileLocateByText(text="登录", outKey="loginPosition")bots.mobileTapAtPosition(x=position["x"], y=position["y"])如果你想在工作流中通过节点动态编排指令，可使用 执行指令（XML）节点。
Q1：坐标原点在哪里？
Section titled “Q1：坐标原点在哪里？”A： 坐标原点为屏幕左上角。坐标值必须为非负数且在屏幕范围内，可使用相对坐标或绝对坐标。
Q2：iOS 设备有什么特殊限制？
Section titled “Q2：iOS 设备有什么特殊限制？”A： iOS 部分安全区域（刘海/底栏）不可点击，需要适当偏移。建议避开这些区域或调整坐标。
Q3：Android 设备坐标如何处理？
Section titled “Q3：Android 设备坐标如何处理？”A： Android 在沉浸模式下坐标系与实际像素可能有差异，建议先用 获取手机屏幕宽度 等指令获取分辨率再换算坐标。
Q4：不同设备的坐标如何适配？
Section titled “Q4：不同设备的坐标如何适配？”A： 不同设备分辨率和缩放比例可能影响坐标定位，建议根据实际设备动态获取或适配，优先使用相对坐标或比例坐标以提高兼容性。