获取设备制造商

获取设备制造商 用于读取当前连接手机的制造商（厂商）名称，例如华为、小米、三星等。它通常用于在自动化流程中根据不同厂商执行差异化的操作，结果通过输出变量保存后供后续节点引用。

指令标识：MobileGetDeviceManufacturer
指令类型：手机指令
指令描述：获取设备制造商

先选使用方式

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

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「获取设备制造商」节点，在右侧表单填写「将结果保存至」	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 `bots.mobileGetDeviceManufacturer(outKey="manufacturer")`	熟悉代码、需要复用脚本或批量生成流程的用户

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

什么时候用？

需要根据手机厂商执行不同的自动化分支（例如不同厂商的弹窗、权限页路径不同）。
在自动化测试报告中记录被测设备的制造商信息。
做设备兼容性校验，确认当前设备是否符合预期厂商。

使用前确认

当前流程已经连接并占用了一台可用的手机设备。
设备处于亮屏、可操作状态。
已规划好用于保存结果的输出变量名，便于后续节点引用。

可视化编排：从 0 到跑通

下面用一个常见场景演示：根据手机厂商决定后续走哪条权限处理分支。按 3 步即可跑起来：

在工作流画布中添加 获取设备制造商 指令，通常放在连接设备之后。
在右侧配置面板的 将结果保存至 中填写一个变量名，例如 manufacturer。
点击运行，确认运行日志中输出了制造商名称，再在后续条件节点中引用该变量做分支判断。

【图片占位 | command-mobilegetdevicemanufacturer-config】
截图内容建议： 截一张可视化编排页面，画布选中「获取设备制造商」节点，右侧属性面板展示「将结果保存至」输入框。
标注建议： 用 ① 标出画布中的节点，用 ② 标出「将结果保存至」输入框，用 ③ 标出运行按钮或成功状态。
用户看完应能明白： 这个指令不需要输入参数，核心是配置一个输出变量来接收制造商名称。

参数说明

输入参数

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

输出参数

界面名称	代码属性名	类型	必填	说明
将结果保存至	`outKey`	String	否	保存获取到的设备制造商名称（如 `HUAWEI`、`Xiaomi`）。后续节点通过该变量名引用结果。

输出值为设备返回的制造商字符串，不同厂商大小写与拼写可能不同，做分支判断时建议忽略大小写。

成功标准

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

失败排查

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

Python 代码编排

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

# 获取设备制造商并保存到变量 manufacturer
bots.mobileGetDeviceManufacturer(outKey="manufacturer")

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

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

常见问题

Q1：返回的制造商名称格式固定吗？

A：不固定。不同厂商返回的字符串大小写、拼写可能存在差异（如 HUAWEI、HONOR、Xiaomi）。做条件判断时建议统一转小写后再比较。

Q2：iOS 设备能获取制造商吗？

A： iOS 设备制造商通常固定返回为 Apple。如需更细的机型信息，可结合获取设备操作系统与获取设备操作系统版本一起使用。