陀螺仪和视觉扫地机

通用接口

流数据相关的接口采用通用接口形式调用，详情请参考 通用接口。

查询最新一次清扫记录

接口

tuya.m.device.media.latest

版本

2.0

入参说明

字段名	类型	描述
devId	String	设备 ID
start	String	开始位置。第一次传空，之后取下一页时填上一页返回值里的 startRow 值
size	Integer	查询数据的大小，固定参数为 500

响应参数

字段名	类型	描述
devId	String	设备 ID
startRow	String	分页查询索引
dataList	Array	流数据
subRecordId	String	清扫记录 ID
hasNext	BOOL	是否有下一页数据

响应示例

{
	"devId":"6ccdd506b7186ee85avntm",
	"startRow":"mtnva58ee6817b605ddcc6_35_1535629239586",
	"dataList":[
		"373702373700",
		"383702383802373901383901383800",
		"373802373901373800",
		"373802363901363801373800",
		"373702373602373600",
		"373502373500",
		"373502373402373301363301373400",
		"363502363500",
		"363502363500"
	],
	"subRecordId":35,
	"hasNext":true,
	"startTime":1535629049,
	"endTime":1535629244,
	"status":2
}

历史清扫记录列表

接口

tuya.m.sweeper.cleaning.history.get

版本

1.0

入参说明

字段名	类型	描述
devId	String	设备 ID
offset	Integer	分页偏移量
limit	Integer	分页大小
startTime	Long	开始时间
endTime	Long	结束时间

响应参数

字段名	类型	描述
recordId	String	地图 ID
gid	int	家庭组 ID
dpId	int	在涂鸦 IoT 平台配置的清扫记录的 DP ID
gmtCreate	long	创建时间
value	String	地图信息，解析 subRecordId
uuid	String	设备 ID

响应示例

{
	"recordId":"162992AAXKaZCdL2tDvVcWYecT9AA9630150",
	"gid":38498424,
	"dpId":15,
	"gmtCreate":1629929630203,
	"value":"20210826052504804100145",
	"uuid":"ecc8c633ef1d9ede"
}

清扫记录详情

接口

tuya.m.device.media.detail

版本

2.0

入参说明

字段名	类型	描述
devId	String	设备 ID
subRecordId	Integer	清扫记录 ID，通过解析历史记录列表的value数据，根据数据长度使用不同的解析规则，规则见下表
start	String	开始位置。第一次传空，之后取下一页时填上一页返回值里的 startRow 值
size	Integer	查询数据的大小，固定参数为 500

dps 解析协议

记录时间	清扫时间	清扫面积	subRecordId	举例	说明
有	有	有	有	20200319202500300200123	取MCU上报的时间在面板中显示 点击对应记录可以显示地图
没有	有	有	有	00300200123	取DP上报的云端时间戳时间在面板中显示 点击对应记录可以显示地图
有	有	有	没有	202003192025003002	取MCU上报的时间在面板中显示 点击对应记录不可以显示地图
没有	有	有	没有	003002	取DP上报的云端时间戳时间在面板中显示 点击对应记录不可以显示地图

响应参数

字段名	类型	描述
devId	String	设备 ID
startRow	String	分页查询索引
dataList	Array	流数据
subRecordId	String	清扫记录 ID
hasNext	BOOL	是否有下一页数据

响应示例

{
	"devId":"6ccdd506b7186ee85avntm",
	"startRow":"mtnva58ee6817b605ddcc6_31_1535622776561",
	"dataList":[
		"3e3f02403e013e3f00",
		"3f3f024040013f3f00",
		"3f3f02403f014040013f3f00",
		"3f40024140014040013f3f024041013f41013f3f00",
		"3f3f024040014041013f41013f3f00"
	],
	"subRecordId":31,
	"hasNext":true,
	"startTime":1535621566,
	"endTime":1535623017,
	"status":2
}

删除历史清扫记录

接口

tuya.m.sweeper.cleaning.history.delete

版本

1.0

入参说明

字段名	类型	描述
devId	String	设备 ID
uuid	Integer	清扫记录 ID

响应示例

{
	"result":true,
	"success":true,
	"status":"ok",
	"t":1557740732829
}

功能接口

数据流程

功能简介

涂鸦陀螺仪型或视觉型的扫地机是使用流通道来传输地图数据，实现 TuyaSmartSweeperDeviceDelegate 代理协议接收用来接收地图流数据回调。

类名	说明
TuyaSmartSweepDevice	涂鸦扫地机设备相关的类

订阅地图流数据

接口说明

订阅设备的地图流数据。

- (void)subscribeDeviceDataTransfer;

示例代码

Objc：

- (void)subscribeDevice {

	[self.sweeperDevice subscribeDeviceDataTransfer];
}

Swift：

func subscribeDevice() {
	sweeperDevice?.subscribeDeviceDataTransfer()
}

取消订阅地图流数据

接口说明

取消订阅设备的地图流数据。

- (void)unsubscribeDeviceDataTransfer;

示例代码

Objc：

- (void)unsubscribeDevice {

	[self.sweeperDevice unsubscribeDeviceDataTransfer];
}

Swift：

func unsubscribeDevice() {
	sweeperDevice?.unsubscribeDeviceDataTransfer()
}

流数据回调

接口说明

设备上报的流数据实时回调。

- (void)sweeperDevice:(TuyaSmartSweeperDevice *)sweeperDevice didReceiveStreamData:(NSData *)data;

参数说明

参数	说明
sweeperDevice	TuyaSmartSweeperDevice 实例对象
data	流数据（NSData 类型）。0~3 位数据为地图的 subRecordId，4~12位数据非业务数据，不参与解析。 注意，从13位数据开始为地图实际数据，每3位数据为一个地图点，分别为地图的x坐标、y坐标和地图点的点类型。

示例代码

Objc：

self.sweeperDevice = [TuyaSmartSweeperDevice deviceWithDeviceId:<#devId#>];
self.sweeperDevice.delegate = self;

// 实现代理方法
- (void)sweeperDevice:(TuyaSmartSweeperDevice *)sweeperDevice didReceiveStreamData:(NSData *)data {

}

Swift：

sweeperDevice = TuyaSmartSweeperDevice.init(deviceId: "your_devId")
sweeperDevice?.delegate = self

func sweeperDevice(_ sweeperDevice: TuyaSmartSweeperDevice, didReceiveStreamData data: Data) {

}