导航
服务端上传
最近更新时间：2024.06.17 14:05:24首次发布时间：2021.02.23 10:42:37
服务端上传，是指通过应用服务端（App Server）将视频文件上传到视频点播服务，一般用于自动化上传或视频迁移。本文为您介绍服务端上传方式、上传流程和接入指引。
服务端上传方式
视频点播目前支持以下两种服务端上传方式。
直接上传
直接上传是指通过 OpenAPI 和服务端 SDK 直接将应用服务器上的视频上传到视频点播服务。具体流程如下图所示：
流程说明如下：
- 应用服务端调用 ApplyUploadInfo 接口获取上传地址和凭证。
- 视频点播返回上传地址和凭证。
- 应用服务端将媒资上传至视频点播服务。
- 应用服务端调用 CommitUploadInfo 接口确认上传。
- 视频点播返回上传结果，包括 Vid、Mid、FileName 等关键字段。
说明
视频点播服务会为上传的媒资自动创建一个媒资 ID。根据媒资的类型不同，这个 ID 有不同的称呼：
- 对于音视频，这个 ID 被称为视频 ID（Video ID），简称为 Vid。
- 对于素材，这个 ID 被称为素材 ID（Material ID），简称为 Mid。
此外，对于习惯使用标准对象存储的用户，视频点播还提供 DirectUrl 模式，以文件路径 FileName 作为媒资对象在点播存储桶中的唯一标识。更多信息，请见 Vid 模式与 DirectUrl 模式的全链路说明。
- （可选）如您配置了媒资上传完成事件，视频上传完成后，视频点播会发送回调给应用服务器。
URL 批量拉取上传
URL 批量拉取上传是指将存储在第三方服务的媒体文件离线拉取上传到视频点播服务。您只需要将 URL 列表发送给视频点播，视频点播服务端会自动触发拉取 URL 并上传。这种方式可以免去先将文件下载到本地服务器后再上传到视频点播的过程，主要适用于离线搬站场景。
说明
URL 批量拉取上传是异步任务，不保证时效性。一般提交后会在数小时内完成上传。如果对时效性要求较高，建议使用其他上传方式。
具体流程如下图所示：
流程说明如下：
- 应用服务端从原存储服务中获取视频 URL。
- 原存储服务返回视频 URL。
- 应用服务端调用 UploadMediaByUrl 接口提交 URL 批量拉取上传任务。
- 请求提交后，视频点播服务不会即刻返回上传结果，而是返回任务提交结果。如果任务提交成功，视频点播还返回任务信息，包含本次上传的任务 ID。
说明
任务 ID 只在视频点播服务端存储 7 天。
- 视频点播服务通过 URL 从原存储服务拉取视频文件。
- （可选）如果您配置了 URL 批量拉取上传完成事件，每个 URL 拉取完成后，视频点播会发送回调给应用服务器。
- （可选）应用服务端也可主动调用 QueryUploadTaskInfo 接口获取 URL 批量上传结果。
接入指引
为方便您的使用，视频点播提供服务端 SDK，封装了获取上传地址和凭证、分片上传等逻辑。您只需设置 AK/SK 并进行简单配置，即可开始上传媒资。推荐你创建 IAM 子账号，使用子账号的 AK/SK 访问视频点播服务。各语言服务端 SDK 的媒资上传示例代码请见以下文档：