连接/切换云手机
连接/切换云手机（ConnectCloudPhone） 用于连接或切换到一台云手机设备，为后续的移动端自动化操作准备设备环境。它通常是移动端 RPA 的第一步，连接成功后才能进行点击、滑动、AI 操作屏幕等移动端操作。
指令标识：连接/切换云手机
指令类型：业务工作流指令
指令描述：连接或切换云手机设备
先选使用方式
Section titled “先选使用方式”连接/切换云手机 是一个业务工作流节点，推荐通过 可视化编排 使用。你在表单里选择目标云手机设备即可建立连接。
| 方式 | 怎么用 | 适合人群 |
|---|---|---|
| 可视化编排（推荐） | 拖入「连接/切换云手机」节点，选择目标云手机设备 | 需要进行移动端自动化的用户 |
该指令为业务工作流节点，未提供独立的标准代码方法，建议在可视化编排中使用。
什么时候用？
Section titled “什么时候用？”- 移动端自动化流程的第一步，需要先连接一台云手机。
- 流程中途需要切换到另一台云手机设备。
- 后续要使用 AI 操作屏幕、AI 页面断言/提取等移动端节点前的准备步骤。
- 已有可用的云手机设备资源。
- 当前执行环境能访问云手机服务。
- 明确要连接或切换到哪一台设备。
- 流程结束后建议用 关闭云手机 释放资源。
【图片占位 | command-connect-cloudphone-config】
建议放一张可视化编排截图：选中「连接/切换云手机」节点，右侧展示设备选择区，标注它通常位于移动端流程的第一步。
可视化编排：从 0 到跑通
Section titled “可视化编排：从 0 到跑通”- 在工作流画布中添加 连接/切换云手机 节点，通常放在移动端流程的第一步。
- 在节点中选择要连接的目标云手机设备。
- 运行确认设备连接成功。
- 在后续节点中添加移动端操作（如 AI操作屏幕（移动端））。
- 流程结束后用 关闭云手机 释放设备。
| 界面名称 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| 云手机设备 | 选择 | 是 | - | 要连接或切换到的目标云手机设备 |
具体字段名以节点表单中的实际配置项为准。
| 界面名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 输出变量 | String | 否 | 保存连接结果或设备信息，供后续节点引用 |
连接/切换云手机节点运行结束后状态为成功。- 运行日志中没有参数缺失、超时或执行失败等错误。
- 如果配置了输出变量，后续节点能够读取到符合预期的结果。
- 后续节点能够继续执行，流程没有因为该节点异常中断。
| 现象 | 可能原因 | 处理建议 |
|---|---|---|
| 连接失败 | 设备不可用或服务不可达 | 检查云手机资源与网络连通性 |
| 没有可选设备 | 当前账号无可用云手机资源 | 确认已分配可用的云手机资源 |
| 切换后操作仍作用于旧设备 | 切换未生效 | 确认切换节点已成功执行后再进行后续操作 |
Python 代码编排
Section titled “Python 代码编排”该指令为业务工作流节点，未提供独立的标准代码方法，推荐通过可视化编排使用。请在工作流画布中拖入「连接/切换云手机」节点完成配置。
Q1：连接和切换是同一个节点吗？
Section titled “Q1：连接和切换是同一个节点吗？”A： 是的。该节点既可用于首次连接，也可用于切换到另一台云手机设备。
Q2：用完云手机要做什么？
Section titled “Q2：用完云手机要做什么？”A： 建议在流程结束时使用 关闭云手机 释放设备资源。