任务工作模式说明
本文说明「查询任务工作模式」接口(POST /openapi/v3/tasks/fusion/work-modes/list)返回的 workMode 完整配置结构、各字段含义,以及目前已知的全部工作模式枚举。不同产品线支持的工作模式组合不同。
支 持版本
A6+
使用示例(workMode 对象)
创建组合任务或排班时,workMode 对象使用示例如下:
{
"workMode": {
"id": "f476ea80b55042efbd69d31f52d039ff",
"mode": "wash",
"subType": "wash",
"type": 0,
"strength": "middle"
}
}
workMode 完整配置结构
{
"id": "f476ea80b55042efbd69d31f52d039ff",
"mode": "wash",
"subType": "wash",
"type": 0,
"configType": "strength",
"hasStrength": true,
"recommended": true,
"subTaskEnabled": true,
"defaultStrength": "middle",
"strengthOptions": ["low", "middle", "high"]
}
字段说明
| 字段 | 类型 | 示例值 | 说明 | 备注 |
|---|---|---|---|---|
| id | string | f476ea80b55042efbd69d31f52d039ff | 工作模式 ID,用于唯一区分同一产品线下的各个模式 | 创建组合任务/排班时引用此 ID |
| mode | string | wash | 工作模式机器码(模式展示标识),仅包含小写字母、数字和下划线 | 全部取值见工作模式枚举 |
| subType | string | wash | 模式内部标识(英文枚举值),用于前后端交互 | 当前实现中与 mode 一致 |
| type | int | 0 | 工作任务类型 | 0=CLEAN(清洁任务);5=WORK(作业任务:巡检/强力洗地)。清洁模式为 0,巡检、强力洗地为 5 |
| recommended | bool | true | 是否推荐该模式 | 每个产品线通常将一个模式标记为推荐 |
| configType | string | strength | 配置方式 | strength=有清洁档位;fixed=固定配置(无档位);custom=自定义配置(预留,当前无实例) |
| hasStrength | bool | true | 是否支持清洁档位调节 | configType=strength 时为 true,fixed 时为 false |
| strengthOptions | array<string> | ["low","middle","high"] | 可选档位列表 | 巡检、强力洗地等固定配置模式为空数组 [];部分模式仅支持单一档位(如 ["middle"])。数组顺序不代表档位高低 |
| defaultStrength | string | middle | 默认档位 | 巡检、强力洗地为空字符串 "" |
| subTaskEnabled | bool | true | 是否支持作为组合任务中的子任务 | 清洁模式通常为 true;巡检、强力洗地为 false(只能独立执行) |
字段之间的关联
type=0(清洁任务):configType=strength、hasStrength=true、defaultStrength为low/middle/high之一、subTaskEnabled=true。type=5(作业任务:巡检、强力洗地):configType=fixed、hasStrength=false、strengthOptions=[]、defaultStrength=""、subTaskEnabled=false。
工作模式枚举
以下枚举汇总自任务服务当前配置,覆盖全部已知取值。mode 与 subType 当前取值一致。
清洁任务(type=0)
| mode / subType | 名称 | 说明 |
|---|---|---|
sweep | 扫地 | 干扫清洁,适用于硬质地面 |
sweep_wash | 扫洗 | 扫地与洗地复合模式,一次通过完成扫+洗 |
wash | 洗地 | 湿式洗地清洁 |
sweep_vacuum | 扫吸 | 扫地与吸尘复合模式,一次通过完成扫+吸 |
vacuuming | 吸尘 | 纯吸尘清洁,适用于地毯等场景 |
dust_push | 尘推 | 使用尘推布进行干式推尘养护 |
roller_dust_push | 滚刷尘推 | 使用滚刷进行尘推清洁 |
silent_dust_push | 静音推尘 | 低噪音尘推,适用于对噪音敏感的场景 |
aromatherapy | 香薰 | 移动过程中释放香氛,无水清洁 |
disinfectant | 消杀 | 喷洒消毒液进行消杀作业 |
sweep_vacuum_clean | 扫吸清洁 | 扫地与吸尘复合的深度清洁模式 |
carpet_cleaning | 地毯清洁 | 针对地毯的吸尘清洁模式 |
hot_wash | 热水洗地 | 使用热水进行洗地,去油污能力更强 |
作业任务(type=5)
| mode / subType | 名称 | 说明 |
|---|---|---|
inspect | 巡检 | 按路线巡检,若发现可清洁的污渍则自主进行清洁 |
strong_wash | 强力洗地 | 强力洗地作业,用于重污渍场景 |
info
工作模式按机器人产品线配置,上表是全量枚举,单台机器人实际支持的模式以其「查询任务工作模式」接口返回为准。例如扫地车产品线通常只返回 sweep、inspect,洗地车产品线通常返回 wash、dust_push、inspect。
档位枚举
| strength | 名称 | 说明 |
|---|---|---|
low | 轻柔 | 轻柔档位清洁,速度快、噪音低,适用于轻度脏污 |
middle | 标准 | 标准档位清洁(多数模式的默认值) |
high | 强劲 | 强劲档位清洁,适用于重度脏污 |
仅 configType=strength 的模式支持档位调节;strengthOptions 为该模式实际可选的档位子集,defaultStrength 为不传 strength 时使用的默认档位。
configType 枚举
| configType | 含义 | 特征 |
|---|---|---|
strength | 有清洁档位 | hasStrength=true,需提供/可选 strength,strengthOptions 非空 |
fixed | 固定配置 | hasStrength=false,无档位,strengthOptions=[]、defaultStrength="";巡检、强力洗地属于此类 |
custom | 自定义配置 | 预留枚举,当前线上数据暂无实例 |
使用示例
创建组合任务或排班时,workMode 引用「查询任务工作模式」返回的对象:
{
"workMode": {
"id": "f476ea80b55042efbd69d31f52d039ff",
"mode": "wash",
"subType": "wash",
"type": 0,
"strength": "middle"
}
}
id+mode(+subType)共同定位一个工作模式;id为空时可仅通过mode匹配。strength不传时使用该模式的defaultStrength;传值必须是strengthOptions中的元素。- 固定配置模式(
configType=fixed,如inspect、strong_wash)不传strength。
典型产品线配置示例
以下为任务服务中的真实配置示例,展示不同产品线的模式组合差异。
洗地车产品线(支持洗地、尘推、巡检):
[
{"id": "7f94c2fe1e744ea7a06a411329dc763f", "mode": "sweep", "type": 0, "subType": "sweep", "configType": "strength", "hasStrength": true, "recommended": true, "subTaskEnabled": true, "defaultStrength": "middle", "strengthOptions": ["low", "middle", "high"]},
{"id": "d1b03d7c0c1c4773b9dae3d4d027037e", "mode": "sweep_wash", "type": 0, "subType": "sweep_wash", "configType": "strength", "hasStrength": true, "recommended": false, "subTaskEnabled": true, "defaultStrength": "middle", "strengthOptions": ["low", "middle", "high"]},
{"id": "0fa484cfec2a4d618c7bd17583315ece", "mode": "wash", "type": 0, "subType": "wash", "configType": "strength", "hasStrength": true, "recommended": false, "subTaskEnabled": true, "defaultStrength": "middle", "strengthOptions": ["low", "middle", "high"]},
{"id": "", "mode": "dust_push", "type": 0, "subType": "dust_push", "configType": "strength", "hasStrength": true, "recommended": false, "subTaskEnabled": true, "defaultStrength": "middle", "strengthOptions": ["low", "middle", "high"]},
{"id": "3f7a8b2c5d9e4f1a8c6b9e2d7f4a8b3c", "mode": "inspect", "type": 5, "subType": "inspect", "configType": "fixed", "hasStrength": false, "recommended": false, "subTaskEnabled": false, "defaultStrength": "", "strengthOptions": []}
]
含强力洗地的产品线(type=5 包含 strong_wash):
[
{"id": "1dee3b4db66942e5b515acda4c50467a", "mode": "wash", "type": 0, "subType": "wash", "configType": "strength", "hasStrength": true, "recommended": true, "subTaskEnabled": true, "defaultStrength": "middle", "strengthOptions": ["high", "low", "middle"]},
{"id": "e9b96b1fb8944bf0bbc442d3f09a315b", "mode": "dust_push", "type": 0, "subType": "dust_push", "configType": "strength", "hasStrength": true, "recommended": false, "subTaskEnabled": true, "defaultStrength": "middle", "strengthOptions": ["high", "low", "middle"]},
{"id": "3f7a8b2c5d9e4f1a8c6b9e2d7f4a8b3c", "mode": "inspect", "type": 5, "subType": "inspect", "configType": "fixed", "hasStrength": false, "recommended": false, "subTaskEnabled": false, "defaultStrength": "", "strengthOptions": []},
{"id": "6e4d8a9f2b7c3e5a1d9f6b8c4e7a2d5f", "mode": "strong_wash", "type": 5, "subType": "strong_wash", "configType": "fixed", "hasStrength": false, "recommended": false, "subTaskEnabled": false, "defaultStrength": "", "strengthOptions": []}
]
商用清洁机器人产品线(香薰/消杀/地毯清洁等无水模式):
[
{"id": "b6680d6bec6f4c6eac0cdbcd1e59d53c", "mode": "disinfectant", "type": 0, "subType": "disinfectant", "configType": "strength", "hasStrength": true, "recommended": false, "subTaskEnabled": true, "defaultStrength": "middle", "strengthOptions": ["low", "middle", "high"]},
{"id": "d42df81e0da148f0b40a37e60807128b", "mode": "aromatherapy", "type": 0, "subType": "aromatherapy", "configType": "strength", "hasStrength": true, "recommended": false, "subTaskEnabled": true, "defaultStrength": "middle", "strengthOptions": ["low", "middle", "high"]},
{"id": "...", "mode": "carpet_cleaning", "type": 0, "subType": "carpet_cleaning", "configType": "strength", "hasStrength": true, "recommended": false, "subTaskEnabled": true, "defaultStrength": "middle", "strengthOptions": ["low", "middle", "high"]}
]
仅支持单一档位的产品线(strengthOptions 只有 middle):
[
{"id": "3bebb490abc04d39ab84ff8044055c6b", "mode": "wash", "type": 0, "subType": "wash", "configType": "strength", "hasStrength": true, "recommended": true, "subTaskEnabled": true, "defaultStrength": "middle", "strengthOptions": ["low", "middle", "high"]},
{"id": "74bf116ab2554e128640a823b559358d", "mode": "dust_push", "type": 0, "subType": "dust_push", "configType": "strength", "hasStrength": true, "recommended": false, "subTaskEnabled": true, "defaultStrength": "middle", "strengthOptions": ["middle"]},
{"id": "3f7a8b2c5d9e4f1a8c6b9e2d7f4a8b3c", "mode": "inspect", "type": 5, "subType": "inspect", "configType": "fixed", "hasStrength": false, "recommended": false, "subTaskEnabled": false, "defaultStrength": "", "strengthOptions": []}
]