cleanDeviceData – 涂鸦小程序

cleanDeviceData(params: CleanDeviceDataParams)

版本要求:

@tuya-miniapp/cloud-api≥1.3.0

描述

清除指定设备的能源统计数据。操作不可逆，清除后设备的电量、电费等历史统计数据将被清空，建议在调用前提示用户确认。

参数

参数	类型	必填	说明
		是	请求参数

返回值

类型：Promise<boolean>

是否清除成功；此操作不可逆，建议先调用 exportDeviceData 备份数据后再清除

示例代码

请求示例

import { cleanDeviceData } from '@tuya-miniapp/cloud-api';

cleanDeviceData({ devId: 'vdevo123' })
  .then(result => {
    console.log('设备能源数据清除成功:', result);
  })
  .catch(error => {
    console.error('设备能源数据清除失败:', error);
  });

返回示例

true

常见问题

为什么调用云能力会出现失败的情况？

使用本接口前，请确保设备所属产品已在涂鸦 IoT 开发平台开启电量统计高级能力。未启用该能力的产品无法采集电量/电费数据，接口将返回空数据或报错。如需使用，请创建带有电量/电费统计功能的产品，并在产品详情中启用相应高级能力。同时，接口依赖云能力，需在小程序开发者平台开发设置 - 云能力进行授权配置。