获取手机屏幕宽度

获取手机屏幕宽度 用于在移动设备上获取当前屏幕的宽度（整数，单位像素）。它常用于坐标计算、判断设备类型、计算屏幕中心点或滑动起止坐标等自适应场景。

指令标识：MobileGetDeviceWidth
指令类型：移动端指令
指令描述：获取当前移动设备屏幕宽度

先选使用方式

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

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「获取手机屏幕宽度」节点，设置输出变量	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 `width = bots.mobileGetDeviceWidth(outKey="screenWidth")`	熟悉代码、需要复用脚本或批量生成流程的用户

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

什么时候用？

获取屏幕宽度后计算元素坐标，实现精确点击或滑动。
根据屏幕宽度判断设备类型（手机/平板），执行不同逻辑。
结合宽度和高度计算屏幕中心点坐标。
根据不同设备宽度，动态调整脚本执行策略，自适应不同分辨率。
根据宽度计算滑动的起止坐标，实现自适应滑动。

使用前确认

移动设备已连接，且当前页面已加载完成。
已规划好用于保存宽度值的输出变量名。
注意屏幕方向变化会影响返回值，必要时在场景切换后重新获取。

【图片占位 | command-mobilegetdevicewidth-config】
截图内容建议： 截一张可视化编排页面，画布选中「获取手机屏幕宽度」节点，右侧属性面板展示「将结果保存至」配置区。
标注建议： 用 ① 标出画布中的节点，用 ② 标出输出变量配置，用 ③ 标出运行按钮或输出结果。
用户看完应能明白： 该指令无需输入参数，只需指定一个输出变量来接收屏幕宽度。

可视化编排：从 0 到跑通

下面用一个常见场景演示：获取屏幕宽度用于后续坐标计算。按 3 步即可跑起来：

在工作流画布中添加 获取手机屏幕宽度 节点，并确保设备已连接。
在 将结果保存至 中填写变量名，例如 screenWidth。
点击运行，查看变量中返回的宽度值（整数，单位像素）。

参数说明

输入参数

该指令无业务输入参数，运行时直接读取当前设备的屏幕宽度。

输出参数

界面名称	代码属性名	类型	必填	说明
将结果保存至	`outKey`	Integer	否	填写变量名称，保存获取到的手机屏幕宽度（整数，单位像素）。

成功标准

运行日志中节点为成功状态。
输出变量中为一个正整数，表示当前屏幕宽度（像素）。
后续坐标计算节点能正常引用该变量。

失败排查

现象 / 报错原文	可能原因	处理建议
返回值为空或异常	设备未连接或页面未加载完成	确认设备连接状态并等待页面加载后重试
坐标计算结果不准	屏幕方向已改变后未重新获取	横竖屏切换后重新调用该指令
逻辑像素与物理像素混淆	返回为逻辑像素值	注意返回的 `windowSize.width/height` 为逻辑像素，与物理 DPI 有区别

Python 代码编排

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

# 获取屏幕宽度，返回值即宽度（像素）
width = bots.mobileGetDeviceWidth(outKey="screenWidth")
print(width)

可视化表单里的「将结果保存至」对应代码里的 outKey。

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

常见问题

Q1：返回的宽度值是什么单位？

A：返回值为整数类型，单位为像素（px）。返回的是设备屏幕的物理宽度，与设备方向（横屏/竖屏）有关。

Q2：返回的是物理像素还是逻辑像素？

A：返回数据的 windowSize.width/height 字段为逻辑像素，与物理像素 DPI 有区别。

Q3：屏幕方向改变后需要重新获取吗？

A：需要。Android 全屏/分屏模式窗口大小会变化，请在场景切换后重新调用；iOS 旋转后也需要再次获取，否则坐标计算会出错。

Q4：如何获取设备高度？

A：如需获取高度，请使用获取手机屏幕高度。通常同时获取宽度和高度，用于计算坐标或屏幕比例。