本页目录
常见问题为什么调用云能力会出现失败的情况？

getImageTransferConfig(data: GetImageTransferConfigParams)

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

描述

获取设备图传上传桶配置与临时凭证

参数

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

返回值

类型：Promise<GetImageTransferConfigResult>
GetImageTransferConfigResult 会话 ID、skill、上传前缀、上传凭证等

引用对象

interfaceGetImageTransferConfigResult获取设备图传配置结果
属性类型描述
sidstring传入值或服务端生成的会话 ID
解析后的 skill JSON
prefixstring上传路径前缀（save 时需原样回传为 path）
credentialsImageTransferCredentials上传凭证
metastring调用者 uid
levelnumber加密等级，固定 3

示例代码

请求示例

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

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

返回示例

{
  "sid": "session_123456789",
  "skill": {},
  "prefix": "tc_permanent/123456789",
  "credentials": {
    "bucket": "tuya-tc-permanent",
    "path": "tc_permanent/123456789"
  },
  "meta": "your_user_id",
  "level": 3
}

常见问题

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

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