getCurrencyList()

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

描述

获取能源能力支持的货币列表。返回系统当前支持的所有货币选项,不含默认货币占位符 DEFAULT,可用于渲染货币选择 UI。

参数

无

返回值

类型:Promise<GetCurrencyListResult>
货币列表,每项包含 symbol(货币符号,如 ¥、$)和 code(ISO 4217 货币编码,如 CNY、USD)

引用对象

typeGetCurrencyListResult`getCurrencyList` 返回值,货币列表(不含 `DEFAULT` 占位符)
CurrencyItem[]

示例代码

请求示例

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

getCurrencyList()
  .then(result => {
    result.forEach(item => {
      console.log(`${item.symbol} (${item.code})`);
    });
  })
  .catch(error => {
    console.error('获取货币列表失败:', error);
  });

返回示例

[
  { "symbol": "¥", "code": "CNY" },
  { "symbol": "$", "code": "USD" },
  { "symbol": "€", "code": "EUR" }
]

常见问题

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

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