# 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, '字节')
})
# 与微信差异
无差异(行为与微信小游戏一致)。