You need to enable JavaScript to run this app.
导航

服务端上传

最近更新时间2024.01.24 11:35:08

首次发布时间2021.02.23 10:42:37

服务端上传,是指直接通过 AppServer 将视频文件上传到视频点播,一般用于自动化上传,或视频迁移。本文为您介绍服务端上传的适用场景、上传流程和开发对接等内容。

适用场景

目前支持 2 种场景:

  • 直接上传:可以直接将应用服务器上的视频上传到视频点播,适合自动化的、大批量的上传视频。
  • URL 批量拉取上传:可以将在其它地方的媒体文件离线拉取上传到点播。您只需要通过 OpenAPI 将 URL 列表发送给视频点播,视频点播的服务器端触发拉取 URL 并上传。适合大规模媒资迁移、自动化同步。

前提条件

已开通 IAM 账号并授权视频点播权限。提前准备账号的 AK/SK,支持主账号、(推荐)子账号。详细操作请参见创建 IAM 子账号并授权

  • (推荐)子账号:在访问控制中创建一个子账号,并授权点播权限后,创建子账号下的 AK/SK。
  • 主账号:在访问控制中创建主账号的 AK/SK。

注意

主账号拥有账号下全部权限,若泄漏可能给您的服务带来很大风险,不推荐直接使用主账号 AK/SK 调用服务。

上传流程

由于 AppServer 拥有 AK/SK,所以可以直接使用 AK/SK 来鉴权。

直接上传

主要流程如下所示。

  1. App Server 调用点播服务获取上传地址和凭证服务;
  2. 视频点播返回上传地址和凭证;
  3. App Server 发起上传文件请求;
  4. App Server 发起确认上传请求;
  5. 视频点播返回上传结果,包括 Vid、FileName 等信息。

Url 批量拉取上传

主要流程如下所示。

  1. App Server 获取音视频资源存储的在线 Url;
  2. App Server 调用点播服务发起 Url 批量拉取上传请求。提交成功后:视频点播返回上传任务信息,包括:源 Url 及对应的 JobId 等;
  3. App Server 通过源 Url 拉取音视频资源;
  4. 每个 Url 拉取完成后,视频点播发送回调给 App Server。
  5. App Server 也可以主动调用点播服务查询指定 JobId 上传状态,视频点播返回任务状态和相关信息。

开发对接

媒资上传支持格式、上传相关设置等信息,详见媒资上传概述

OpenAPI

单个视频/音频上传:

URL 批量拉取上传:

服务端SDK

为方便您的使用,我们提供服务器端 SDK,对鉴权、分片上传等逻辑进行封装,您只需要设定 AK/SK 即可上传。我们提供多语言的服务器端上传 SDK 如下所示。

回调事件

  • 如果您的空间配置了视频上传完成回调通知,上传完成后您将收到事件回调通知。回调事件为 媒资上传完成事件
  • 如果您的空间配置了 URL 批量上传完成回调通知,通过 URL 批量拉取上传执行的每个 URL 上传完成后,您将收到事件回调通知。回调事件为 URL 批量拉取上传完成