停止手机录屏

停止手机录屏 用于结束由 开始手机录屏 启动的屏幕录制，并把录制好的视频结果保存到输出变量。它与「开始手机录屏」配对使用，作为录制过程的终点。

指令标识：MobileStopRecord
指令类型：手机指令
指令描述：停止录屏

先选使用方式

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

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「停止手机录屏」节点，放在录制流程末尾，并配置「将结果保存至」	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 bots.mobileStopRecord(outKey="recordResult")	熟悉代码、需要复用脚本或批量生成流程的用户

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

什么时候用？

• 一段被录制的关键操作已经完成，需要结束录制并取回视频。
• 自动化用例结束时统一停止录屏，将录像作为执行证据归档。
• 需要把录像结果传给后续节点上传或存档。

使用前确认

• 当前流程已经连接并占用了一台可用的手机设备。
• 前面已经执行过 开始手机录屏。
• 已规划好用于保存录像结果的输出变量名，便于后续节点引用。

可视化编排：从 0 到跑通

下面用一个常见场景演示：结束录制并取回登录到下单全过程的录像。按 3 步即可跑起来：

1. 在工作流画布中添加 停止手机录屏 指令，放在被录制操作的末尾。
2. 在右侧配置面板的 将结果保存至 中填写一个变量名，例如 recordResult。
3. 点击运行，确认录制结束，并在该变量中拿到录像结果，再交由后续节点处理。

【图片占位 | command-mobilestoprecord-config】
截图内容建议： 截一张可视化编排页面，画布中「停止手机录屏」节点位于一段操作流程的末尾，右侧属性面板展示「将结果保存至」输入框。
标注建议： 用 ① 标出「停止手机录屏」节点，用 ② 标出「将结果保存至」输入框，用 ③ 标出运行按钮或成功状态。
用户看完应能明白： 这个指令是录制的终点，核心是配置一个输出变量来接收录像结果。

参数说明

输入参数

该指令无业务输入参数，仅依赖已连接的设备上下文。

输出参数

界面名称	代码属性名	类型	必填	说明
将结果保存至	outKey	String	否	保存录制好的视频结果。后续节点通过该变量名引用结果。未启动录屏时返回空字符串。

成功标准

• 停止手机录屏 节点运行结束后状态为成功。
• 运行日志中没有参数缺失、超时或执行失败等错误。
• 如果配置了输出变量，后续节点能够读取到符合预期的结果。
• 后续节点能够继续执行，流程没有因为该节点异常中断。

失败排查

现象 / 报错原文	可能原因	处理建议
日志报 Mobile device not configured	流程未连接设备	先执行连接/占用设备节点，或在全局变量中配置设备上下文
日志报 Mobile API ... business error	移动端服务异常或设备失联	检查设备在线状态与移动端服务连通性，重连设备后重试
输出变量为空字符串	之前未执行「开始手机录屏」	确认录制流程前已添加 开始手机录屏 节点
输出变量为空	未配置「将结果保存至」	检查是否填写了 outKey，并确认后续引用的变量名一致

Python 代码编排

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

# 开始录屏
bots.mobileStartRecord()

# ... 中间编排需要记录的自动化操作 ...

# 停止录屏并把录像结果保存到变量 recordResult
bots.mobileStopRecord(outKey="recordResult")

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

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

常见问题

Q1：没开始录屏就停止会报错吗？

A： 不会。未启动录屏时执行停止指令是幂等的，会输出提示并向输出变量写入空字符串。

Q2：录像结果是什么格式？

A： 输出为录制视频的结果（如视频地址或编码内容），具体格式以运行返回为准。建议保存到变量后查看实际内容再做后续处理。

相关指令

• 开始手机录屏
• 手机截屏
• 点击