MIOT HomeMIOT Home
Viomi V3
#viomi.vacuum.v13

Viomi V3

urn:miot-spec-v2:device:vacuum:0000A006:viomi-v13:2
版本 v2 v1
← 返回产品详情下载米家插件
语言
Service tree
扫地机
#2 · vacuum
属性 11动作 8事件 1

Properties

工作状态
#1 · status
格式
uint8
读写
R / N
值
0睡眠
1待机
2暂停
3回充中
4充电中
5扫地中
6扫拖中
7拖地中
故障
#2 · fault
格式
uint32
读写
R / N
值
0 ~ 3000，步长 1
扫地 扫拖 单拖
#11 · wdr-mode
格式
uint8
读写
R / W / N
值
0扫地
1扫拖
2单拖
箱子状态
#12 · door-state
格式
uint8
读写
R / N
值
0无
1尘盒
2水箱
3二合一水箱
抹布状态
#13 · contact-state
格式
uint8
读写
R / N
值
0没装
1装
清扫完成后全图对应url地址
#14 · stream-address
格式
string
读写
值
—
清扫时间，单位分钟，工作或暂停中代表本次清扫时间，其它状态则代表上次清扫时间
#15 · contact-state
格式
uint8
读写
R / N
值
0 ~ 120，步长 1
清扫面积，单位㎡，工作或暂停中代表本次清扫面积，其它状态则代表上次清扫面积
#16 · contact-state
格式
uint16
读写
R / N
值
0 ~ 1200，步长 1
0：语音关闭 ； 1~10：语音音量值大小
#17 · mute
格式
uint8
读写
R / W / N
值
0 ~ 10，步长 1
Sweep Type
#4 · sweep-type
格式
uint8
读写
R / W / N
值
0Global
1Mop
2Edge
3Area
4Point
5Control
吸力大小
#19 · mode
格式
uint8
读写
R / W / N
值
0安静/静音
1标准
2中档
3强力

Actions

开始工作
#1 · start-sweep
停止工作
#2 · stop-sweeping
暂停工作
#3 · pause
开始回充
#4 · start-charge
停止回充
#5 · stop-massage
开始拖地
#6 · start-mop
开始单扫地
#7 · start-only-sweep
开始扫拖
#8 · start-sweep-mop

Events

设备异常事件
#2 · exception-occurred
触发参数
#2故障uint32
电池
#3 · battery
属性 1

Properties

电池电量
#1 · battery-level
格式
uint8
读写
R / N
值
0 ~ 100，步长 1
扫地机
#4 · viomi-vacuum
属性 30动作 6事件 4

Properties

