开始手机录屏
开始手机录屏 用于启动当前设备的屏幕录制。它通常与 停止手机录屏 配对使用，把中间的一段自动化操作过程录制下来，便于调试、复盘与问题回溯。
指令标识：MobileStartRecord
指令类型：手机指令
指令描述：开始录屏
先选使用方式
Section titled “先选使用方式”工作流支持「可视化编排」和「代码编排」两种创建方式。开始手机录屏 在两种方式里都能用，核心业务参数一致，区别主要是你通过界面配置，还是通过 Python 脚本配置。
| 方式 | 怎么用 | 适合人群 |
|---|---|---|
| 可视化编排（推荐先学） | 拖入「开始手机录屏」节点，放在需要开始录制的位置，无需额外参数 | 大多数用户，零代码，适合快速搭建和调试 |
| 代码编排（Python） | 在脚本中调用 bots.mobileStartRecord() | 熟悉代码、需要复用脚本或批量生成流程的用户 |
第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。
什么时候用？
Section titled “什么时候用？”- 需要记录一段关键自动化操作的执行过程，用于调试或复盘。
- 自动化用例失败率较高，希望保留运行录像辅助定位问题。
- 需要把执行过程作为测试证据归档。
- 当前流程已经连接并占用了一台可用的手机设备。
- 后续会有 停止手机录屏 节点来结束录制并获取录像。
- 设备允许进行屏幕录制。
可视化编排：从 0 到跑通
Section titled “可视化编排：从 0 到跑通”下面用一个常见场景演示：录制一段登录到下单的完整操作过程。按 4 步即可跑起来：
- 在工作流画布中添加 开始手机录屏 指令，放在需要开始记录的步骤之前。
- 该指令无需配置业务参数，直接保留默认即可。
- 在中间编排需要记录的自动化操作（点击、输入等）。
- 在结尾添加 停止手机录屏 节点，并用「将结果保存至」接收录像结果。
【图片占位 | command-mobilestartrecord-config】
截图内容建议： 截一张可视化编排页面，画布中「开始手机录屏」节点位于一段操作流程的起点，结尾对应一个「停止手机录屏」节点。
标注建议： 用 ① 标出「开始手机录屏」节点，用 ② 标出中间被录制的操作节点，用 ③ 标出末尾的「停止手机录屏」节点。
用户看完应能明白： 这个指令是录制的起点，需要和「停止手机录屏」成对使用。
该指令无业务输入参数，仅依赖已连接的设备上下文。
该指令无输出参数。录像内容在执行 停止手机录屏 时通过其输出变量获取。
开始手机录屏节点运行结束后状态为成功。- 运行日志中没有参数缺失、超时或执行失败等错误。
- 后续节点能够继续执行，流程没有因为该节点异常中断。
| 现象 / 报错原文 | 可能原因 | 处理建议 |
|---|---|---|
日志报 Mobile device not configured | 流程未连接设备 | 先执行连接/占用设备节点，或在全局变量中配置设备上下文 |
日志报 Mobile API ... business error | 移动端服务异常或设备失联 | 检查设备在线状态与移动端服务连通性，重连设备后重试 |
| 日志提示「录屏已在运行中，跳过重复启动」 | 已经开始过录屏，重复执行 | 属于幂等保护，可忽略；如需重新录制请先停止再开始 |
Python 代码编排
Section titled “Python 代码编排”代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。
# 开始录屏bots.mobileStartRecord()
# ... 中间编排需要记录的自动化操作 ...
# 停止录屏并保存录像结果bots.mobileStopRecord(outKey="recordResult")如果你想在工作流中通过节点动态编排指令，可使用 执行指令（XML）节点。
Q1：重复执行「开始录屏」会怎样？
Section titled “Q1：重复执行「开始录屏」会怎样？”A： 该指令是幂等的。若录屏已在运行中，重复执行只会输出提示并跳过，不会重复启动。
Q2：录像在哪里获取？
Section titled “Q2：录像在哪里获取？”A： 录像内容在执行 停止手机录屏 时通过其「将结果保存至」输出变量获取。