# UploadTask.onProgressUpdate(function listener)

监听上传进度变化事件。

# 支持情况

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

# 语法

uploadTask.onProgressUpdate(function listener)

# 参数

function listener

参数 类型 说明
progress number 上传进度,范围 0.0–1.0
transferred number 已上传的数据量,单位字节
fileSize number 文件总大小,单位字节

# 返回值

void。

# 注意事项

  • 进度更新有节流,相邻两次回调之间进度差至少 10%,或进度达到 100% 时必定触发。

# 示例代码

const task = mt.uploadVenus({
  filePath: '/path/to/image.png',
  success(res) { console.log(res.imageURL) }
})

task.onProgressUpdate((res) => {
  console.log('上传进度:', (res.progress * 100).toFixed(0) + '%')
  console.log('已上传:', res.transferred, '字节')
})

# 与微信差异

无差异(行为与微信小游戏一致)。

上次更新: 8/10/2026, 5:36:37 PM