batchSaveConsumeBudget(params: BatchSaveConsumeBudgetParams)

版本要求:
@tuya-miniapp/cloud-api≥1.3.0

描述

批量保存设备电量预算。支持一次性更新多个时间维度(日、周、月)的用电量预算配置,不传的维度不会被重置。

参数

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

返回值

类型:Promise<boolean>
是否保存成功

引用对象

enumBudgetDataType
枚举值实际值描述
BudgetDataType.Dayday按天
BudgetDataType.Weekweek按周
BudgetDataType.Monthmonth按月

合法值

BudgetDataType
值说明最低版本
day按天-
week按周-
month按月-

示例代码

请求示例

import { batchSaveConsumeBudget, BudgetDataType } from '@tuya-miniapp/cloud-api';

batchSaveConsumeBudget({
  devId: 'vdevo123',
  budgetConfig: [
    { dateType: BudgetDataType.Day, budget: '5' },
    { dateType: BudgetDataType.Week, budget: '20' },
    { dateType: BudgetDataType.Month, budget: '80' },
  ],
})
  .then(result => {
    console.log('电量预算保存成功:', result);
  })
  .catch(error => {
    console.error('电量预算保存失败:', error);
  });

返回示例

true

常见问题

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

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