全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
视频点播

客户端上传

更新时间:2017-06-16 10:04:01

概述

用户在Web、iOS、Android终端上传媒体文件到点播,需要集成点播上传SDK。

客户端上传流程

客户端上传

1. 客户端获取上传地址和凭证

用户应用服务器需要使用自己的AccessKey,请求点播上传服务来获取上传地址和凭证,并将结果给客户端。更多信息请参见 上传地址和凭证

2. 用户选择文件

用户选择本地要上传的文件。

3. 添加待上传文件到列表

把用户需要上传的所有文件通过addFile接口添加到列表中。

4. 开始上传

调用start接口就会开始真正的上传进程。

5. 设置上传凭证和地址

在文件上传开始事件OnUploadStarted,调用setUploadAuthAndAddress函数,设置点播上传服务返回的上传凭证和上传地址。注意上传凭证有时效性,如果一次性返回所有文件的上传凭证,要正确处理失效的场景:上传过程中,如果超出了时效范围会有回调通知,需要刷新上传凭证后才能恢复上传。

6. 上传完成事件

包含成功和失败两种事件OnUploadSucceed,OnUploadFailed。

备注:视频点播的上传配置仅要求提供上传凭证(uploadAuth)和上传地址(uploadAddress)即可。

现提供了3种终端的SDK:

  • Web:可以集成到PC的浏览器中,开发语言JavaScript。代码示例见 JavaScript上传SDK
  • iOS:可以集成到iOS系统的APP中,开发语言Object-C。代码示例见 iOS上传SDK
  • Android:可以集成到Android系统的APP中,开发语言Java。代码示例见 Android上传SDK

功能描述

1. 文件列表管理

接口名称 描述
addFile 添加文件到列表中,文件是按照添加的顺序依次上传
deleteFile 从列表中删除文件
cancelFile 取消列表中的单个文件,但是不会从上传列表中删除,效果就是会跳过这个文件的上传(JavaScript版本不支持)
resumeFile 不是恢复上传,只是恢复之前列表中被取消单个文件的状态(JavaScript版本不支持)
listFiles 获取列表
clearFiles 清除列表,即使是上传中的文件,也会停止上传并清除(JavaScript版本不支持)

2. 上传控制

接口名称 描述
start 开始上传
stop 停止上传
pause 暂停上传(JavaScript版本不支持)
resume 恢复上传(JavaScript版本不支持)
resumeUploadWithAuth 上传凭证超时后,使用新的上传凭证来恢复上传
setUploadAuthAndAddress 设置上传地址和上传凭证。每个上传地址和上传凭证是独立的,需要在OnUploadStarted事件中调用,更新当前的上传地址和上传凭证

3. 回调事件

事件名称 描述
OnUploadStarted 每个文件开始上传时都会触发。需要在这里调用setUploadAuthAndAddress设置当前文件的上传地址和上传凭证
OnUploadSucceed 上传成功
OnUploadFailed 上传失败。可恢复型的错误会自动断点续传,例如:网络异常、超时等。不可恢复类型的错误会导致失败,例如:上传凭证错误、文件不存在等
OnUploadProgress 上传进度汇报。在分片上传成功时触发
OnUploadTokenExpired 上传凭证超时。需要从服务重新获取新的上传凭证,并调用resumeUploadWithAuth函数恢复上传
OnUploadRetry 上传过程中,状态由正常切换为异常时触发。例如:网络异常,超时等(JavaScript版本不支持)
OnUploadRetryResume 上传过程中,状态由异常中恢复时触发。(JavaScript版本不支持)
本文导读目录