二次清扫开关
#1 · repeat-state
格式
uint8
读写
R / W / N
值
0关
1开
记忆地图开关
#3 · remember-state
格式
uint8
读写
W / N / R
值
0关
1开
是否有记忆地图
#4 · has-map
格式
uint8
读写
R / N / W
值
0无
1有
清扫完成后，机器是否识别到新的地图，若是app弹框提示用户是否覆盖记忆地图
#5 · has-newmap
格式
uint8
读写
R / N / W
值
0否
1是
拖地/扫拖路线
#6 · mop-route
格式
uint8
读写
R / N / W
值
0弓字
1Y字
边刷剩余寿命百分比
#8 · side-brush-life
格式
uint8
读写
R / N
值
0 ~ 100，步长 1
边刷剩余寿命小时
#9 · side-brush-hours
格式
uint8
读写
R / N
值
0 ~ 180，步长 1
主刷剩余寿命百分比
#10 · main-brush-life
格式
uint8
读写
R / N
值
0 ~ 100，步长 1
主刷剩余寿命小时
#11 · main-brush-hours
格式
uint16
读写
R / N
值
0 ~ 360，步长 1
海帕剩余寿命百分比
#12 · hypa-life
格式
uint8
读写
R / N
值
0 ~ 100，步长 1
海帕剩余寿命小时
#13 · hypa-hours
格式
uint8
读写
R / N
值
0 ~ 180，步长 1
拖布剩余寿命百分比
#14 · mop-life
格式
uint8
读写
R / N
值
0 ~ 100，步长 1
拖布剩余寿命小时
#15 · mop-hours
格式
uint8
读写
R / N
值
0 ~ 180，步长 1
遥控器方法参数
#16 · direction
格式
uint8
读写
W
值
1上
2左
3右
4下
5停
10退出
吸力大小
#17 · suction-grade
格式
uint8
读写
W / R / N
值
0安静
1节能
2标准
3强劲
出水量大小
#18 · water-grade
格式
uint8
读写
R / N / W
值
01挡
12挡
23挡
重置耗材方法参数
#19 · consumable-index
格式
uint8
读写
W / R / N
值
0重置主刷
1重置边刷
2重置海帕
3重置拖布
选房间清扫时，传的房间id字符串参数，逗号分割，如：‘10,11,12,13’，若传空则是全局清扫
#20 · clean-room-ids
格式
string
读写
W / R / N
值
—
选房间清扫模式
#21 · clean-room-mode
格式
uint8
读写
R / N / W
值
0全局
1沿边
选房间清扫操作
#22 · clean-room-oper
格式
uint8
读写
R / N / W
值
0停止
1开始
2暂停
3假暂停
当前储存的地图数量
#23 · map-num
格式
uint8
读写
R / N
值
0 ~ 5，步长 1
设备时区属性
#24 · time-zone
格式
int32
读写
R / N / W
值
-99999 ~ 99999，步长 1
清扫开始时间，时间戳，单位秒
#25 · clean-start-time
格式
int64
读写
R / N
值
0 ~ 9999999999，步长 1
清扫使用时间，单位秒
#26 · clean-use-time
格式
uint32
读写
R / N
值
0 ~ 99999，步长 1
清扫总面积，单位m2
#27 · clean-area
格式
uint32
读写
R / N
值
0 ~ 9999，步长 1
清扫地图url
#28 · clean-map-url
格式
string
读写
R / N
值
—
清扫模式
#29 · clean-mode
格式
uint8
读写
R / N
值
0全局
1拖地
2沿边
3区域
4定点
清扫方式
#30 · clean-way
格式
uint8
读写
R / N
值
0扫地
1扫拖
2单拖
设备当前语言de en ru zh
#31 · cur-lang
格式
string
读写
R / N / W
值
—
当前地图id
#32 · cur-map-id
格式
uint32
读写
R / N
值
0 ~ 2147483647，步长 1

Actions

重置地图
#7 · reset-map
标定
#10 · set-calibration
重置指定耗材的使用时间
#11 · reset-consumable
入参
#19重置耗材方法参数uint8
选房间清扫
#13 · set-room-clean
入参
#21选房间清扫模式uint8#22选房间清扫操作uint8#20选房间清扫时，传的房间id字符串参数，逗号分割，如：‘10,11,12,13’，若传空则是全局清扫string
新建地图命令，执行后，机器下一次清扫将保存为一张新地图
#14 · create-new-map
自定义房间清扫顺序
#15 · set-queue-room-clean
入参
#21选房间清扫模式uint8#22选房间清扫操作uint8#20选房间清扫时，传的房间id字符串参数，逗号分割，如：‘10,11,12,13’，若传空则是全局清扫string

Events

拖布取下提示。当设备开始充电时，拖布未取下触发
#1 · mop-remind
待机时间超过6小时，推送并自动关机
#2 · wait-remind
待机时间过长且电量低于15%，推送并自动关机
#3 · low-remind
清扫结束上报
#4 · clean-end
触发参数
#25清扫开始时间，时间戳，单位秒int64#26清扫使用时间，单位秒uint32#27清扫总面积，单位m2uint32#28清扫地图urlstring#29清扫模式uint8#30清扫方式uint8
预约、勿扰相关
#5 · order
属性 21动作 2

Properties

