根据方向滑动屏幕

根据方向滑动屏幕 用于在移动设备上按固定方向进行滑动操作。你可以设置滑动方向和滑动速度来控制滑动行为，支持在 Android、iOS 和 Harmony 设备上执行，适用于翻页浏览、下拉刷新、左右切换、顶部/底部检测等场景。

指令标识：MobileSwipeByDirection
指令类型：移动端指令
指令描述：在移动设备上按固定方向进行滑动操作

先选使用方式

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

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「根据方向滑动屏幕」节点，在右侧表单选择滑动方向和速度	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 `bots.mobileSwipeByDirection(slideDirection="DOWN", slideSpeed="NORMAL")`	熟悉代码、需要复用脚本或批量生成流程的用户

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

什么时候用？

向上或向下滑动页面，浏览更多内容。
从页面顶部向下滑动，触发下拉刷新。
向左或向右滑动，实现页面或图片的横向切换。
使用快速滑动模式，快速浏览大量内容。
通过左右滑动操作轮播图，查看不同图片或内容。

使用前确认

滑动区域可操作；iOS Safari/WebView 中若页面可滚动，系统可能优先处理手势。
已确认需要的滑动方向（上/下/左/右）和速度（慢/正常/快）。
滑动距离由系统自动计算，默认为整屏滑动。

【图片占位 | command-mobileswipebydirection-config】
截图内容建议： 截一张可视化编排页面，画布选中「根据方向滑动屏幕」节点，右侧属性面板展示「滑动方向」和「滑动速度」两个下拉框。
标注建议： 用 ① 标出滑动方向下拉框，用 ② 标出滑动速度下拉框，用 ③ 标出运行按钮，用 ④ 标出设备预览区域。
用户看完应能明白： 这个指令只需要选择方向和速度即可触发整屏滑动。

可视化编排：从 0 到跑通

下面用一个常见场景演示：在页面顶部向下滑动触发下拉刷新。按 3 步即可跑起来：

在画布中添加 根据方向滑动屏幕 指令。
在 滑动方向 中选择 DOWN（向下），在 滑动速度 中选择 NORMAL（正常）。
点击运行，确认页面发生了向下滑动并触发刷新。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
滑动方向	`slideDirection`	Enum	是	`DOWN`	滑动方向：向上=`UP`；向下=`DOWN`；向左=`LEFT`；向右=`RIGHT`。
滑动速度	`slideSpeed`	Enum	是	`NORMAL`	滑动速度：慢=`SLOW`；正常=`NORMAL`；快=`FAST`。

成功标准

屏幕按指定方向发生了滑动。
滑动速度符合预期（慢/正常/快）。
滑动触发了预期效果（如翻页、下拉刷新、轮播切换）。

失败排查

现象	可能原因	处理建议
滑动无效果	当前区域不可滑动	确认滑动区域可操作，必要时先聚焦到可滑动区域
滑动方向不对	方向参数选错	检查 `slideDirection` 是否为预期方向
iOS 上手势被拦截	页面可滚动，系统优先处理手势	确保在可滑动区域内执行滑动
滑动过快/过慢	速度参数不合适	调整 `slideSpeed`，精确控制场景用 `SLOW`

Python 代码编排

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

# 向下滑动屏幕，正常速度
bots.mobileSwipeByDirection(
    slideDirection="DOWN",
    slideSpeed="NORMAL",
)

可视化表单里的「滑动方向」「滑动速度」分别对应代码里的 slideDirection、slideSpeed。

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

常见问题

Q1：滑动方向有哪些选项？

A：支持四个方向：UP（向上）、DOWN（向下）、LEFT（向左）、RIGHT（向右）。滑动距离由系统自动计算，默认为整屏滑动。

Q2：滑动速度如何选择？

A：支持三种速度：SLOW（慢速，适用于需要精确控制的场景）、NORMAL（正常速度，默认值）、FAST（快速，适用于快速滚动场景）。

Q3：iOS 设备滑动有什么注意事项？

A： iOS Safari/WebView 如果页面可滚动，系统可能优先处理手势，需确保滑动区域可操作，建议在可滑动区域内执行。