uploader
Uploader模块管理网络上传,用于从本地上传各种文件到网络,支持跨域访问操作。通过plus.uploader可获取上传管理对象。
方法:
对象:
回调方法:
权限:
permissions
"Uploader": {
"description": "管理上传任务"
}
Upload
Upload对象用于管理单个上传任务
属性:
方法:
UploadState
上传任务的状态,Number类型
属性:
-
0: 初始状态,在创建之后触发此状态事件,上传任务处于可调度状态
-
1: 上传任务开始处理,开始建立网络连接
-
2: 上传任务请求已经接收,网络连接已建立
-
3: 上传任务请求处理中,上传过程中不断触发
-
4: 上传任务已完成(成功或失败)
-
5: 上传任务暂停状态,可重新开始
-
-1: 非任务状态,用于enumerate()和clear()操作所有上传任务
UploadOption
JSON对象,创建上传任务的参数
属性:
-
method: 网络请求类型,必须是http协议的“POST”
-
blocksize: 上传任务每次上传的文件块大小(仅在支持断点续传的服务有效),单位为字节,默认值为102400,若设置值小于等于0则表示不分块上传
-
priority: 上传任务的优先级,数值越大优先级越高
-
timeout: 上传任务超时时间,单位为s,默认为120s
-
retry: 上传任务重试次数,默认为3次
UploadFileOption
JSON对象,创建上传文件选项的参数
属性:
UploadCompletedCallback
上传任务完成时的回调函数
void uploadCompleted( Upload upload, Number status ) {
// File upload completed code.
}
说明:
在上传任务完成时调用,上传任务失败也将触发此回调。
参数:
-
upload: ( Upload ) 必选 上传任务对象
-
status: ( Number ) 必选 Http传输协议状态码
如果未获取传输状态则其值则为0,如上传成功其值通常为200。
返回值:
void : 无
UploadStateChangedCallback
上传任务状态变化回调函数,在上传任务状态发生变化时调用
void onStateChanged( Upload upload, status ) {
// Upload state changed code.
}
参数:
-
upload: ( Upload ) 必选 上传任务对象
-
status: ( Number ) 必选 Http传输协议状态码
如果未获取传输状态则其值则为0,如上传成功其值通常为200。
返回值:
void : 无
UploadEnumerateCallback
枚举上传任务回调函数,在枚举上传任务完成时时调用
void onEnumerated( Upload[] uploads ) {
// Upload enumerate completed code.
}
参数:
-
uploads: ( Upload ) 必选 枚举到的上传任务对象数组
返回值:
void : 无