# 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。