服务端上传,是指直接通过 AppServer 将视频文件上传到视频点播,一般用于自动化上传,或视频迁移。本文为您介绍服务端上传的适用场景、上传流程和开发对接等内容。
适用场景
目前支持 2 种场景:
- 直接上传:可以直接将应用服务器上的视频上传到视频点播,适合自动化的、大批量的上传视频。
- URL 批量拉取上传:可以将在其它地方的媒体文件离线拉取上传到点播。您只需要通过 OpenAPI 将 URL 列表发送给视频点播,视频点播的服务器端触发拉取 URL 并上传。适合大规模媒资迁移、自动化同步。
前提条件
已开通 IAM 账号并授权视频点播权限。提前准备账号的 AK/SK,支持主账号、(推荐)子账号。详细操作请参见创建 IAM 子账号并授权。
- (推荐)子账号:在访问控制中创建一个子账号,并授权点播权限后,创建子账号下的 AK/SK。
- 主账号:在访问控制中创建主账号的 AK/SK。
注意
主账号拥有账号下全部权限,若泄漏可能给您的服务带来很大风险,不推荐直接使用主账号 AK/SK 调用服务。
上传流程
由于 AppServer 拥有 AK/SK,所以可以直接使用 AK/SK 来鉴权。
直接上传
主要流程如下所示。
- App Server 调用点播服务获取上传地址和凭证服务;
- 视频点播返回上传地址和凭证;
- App Server 发起上传文件请求;
- App Server 发起确认上传请求;
- 视频点播返回上传结果,包括 Vid、FileName 等信息。
Url 批量拉取上传
主要流程如下所示。
- App Server 获取音视频资源存储的在线 Url;
- App Server 调用点播服务发起 Url 批量拉取上传请求。提交成功后:视频点播返回上传任务信息,包括:源 Url 及对应的 JobId 等;
- App Server 通过源 Url 拉取音视频资源;
- 每个 Url 拉取完成后,视频点播发送回调给 App Server。
- App Server 也可以主动调用点播服务查询指定 JobId 上传状态,视频点播返回任务状态和相关信息。
开发对接
媒资上传支持格式、上传相关设置等信息,详见媒资上传概述。
OpenAPI
单个视频/音频上传:
URL 批量拉取上传:
服务端SDK
为方便您的使用,我们提供服务器端 SDK,对鉴权、分片上传等逻辑进行封装,您只需要设定 AK/SK 即可上传。我们提供多语言的服务器端上传 SDK 如下所示。
回调事件
- 如果您的空间配置了视频上传完成回调通知,上传完成后您将收到事件回调通知。回调事件为 媒资上传完成事件。
- 如果您的空间配置了 URL 批量上传完成回调通知,通过 URL 批量拉取上传执行的每个 URL 上传完成后,您将收到事件回调通知。回调事件为 URL 批量拉取上传完成。