获取手机屏幕高度
获取手机屏幕高度 用于读取当前移动设备的屏幕高度（像素），常用于按比例计算点击 / 滑动坐标、判断屏幕方向以及适配不同分辨率设备。
指令标识：MobileGetDeviceHeight
指令类型：移动端指令
指令描述：获取当前移动设备屏幕高度
先选使用方式
Section titled “先选使用方式”工作流支持「可视化编排」和「代码编排」两种创建方式。获取手机屏幕高度 在两种方式里都能用，核心业务参数一致，区别主要是你通过界面配置，还是通过 Python 脚本配置。
| 方式 | 怎么用 | 适合人群 |
|---|---|---|
| 可视化编排（推荐先学） | 拖入「获取手机屏幕高度」节点，填写结果变量名即可 | 大多数用户，零代码，适合快速搭建和调试 |
| 代码编排（Python） | 在脚本中调用 bots.mobileGetDeviceHeight(outKey="...") | 熟悉代码、需要复用脚本或批量生成流程的用户 |
第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。下方「参数说明」同时给出界面字段和代码参数名，方便两种方式对应。
什么时候用？
Section titled “什么时候用？”- 需要根据屏幕高度计算元素或坐标位置，实现精确点击 / 滑动。
- 需要结合宽度判断屏幕方向（横屏 / 竖屏）。
- 需要按屏幕比例做自适应滑动或定位。
通常会与 获取手机屏幕宽度 配合使用，用于计算坐标或屏幕比例。
- 设备已连接且处于可操作状态。
- 已规划好「将结果保存至」的变量名，用于引用返回的高度值。
- 屏幕方向变化（旋转、全屏 / 分屏）后高度会改变，需在场景切换后重新获取。
- 该指令默认失败即中止（报错中止）。
【图片占位 | command-mobilegetdeviceheight-config】
截图内容建议： 截一张可视化编排页面，画布选中「获取手机屏幕高度」节点，右侧属性面板展示「将结果保存至」。
标注建议： 用 ① 标出节点，用 ② 标出结果变量名，用 ③ 标出运行按钮，用 ④ 标出运行结果。
用户看完应能明白： 这个指令无需输入参数，只要填一个结果变量名。
可视化编排：从 0 到跑通
Section titled “可视化编排：从 0 到跑通”下面用一个常见场景演示：获取屏幕高度，用于后续按比例滑动。按 4 步即可跑起来：
- 在前序流程中连接设备并打开目标 App。
- 添加 获取手机屏幕高度 节点。
- 在 将结果保存至 填写变量名（如
deviceHeight）。 - 点击运行，确认变量得到屏幕高度（整数像素），再用于后续坐标 / 滑动计算。
无。
| 界面名称 | 代码属性名 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| 将结果保存至 | outKey | Integer | 否 | 保存获取到的屏幕高度（整数像素）；不填则结果无法被后续节点引用 |
- 运行成功，结果变量得到一个整数（屏幕高度，单位像素）。
- 数值与设备当前方向下的实际高度一致。
运行后你会看到（以上面场景为例）：
- 变量
deviceHeight得到设备屏幕高度，例如2400，可用于后续按比例计算坐标。
| 现象 / 报错原文 | 可能原因 | 处理建议 |
|---|---|---|
| 取不到值 | 设备未连接或会话异常 | 检查设备连接与会话状态后重试 |
| 后续坐标计算偏差 | 旋转 / 分屏后未重新获取 | 屏幕方向或窗口变化后重新调用本指令 |
| 数值与预期单位不符 | 物理像素与逻辑像素差异 | 注意返回的 windowSize 高度为逻辑像素，与物理像素 DPI 有区别 |
Python 代码编排
Section titled “Python 代码编排”代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。
# 获取屏幕高度，保存到 deviceHeightbots.mobileGetDeviceHeight(outKey="deviceHeight")可视化表单里的「将结果保存至」对应代码里的 outKey。
如果你想在工作流中通过节点动态编排指令，可使用 执行指令（XML）节点。
Q1：返回的高度单位是什么？
Section titled “Q1：返回的高度单位是什么？”A： 返回整数，单位为像素（px），是设备屏幕的高度，与设备方向（横屏 / 竖屏）有关。
Q2：返回的是物理像素还是逻辑像素？
Section titled “Q2：返回的是物理像素还是逻辑像素？”A： 返回的 windowSize 宽 / 高为逻辑像素，与物理像素 DPI 有区别。
Q3：屏幕方向改变后需要重新获取吗？
Section titled “Q3：屏幕方向改变后需要重新获取吗？”A： 需要。Android 全屏 / 分屏窗口大小会变化，iOS 旋转后也需再次获取，否则坐标计算会出错。
Q4：如何获取设备宽度？
Section titled “Q4：如何获取设备宽度？”A： 使用 获取手机屏幕宽度 指令，通常与高度一起获取用于计算坐标或比例。