getDeviceCurrency(params: GetDeviceCurrencyParams)

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

描述

获取设备当前配置的货币单位。可用于在界面上展示电费时附加正确的货币符号。若设备尚未配置货币,返回空字符串。

参数

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

返回值

类型:Promise<string>
货币编码(ISO 4217),如 CNY、USD;未配置时返回空字符串

示例代码

请求示例

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

getDeviceCurrency({ devId: 'vdevo123' })
  .then(currency => {
    console.log('设备货币:', currency); // 如 "CNY"
  })
  .catch(error => {
    console.error('获取设备货币失败:', error);
  });

返回示例

"CNY"

常见问题

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

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