ok.onEcloudProgressUpdate(callback Function)

基础库2.0.0开始支持

此接口为客户端主动调用前端推送传输任务状态接口，调用频1s每次

天翼云盘传输任务监听接口

传输任务 callback Function 的返回值

Object data

参数名	类型	必填	说明
`code`	number	是	响应状态码
`data`	object	是	响应结果
`transFiles`	array	是	传输文件数组
`statusCode`	string	是	任务响应状态码
`transType`	string	是	传输活动类型（枚举值: `upload` 上传 `download` 下载）
`uploadId`	string	是	上传任务Id，由客户端对每次上传生成 `uuid` 唯一值，当 `transType`为 `download` 时 `uploadId` 为空字符串
`downloadId`	string	是	下载任务Id，由客户端对每次下载生成 `uuid` 唯一值，当 `transType`为 `upload` 时 `downloadId` 为空字符串
`isFast`	string	是	是否秒传, 当上传/下载成功时，`isFast` 不为空（枚举值: `1` 秒传 `2` 普通传输），下载任务为普通传输类型 `2` , 其余状态为空字符串
`speed`	string	是	传输速度单位：kb/s (例:`300` 单位由前端自由转换)
`progress`	number	是	当前传输进度，整数 (`0-100`)
`fileId`	string	是	天翼云盘文件Id，当上传成功时 `fileId` 为天翼云盘文件Id，当失败/上传中为空字符串
`fileName`	string	是	文件名称
`fileSize`	string	是	文件大小，当上传/下载成功时 `fileSize` 不为空，当失败/上传中/为空字符串
`fileMd5`	string	是	文件Md5 ，当上传/下载成功时 `fileMd5` 为天翼云盘文件Md5，当失败/上传中为空字符串
`downloadPath`	string	是	文件下载路径，当 `transType：download` 且 `statusCode:success` 时 `downloadPath`不为空，其余状态为空字符串
`failCode`	string	是	文件上传、下载失败错误码，当 `statusCode：fail` 时 `failCode` 不为空；失败情况由客户端失败/服务端失败构成
`failMsg`	string	是	文件上传、下载响应描述，当 `statusCode：fail` 时 `failMsg` 不为空；（例如：下载磁盘空间不足/上传云盘空间不足）
`msg`	string	是	响应信息

object.statusCode 的合法值

属性	类型	说明
`success`	string	成功
`fail`	string	失败
`timeout`	string	超时
`pause`	string	暂停
`transfer`	string	传输中

示例代码

// 上传/下载成功
ok.onEcloudProgressUpdate(data => {
  const { code, msg, transFiles } = data
  console.log(transFiles)
  // [{ //场景一： 上传成功
  //   "statusCode": "success",
  //   "transType": "upload",
  //   "uploadId": "73142de80f78423fb17f12098734d6c7",
  //   "downloadId" : "", //当类型为上传时，下载id为""
  //   "isFast": "1",
  //   "speed": "300",
  //   "progress": 100,
  //   "fileId": "73142de80f78423fb17f12098734d6c7",
  //   "fileName": "IMG_20191102_160941.jpg",
  //   "fileSize": "688802",
  //   "fileMd5": "73142de80f78423fb17f12098734d6c7",
  //   "downloadPath": "",//当类型为上传时，下载 downloadPath 为""
  //   "failCode": "success",
  //   "failMsg": "上传成功"
  // },{  // 场景二： 下载成功
  //   "statusCode": "success",
  //   "transType": "download",
  //   "uploadId": "", //当类型为下载时，上传id为""
  //   "downloadId" : "73142de80f78423fb17f12098734d6c7",
  //   "isFast": "2", // 下载为普通传输
  //   "speed": "300",
  //   "progress": 100,
  //   "fileId": "73142de80f78423fb17f12098734d6c7",
  //   "fileName": "IMG_20191102_160941.jpg",
  //   "fileSize": "688802",
  //   "fileMd5": "73142de80f78423fb17f12098734d6c7",
  //   "downloadPath": "本地磁盘路径", //当类型为下载时，下载成功 downloadPath 不为空
  //   "failCode": "success",
  //   "failMsg": "下载成功"
  // }, { // 场景三： 上传失败- 服务端错误
  //   "statusCode": "fail",
  //   "transType": "upload",
  //   "uploadId": "73142de80f78423fb17f12098734d6c7",
  //   "downloadId" : "", //当类型为上传时，下载id为""
  //   "isFast": "",
  //   "speed": "",
  //   "progress": 0,
  //   "fileId": "",
  //   "fileName": "IMG_20191102_160941.jpg",
  //   "fileSize": "",
  //   "fileMd5": "",
  //   "downloadPath": "",//当类型为上传时，下载 downloadPath 为""
  //   "failCode": "InsufficientStorageSpace", // 上传失败code-服务端失败 
  //   "failMsg": "云盘剩余存储空间不足"
  // } ,{ // 场景四： 下载失败- 客户端错误
  //   "statusCode": "fail",
  //   "transType": "download",
  //   "uploadId": "",  //当类型为下载时，上传id为""
  //   "downloadId" : "73142de80f78423fb17f12098734d6c7",
  //   "isFast": "",
  //   "speed": "",
  //   "progress": 0,
  //   "fileId": "",
  //   "fileName": "IMG_20191102_160941.jpg",
  //   "fileSize": "",
  //   "fileMd5": "",
  //   "downloadPath": "",// /当类型为下载时，下载失败 downloadPath 不为空
  //   "failCode": "InsufficientDiskSpace", // 下载失败code-客户端失败 
  //   "failMsg": "磁盘剩余存储空间不足"
  // }]
}).catch(e=>{
  console.log("回调传输文件数据失败", e)
})

1. ok.onEcloudProgressUpdate(callback Function)
1. 1.1. 传输任务 callback Function 的返回值
  1. 1.1.1. object.statusCode 的合法值
2. 1.2. 示例代码