预约id
#1 · order-id
格式
uint8
读写
W
值
0 ~ 100，步长 1
是否开启该条预约
#2 · enable
格式
uint8
读写
W
值
0关
1开
转换成二进制后，每一位代表一天，1 - 预约 0 - 无预约，bit0-bit6 星期日-星期六
#3 · day
格式
uint16
读写
W
值
0 ~ 256，步长 1
预约小时（24小时制）
#4 · hour
格式
uint8
读写
W
值
0 ~ 23，步长 1
预约分钟
#5 · minute
格式
uint8
读写
W
值
0 ~ 59，步长 1
是否重复
#6 · repeat
格式
uint8
读写
W
值
0不重复
1重复
预约清扫方式
#8 · clean-way
格式
uint8
读写
W
值
0扫地
1扫拖
2单拖
预约吸力大小
#9 · suction
格式
uint8
读写
W
值
0安静
1节能
2标准
3强劲
预约出水量大小
#10 · water
格式
uint8
读写
W
值
01挡
12挡
23挡
是否二次清扫
#11 · twice-clean
格式
uint8
读写
W
值
0关闭
1打开
预约的地图id，若没地图则传0
#12 · mapid
格式
uint32
读写
W
值
0 ~ 99999999，步长 1
预约的房间数量
#13 · room-count
格式
uint8
读写
W
值
0 ~ 64，步长 1
预约的房间数据JSON字符串[{name:'房间1',id:10},{name:'房间2‘,id:11},{...},{...}...]
#14 · room-data
格式
string
读写
W
值
—
勿扰是否打开
#15 · dnd-enable
格式
uint8
读写
R / N / W
值
0关闭
1打开
勿扰开始小时
#16 · dnd-start-hour
格式
uint8
读写
W / R / N
值
0 ~ 23，步长 1
勿扰开始分钟
#17 · dnd-start-minute
格式
uint8
读写
R / N / W
值
0 ~ 59，步长 1
勿扰结束小时
#18 · dnd-end-hour
格式
uint8
读写
R / N / W
值
0 ~ 23，步长 1
勿扰结束分钟
#19 · dnd-end-minute
格式
uint8
读写
R / N / W
值
0 ~ 59，步长 1
时区参数
#20 · dnd-timezone
格式
int32
读写
R / N / W
值
-99999 ~ 99999，步长 1
时区偏移
#21 · timestamp
格式
int64
读写
N / W / R
值
0 ~ 9999999999，步长 1
N组预约数据逗号分割，每组数据内的具体数据用下划线_分割 {order_id}_{order_enable}_{week}_{hour}_{minute}_{repeat}_{mode}_{suction}_{water}_{twice}_{mapid}_{room_size}_{roomid}_{roomname}
#22 · orderdata
格式
string
读写
R / N
值
—

Actions

删除一组预约
#2 · del
入参
#1预约iduint8
获取预约数据
#3 · get
出参
#22N组预约数据逗号分割，每组数据内的具体数据用下划线_分割 {order_id}_{order_enable}_{week}_{hour}_{minute}_{repeat}_{mode}_{suction}_{water}_{twice}_{mapid}_{room_size}_{roomid}_{roomname}string
指哪扫那 划区 虚拟墙
#6 · point-zone
属性 4动作 4

Properties

指哪扫那目标点，XY逗号分割，如’3.23,6.89‘
#1 · target-point
格式
string
读写
W / R / N
值
—
划区的四个顶点坐标 'x1,y1,x2,y2,x3,y3,x4,y4'
#2 · zone-points
格式
string
读写
W
值
—
虚拟墙JSON数据如[2,'2_2_-6.34_-3.6_-8.6_-10.23','3_3_2.33_1.33_4.23_3.44_2.44_6.77_1.22_3.44']，就是设置了2组虚拟墙坐标第1组id是2,类型值是2表示线段，两端坐标为(-6.34,-3.6)和(-8.6,-10.23)第2组id是3,类型值是3表示四边形，4个点按顺序依次相连并闭合，坐标为(2.33,1.33)(4.23,3.44)(2.44,6.77)(1.22,3.44)
#3 · restrict-points
格式
string
读写
W
值
—
暂停类型
#4 · pause-type
格式
uint8
读写
W
值
0普通暂停
1假暂停

Actions

开始指哪扫那清扫
#1 · start-point-clean
暂停指哪扫那清扫
#2 · pause-point-clean
入参
#4暂停类型uint8
开始区域清扫
#5 · start-zone-clean
暂停区域清扫
#6 · pause-zone-clean
入参
#4暂停类型uint8
地图相关
#7 · map
属性 11动作 10

Properties

上传的地图类型
#1 · map-type
格式
uint8
读写
R / N / W
值
0指哪扫哪地图
1划区清扫地图
2全局地图
地图id
#2 · map-id
格式
int64
读写
R / N / W
值
0 ~ 9999999999，步长 1
识别到新地图时的操作参数
#3 · new-map-oper
格式
uint8
读写
W
值
0丢弃地图
1新增地图(新增地图的名字默认为‘地图X’，当前有N张地图，X就为N+1)
2覆盖当前地图
地图名字
#4 · map-name
格式
string
读写
R / N / W
值
—
语言参数
#5 · lang
格式
string
读写
W
值
—
要合并的房间id参数，逗号分割，如：‘10,11,12’表示合并房间id为10,11,12的房间；
#6 · arrange-room-ids
格式
string
读写
W
值
—
目标房间id
#7 · target-room-id
格式
uint8
读写
W
值
0 ~ 128，步长 1
分割线段的两个端点坐标，如：'3.45,6.78|4.56,-3.45'
#8 · split-points
格式
string
读写
W
值
—
房间名称
#9 · room-name
格式
string
读写
W
值
—
机器人当前清扫轨迹坐标 : [3.456,4.555,0.2,1,5.456,4.555,0.233,0,......]
#10 · cur-cleaning-path
格式
string
读写
R / N
值
—
地图列表数据[{name : '地图1',id:1585849584,cur : true},{name : '地图2',id : 1585849784,cur : false}]
#11 · map-list
格式
string
读写
R / N
值
—

Actions

上传指定类型的地图
#1 · upload-by-maptype
入参
#1上传的地图类型uint8
上传指定id的地图
#2 · upload-by-mapid
入参
#2地图idint64
设置当前地图
#3 · set-cur-map
入参
#2地图idint64
识别到新地图时操作
#4 · deal-new-map
入参
#3识别到新地图时的操作参数uint8
删除指定id的地图
#5 · del-map
入参
#2地图idint64
重命名地图
#7 · rename-map
入参
#2地图idint64#4地图名字string
合并房间
#8 · arrange-room
入参
#2地图idint64#5语言参数string#6要合并的房间id参数，逗号分割，如：‘10,11,12’表示合并房间id为10,11,12的房间；string
分割房间
#9 · split-room
入参
#2地图idint64#5语言参数string#7目标房间iduint8#8分割线段的两个端点坐标，如：'3.45,6.78|4.56,-3.45'string
房间重命名
#10 · rename-room
入参
#2地图idint64#7目标房间iduint8#9房间名称string
获取地图列表数据
#11 · get-map-list
出参
#11地图列表数据[{name : '地图1',id:1585849584,cur : true},{name : '地图2',id : 1585849784,cur : false}]string
声音相关
#8 · voice
属性 6动作 3

Properties

当前下载的语音包名字
#3 · target-voice
格式
string
读写
R / N / W
值
—
当前在用的语音包名字
#4 · cur-voice
格式
string
读写
R / N / W
值
—
下载状态
#5 · download-status
格式
uint8
读写
R / N / W
值
0空闲
1开始
2下载中
12下载完成
13解压中
14解压完成
15更换成功
16暂停
17任务创建失败
18校验失败
19解压失败
20容量不足
21连接服务器失败
22超时
下载进度
#6 · download-progress
格式
uint8
读写
R / N / W
值
0 ~ 100，步长 1
要下载的语音包链接
#7 · voice-url
格式
string
读写
W
值
—
要下载的语音包的md5编码
#8 · voice-mdfive
格式
string
读写
W
值
—

Actions

寻找扫地机
#2 · find-device
开始下载语音包
#3 · download-voice
入参
#3当前下载的语音包名字string#7要下载的语音包链接string#8要下载的语音包的md5编码string
获取语音包文件下载状态
#4 · get-downloadstatus
出参
#6下载进度uint8#3当前下载的语音包名字string#4当前在用的语音包名字string#5下载状态uint8