# mt.uploadVenus(Object object)

将本地文件上传到美团 Venus 图片服务。

# 支持情况

项 说明
兼容性 美团小游戏特有

# 参数

Object object

属性 类型 默认值 必填 说明
filePath string — 是 要上传的本地文件路径
name string — 否 上传后的文件名;不填时自动使用文件的 MD5 值作为文件名
success function — 否 成功回调
fail function — 否 失败回调
complete function — 否 完成回调(成功或失败均触发)

success 回调参数

属性 类型 说明
code number HTTP 状态码
imageURL string 上传成功后的图片访问 URL

# 返回值

返回 UploadTask 对象。

# 注意事项

  • 调用此 API 需要用户已登录,未登录时会直接触发 fail 回调。
  • 上传目标固定为美团 Venus 图片服务,不支持自定义上传地址。

# 示例代码

const task = mt.uploadVenus({
  filePath: '/path/to/image.png',
  name: 'my-image.png',
  success(res) {
    console.log('上传成功:', res.imageURL)
  },
  fail(err) {
    console.error(err.errMsg)
  }
})

task.onProgressUpdate((res) => {
  console.log('上传进度:', res.progress)
})

# 与微信差异

  • 此 API 为美团小游戏特有,微信小游戏中的对应功能为 wx.uploadFile,但两者名称和参数均不同。
  • 微信 uploadFile 支持自定义上传地址(url 参数),美团小游戏 uploadVenus 上传目标固定为 Venus 图片服务,无 url 参数。
  • 微信 uploadFile 无需登录;美团小游戏 uploadVenus 需要用户已登录。
  • 成功回调字段不同:微信返回 data / statusCode,美团小游戏返回 imageURL / code。
上次更新: 8/10/2026, 5:36:37 PM