getImageTransferKey(data: GetImageTransferKeyParams)

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

描述

获取设备图传密钥和加密等级

参数

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

返回值

类型:Promise<GetImageTransferKeyResult>
GetImageTransferKeyResult 设备密钥、skill 原始 JSON 与当前加密等级

引用对象

interfaceGetImageTransferKeyResult获取设备图传密钥和加密等级结果
属性类型描述
tckeystring | null设备维度密钥,可能为 null
skillstring设备 skill 原始 JSON 字符串
levelnumber当前加密等级,skill 中无值时默认 3

示例代码

请求示例

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

getImageTransferKey({
  devId: '6cbed8370dd694e247uk9u',
})
  .then(response => {
    console.log(response);
  })
  .catch(error => {
    console.error('Failed to get image transfer key:', error);
  });

返回示例

{
  "tckey": "a1b2c3d4e5f6",
  "skill": "{\"tckey\":\"a1b2c3d4e5f6\",\"level\":3}",
  "level": 3
}

常见问题

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

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