更新时间:2024-06-26 02:24:58下载pdf
扫地机 SDK 提供接口请求和实时数据通道两种数据查询方式。
接口说明
查询最新一次的扫地机清扫记录。
void queryLatestCleanRecord(String devId, String start, int size, ITuyaResultCallback<RecordDetaiBean> callback);
参数说明
参数 | 说明 |
---|---|
devId | 设备 ID |
start | 起始行,第一次传空串,后续查询下一页时需要填上一页返回值里的 startRow 值 |
size | 请求大小,最大值 500 |
RecordDetaiBean
的主要属性定义如下:
字段 | 类型 | 描述 |
---|---|---|
devId | Sting | 设备 ID |
startRow | String | 起始行 |
dataList | List<String> | 地图数据 |
subRecordId | int | 清扫记录 ID |
hasNext | boolean | 是否有下一页 |
startTime | long | 开始时间 |
endTime | long | 结束时间 |
示例代码
TuyaOptimusSdk.getManager(ITuyaSweeperKitSdk.class).getGyroscopeAndVisualSweeperKit().queryLatestCleanRecord(devId, "", 500, new ITuyaResultCallback<RecordDetaiBean>() {
@Override
public void onSuccess(RecordDetaiBean result) {
}
@Override
public void onError(String errorCode, String errorMessage) {
}
});
接口说明
查询历史的清扫记录列表。
void getHistoryCleanRecordList(String devId, int offset, int limit, long startTime, long endTime, ITuyaResultCallback<HistoryResultBean> callback);
参数说明
字段 | 类型 | 描述 |
---|---|---|
devId | String | 设备 ID |
offset | int | 偏移值 |
limit | int | 分页数量 |
startTime | long | 开始时间 |
endTime | long | 结束时间 |
HistoryResultBean
的主要属性定义如下:
字段 | 类型 | 描述 |
---|---|---|
datas | List<RecordListBean> | 历史数据列表 |
totalCount | int | 总数 |
RecordListBean
的主要属性定义如下:
字段 | 类型 | 描述 |
---|---|---|
recordId | String | 地图的唯一 ID |
gid | long | 家庭组 ID |
dpId | int | 扫地机产品在 涂鸦开发者平台 配置的清扫记录的 DP ID |
gmtCreate | long | 创建时间 |
value | String | 地图信息,用来解析 subRecordId |
uuid | String | 设备唯一 ID |
示例代码
TuyaOptimusSdk.getManager(ITuyaSweeperKitSdk.class).getGyroscopeAndVisualSweeperKit().getHistoryCleanRecordList(devId, 0, 10, 0, 0, new ITuyaResultCallback<HistoryResultBean>() {
@Override
public void onSuccess(HistoryResultBean result) {
}
@Override
public void onError(String errorCode, String errorMessage) {
}
});
接口说明
获取历史记录列表中的详细信息。
void getCleanRecordDetail(String devId, int subRecordId, String start, int size, ITuyaResultCallback<RecordDetaiBean> callback);
参数说明
参数 | 说明 |
---|---|
devId | 设备 ID |
subRecordId | 清扫记录 ID,通过解析历史记录列表的 value 数据,根据数据长度使用不同的解析规则,规则见下表 |
start | 起始行,第一次传空串,后面取下一页时填上一页返回值里的 startRow 值 |
size | 请求数据大小,最大值 500 |
value
解析协议
记录时间 长度 12 位 |
清扫时间 长度 3 位 |
清扫面积 长度 3 位 |
subRecordId 长度 5 位 |
举例 | 说明 |
---|---|---|---|---|---|
有 | 有 | 有 | 有 | 20200319202500300200123 |
|
没有 | 有 | 有 | 有 | 00300200123 |
|
有 | 有 | 有 | 没有 | 202003192025003002 |
|
没有 | 有 | 有 | 没有 | 003002 |
|
示例代码
TuyaOptimusSdk.getManager(ITuyaSweeperKitSdk.class).getGyroscopeAndVisualSweeperKit().getCleanRecordDetail(devId, subRecordId, "", 2, new ITuyaResultCallback<RecordDetaiBean>() {
@Override
public void onSuccess(RecordDetaiBean result) {
}
@Override
public void onError(String errorCode, String errorMessage) {
}
});
接口说明
对数值类型字符串(value
)解析协议的简单封装方法,可以自行按照上述规则解析也可以使用此方法。仅支持数值类型字符串。
int getSubRecordId(String value);
示例代码
int subId = TuyaOptimusSdk.getManager(ITuyaSweeperKitSdk.class).getGyroscopeAndVisualSweeperKit().getSubRecordId("20200319202500300200123");
接口说明
最多可以删除 100 条记录。
void deleteHistoryCleanRecord(String devId, List<String> recordIds, IResultCallback callback);
参数说明
参数 | 说明 |
---|---|
devId | 设备 ID |
recordIds | 清扫记录标识,从历史记录列表接口中获取 |
示例代码
TuyaOptimusSdk.getManager(ITuyaSweeperKitSdk.class).getGyroscopeAndVisualSweeperKit().deleteHistoryCleanRecord(devId, recodIds, new IResultCallback() {
@Override
public void onError(String code, String error) {
}
@Override
public void onSuccess() {
}
});
注册实时数据通道监听设备数据流上报,返回数据是数组形式,根据机器协议解析成可用数据,如 x 坐标、y 坐标、颜色值等。
API 入口:TuyaHomeSdk.getTransferInstance();
接口说明
void registerTransferDataListener(ITuyaDataCallback<TransferDataBean> callback);
代码示例
TuyaHomeSdk.getTransferInstance().registerTransferDataListener(new ITuyaDataCallback<TransferDataBean>() {
@Override
public void onSuccess(TransferDataBean result) {
}
@Override
public void onError(String errorCode, String errorMessage) {
}
});
TransferDataBean
字段 | 类型 | 描述 |
---|---|---|
data | byte[] |
|
devId | String | 设备 ID |
接口说明
void unRegisterTransferDataListener(ITuyaDataCallback<TransferDataBean> callback);
代码示例
TuyaHomeSdk.getTransferInstance().unRegisterTransferDataListener(this);
该内容对您有帮助吗?
是意见反馈该内容对您有帮助吗?
是意见反馈