API文档

1.初始化DOM

• 为了承载相关功能需要在html或者相关页面模板中准备一系列dom元素 具体如下

<input type="file" id="upload"/> <!--文件上传域 -->
<input type="text" id='rename'> <!--用于承载文件名称的input 可用于修改上传文件标题 若用不到可设置为隐藏 -->
<button id="confirm" class="saveBtn">保存</button>  <!--上传成功后用于保存文件的按钮 -->

2.生成鉴权信息

• 调用具体的方法之前首先需要开发者在服务端采用规定的方法生成鉴权信息 具体生产方法请参照

API鉴权方案

3.初始化配置

• 调用 vhallCloudDemandSDK() 方法实例化上传功能

vhallCloudDemandSDK('#upload',{
            params: {
                confirmBtn:'#confirm', //保存按钮
                name:'#rename',//用于修改文件名称的input
                sign:signTag.str, //生成的鉴权信息
                signed_at:signTag.time, //鉴权信息生成的时间戳
                app_id:appId //用户的appid
            },
            ready: function() {
                /**
                  * 初始化完成的回调函数
                **/
            },
            beforeUpload:function() {
                /**
                  * 准备中...（文件进行MD5转换过程）
				  * 可以已loader形式展现该过程
                **/
            },
            progress:function(percent, file){
                /**
                 * 上传中...'
                 * 'percent 上传进度百分比'
                 * 'file 上传文档具体信息
               **/
            },
            uploadSuccess: function(res){
                /**
                 * 上传成功!'
               **/
            },
            saveSuccess:function(res) {
               /**
                 * 点击保存按钮后保存成功'
				 * res返回record_id
               **/
            },
            error: function(msg,file,e){
                /**
                  * 上传出错'
                  * 'msg 错误返回的状态码信息'
                **/
            }
        })

4.文件上传

• 完成上述步骤后，即完成所有的上传接口调用。当用户选择上传文件后，将通过相关事件触发相关回调并完成文件的上传。

5. 断点续传

• 当文件上传中断后，用户只需重新选择文件提交即可恢复上传。

6. 其他

• 参数说明

• 初始化配置错误状态码对应信息参见消息体