长按坐标

长按坐标 用于在移动端页面的指定屏幕坐标上模拟用户长按行为。它常用于唤起上下文菜单、激活拖拽模式、触发长按特殊事件等场景，适合无法用元素定位、只能按坐标操作的情况。

指令标识：MobileLongPress
指令类型：移动端指令
指令描述：在指定坐标上执行长按操作

先选使用方式

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

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「长按坐标」节点，在右侧表单填写 X、Y 坐标和长按时长	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 `bots.mobileLongPress(pressX=156, pressY=980, pressTime=600)`	熟悉代码、需要复用脚本或批量生成流程的用户

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

什么时候用？

长按元素唤起上下文菜单（如复制、粘贴、分享）。
执行拖拽前先长按激活拖拽模式。
长按触发应用的特定业务逻辑或动画效果。
目标元素无法稳定定位，只能按屏幕坐标操作。

使用前确认

设备已连接，目标页面已加载完成。
X、Y 坐标在屏幕范围内，不能为空、不能超出屏幕。
已规划好长按时长：iOS Haptic Touch 通常需要 pressTime >= 600ms 才能触发菜单。
不同设备分辨率和缩放比例不同，建议结合获取设备宽度和获取设备高度动态计算坐标。

【图片占位 | command-mobilelongpress-config】 截图内容建议： 截一张可视化编排页面，画布中选中「长按坐标」节点，右侧属性面板展示「x坐标」「y坐标」「长按时长」等区域。 标注建议： 用 ① 标出画布中的「长按坐标」节点，用 ② 标出坐标输入框，用 ③ 标出长按时长，用 ④ 标出运行按钮或成功状态。 用户看完应能明白： 这个节点需要填写要长按的屏幕坐标，长按时长可按需调整。

可视化编排：从 0 到跑通

下面用一个常见场景演示：长按内容区域唤起上下文菜单。按 3 步即可跑起来：

在移动端流程中添加 长按坐标 节点。
在 x坐标 和 y坐标 中填写目标位置（如 156、980），并按需设置 长按时长（如 600 毫秒）。
点击运行，确认目标位置被长按并唤起了菜单。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
x坐标	`pressX`	Double	是	-	长按坐标的 X 轴值，不能为空。
y坐标	`pressY`	Double	是	-	长按坐标的 Y 轴值，不能为空。
长按时长	`pressTime`	Integer	否	`3000`	长按持续时长，单位毫秒（ms）。高级选项。
是否发送消息	`sendMsgFlag`	Boolean	否	`true`	是否发送通知消息。

输出参数

该指令无输出参数。是否长按成功建议通过页面状态变化或运行日志判断。

成功标准

节点运行成功，日志中没有坐标越界等错误。
目标坐标位置被长按，触发了预期效果（如唤起菜单）。
后续节点能基于长按后的页面状态继续执行。

运行后你会看到（以上面场景为例）：

目标位置被长按后唤起上下文菜单。
运行日志显示长按操作成功。

【图片占位 | command-mobilelongpress-success】 建议放一张运行成功截图：「长按坐标」节点为成功状态，配合一张长按后唤起菜单的截图。图片用于说明这个节点跑通后用户应该看到什么。

失败排查

现象 / 报错原文	可能原因	处理建议
长按未触发菜单	长按时长过短	适当增大 `pressTime`，iOS 建议 `>= 600ms`
长按触发了系统选择框	长按时长过长	缩短 `pressTime`，根据业务调整时间
坐标越界 / 无响应	坐标超出屏幕或页面未加载完成	重新计算坐标，确保在屏幕范围内并等待页面加载
长按被识别为拖动	Android 7.0+ 长按可能进入拖动模式	配合拖拽指令处理，或调整长按时长
长按位置偏移	不同设备分辨率 / 缩放比例不同	通过获取设备宽高动态计算坐标，做适配

Python 代码编排

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

# 在坐标 (156, 980) 位置长按 600 毫秒
bots.mobileLongPress(pressX=156, pressY=980, pressTime=600)

不传 pressTime 时使用默认长按时长 3000 毫秒。可视化表单里的「x坐标」「y坐标」「长按时长」分别对应代码里的 pressX、pressY、pressTime。如果你想在工作流中通过节点动态编排指令，可使用执行指令（XML）节点。

常见问题

Q1：坐标参数有什么要求？

A：坐标必须为有效的屏幕坐标，不能超出屏幕范围。坐标值为数字类型（支持整数或小数），建议为非负数。

Q2：长按时长如何设置？

A： iOS Haptic Touch 长按建议 pressTime >= 600ms 才能触发菜单；长按过长可能触发系统选择框（复制/粘贴）。默认长按时长为 3000 毫秒（约 3 秒）。

Q3：不同设备的坐标如何适配？

A：不同设备分辨率和屏幕缩放比例可能影响坐标定位，建议使用获取设备宽度和获取设备高度指令动态计算坐标。

Q4：长按操作有什么特殊注意事项？

A： Android 7.0+ 长按可能触发拖动模式，需配合拖拽指令；长按操作可能受页面脚本或设备性能影响，建议适当调整长按时长，并确保设备已连接、页面已加载完成。