文档中心

媒资上传概述

最近更新时间：2024.04.07 16:33:17

首次发布时间：2021.02.23 10:42:36

媒资上传是指将音频、视频、图片等媒体资源上传至视频点播服务，以便进行后续的管理、处理和分发。媒资上传是使用视频点播其它服务（媒资管理、媒体处理、分发加速）的前提。

本文为您介绍媒资上传需要关注的媒资类型和格式、上传方式、上传设置以及上传事件通知等内容。

媒资类型和格式

视频点播将媒体资源分为音视频和素材两类。

音视频

音视频指上传后用于媒资处理和播放的媒体资源。

类型	支持格式	大小限制
视频	MP4、FLV、ASF、RM、RMVB、MPEG、MOV、AVI、FLASH、MPEG-TS(MTS)、M4S、M3U8、Matroska(MKV)、WMV、3GP、TS、MPG、WEBMb、MKV、WM、ASX、RAM、MPE、VOB、DAT、MP4V、M4V、F4V、MXF、QT	单文件大小不超过 20 GB
音频	MP3、M4A、WAV、WMA、AMR、AAC、OGG、FLAC、RA	单文件大小不超过 20 GB

素材

素材指上传后用于封面、水印、贴片或剪辑的媒体资源。

注意

素材不可被转码和播放。

类型	支持格式	大小限制
视频	MP4、FLV、ASF、RM、RMVB、MPEG、MOV、AVI、FLASH、MPEG-TS(MTS)、M4S、M3U8、Matroska(MKV)、WMV、3GP、TS、MPG、WEBM、MKV、WM、ASX、RAM、MPE、VOB、DAT、MP4V、M4V、F4V、MXF、QT	单文件大小不超过 500 MB
音频	MP3、M4A、WAV、WMA、AMR、AAC、OGG、FLAC、RA	单文件大小不超过 50 MB
动图	GIF、WEBP	单文件大小不超过 50 MB
图片	PNG、GPG、JPEG、BMP、TIFF、AI、CDR、EPS、TIF	单文件大小不超过 50 MB
字幕	SRT、VTT、ASS、SSA	单文件大小不超过 50 MB
字体	TTF、FON、TTC	单文件大小不超过 50 MB

上传方式

视频点播提供工具上传和开发上传两类上传方式，以应对不同场景的上传需求。

工具上传

为满足用户快速上传或者在较低门槛的运营场景下上传大文件的需求，视频点播提供界面化的上传工具，具体说明如下：

方式	使用说明	适用场景
视频点播控制台	开通视频点播服务后，在浏览器登录视频点播控制台即可上传。支持本地文件上传，也支持 URL 拉取上传。	适合产品试用和小规模视频上传场景。
PC 上传客户端	需下载并安装 PC 上传客户端。目前仅提供 Windows 客户端，支持本地大文件上传、多文件上传。	适合大文件、长时间上传，以及低门槛的运营场景。

开发上传

为满足开发者的上传需求，视频点播提供 SDK 或 API 的上传方式，具体说明如下：

方式	使用说明	适用场景
客户端上传 SDK	支持 Android、iOS、Web、微信小程序、抖音小程序。推荐开发者在应用服务器集成点播服务端 SDK 用于签发上传凭证，然后下发给客户端。	适合 UGC、PGC、运营后台等终端用户上传场景。
点播服务端 SDK	点播服务端 SDK 封装了获取上传凭证和上传的逻辑，您仅需简单配置就可以将文件从您的应用服务器上直接上传至视频点播服务。目前支持的开发语言为 Java、Python、PHP、Go、Node.js。	适合自动化上传、大批量迁移视频上传等场景。
URL 批量拉取上传	调用将媒体文件从其它平台离线拉取到视频点播。您只需要将 URL 列表发送给视频点播，视频点播的服务端会触发拉取 URL 并上传。适合大规模媒资迁移、自动化同步。	适合文件没有存储在本地服务器或终端，需要通过公网访问的 URL 地址上传的场景。

上传设置

空间上传设置

视频点播支持空间级别的上传设置。设置后，无论您采用何种上传方式，只要是上传至该空间的音视频资源，均会自动触发相应的设置。空间上传设置的操作步骤请参见上传存储设置。具体说明如下表所示。

上传设置	说明
自动生成封面	支持以下设置：自动截取第一帧非黑帧图片作为封面图。根据视频内容，智能截取最多 8 张图作为封面候选。注意自动生成封面会影响上传速度，分辨率越高，耗时越久，建议仅在需要时开启。
自动提取视频元信息	支持以下设置：选择视频元信息提取方式：同步+异步提取：优先同步提取，仅在极少数同步提取超时的情况下采用异步提取，适用于上传完成后需要立即获取媒资信息的场景。异步提取：采用全异步提取的方式，适用于对上传速度要求较高的场景。设置自动提取存储类型为低频存储和归档存储的视频元信息并设置文件 `content-type`。提取视频 MD5 值。注意提取 MD5 值需要下载完整视频，可能影响上传速度，建议仅在需要时开启。
自动触发默认工作流	可在指定默认工作流的基础上，设置自动触发默认工作流。
自动设置视频状态	自动发布音视频资源。状态为已发布的音视频才可获取到播放地址。
覆盖上传	设置上传具有相同文件路径的新媒资文件，替换之前上传的旧媒资文件。注意覆盖上传可能导致图床安全风险，如果没有适当的安全措施和权限管理，可能被攻击者滥用为注入恶意内容或删除重要文件的方式，请谨慎评估后开启。

单次上传设置

视频点播支持多种上传时的设置，涉及媒资管理、媒体处理、上传控制、回调等功能。各方式支持的上传设置详情如下：

模块	功能	说明	控制台上传	PC 上传客户端	客户端上传 SDK	点播服务端 SDK	URL 批量拉取上传
媒资管理（上传时）	设置媒资名称	上传时设置音视频、素材的名称。	支持	支持	支持	支持	支持
	设置视频分类	提前创建好分类后，上传时指定音视频属于某个分类。	支持	支持	支持	支持	支持
	设置视频标签	上传时设置音视频的标签。	不支持	不支持	不支持	支持	支持
	设置视频封面	上传时指定某个时间点的视频帧截图作为视频封面。	不支持	不支持	支持	支持	支持
媒体处理	不转码	直接上传不转码。	支持	支持	支持	支持	支持
媒体处理	指定工作流转码	上传时指定一个工作流模板。上传完成后，自动执行该工作流。指定工作流优先级高于空间默认工作流。	支持	不支持	支持	支持	支持
上传控制	获取上传进度	获取上传进度或状态。	支持	支持	支持	仅 Java SDK 支持	支持
	暂停/恢复/停止上传	上传过程中，用户可以主动暂停、恢复或终止上传。	不支持	不支持	支持	不支持	不支持
	分片上传	将待上传的文件切分成多个片段（Part）分别上传。上传完成后，这些片段将被组合成一个完整的 Object。	支持，默认开启	支持，默认开启	默认启用	默认启用	默认启用
	断点续传	如果上传过程中遇到网络错误导致上传失败，可从最后一个成功上传的片段开始继续上传。	不支持	支持，默认开启	支持，调用 API 开启	不支持	不支持
回调	上传事件通知透传字段	上传完成后，视频点播后台通过上传完成事件透传该字段给开发者。	不支持	不支持	支持	支持	支持

上传事件通知

上传完成后，您可通过事先配置的回调地址及时获取上传的进展和状态。视频点播支持 HTTP/HTTPS 回调。了解回调配置请参见事件通知概览。视频点播当前支持的上传相关事件如下表所示。

事件名称	事件类型	说明
媒资上传完成事件	FileUploadComplete	点播服务端接收完上传的音视频资源后，会产生 FileUploadComplete 事件。说明由于元信息提取是异步的，上传完成时不一定能返回完整的元信息。因此如需获取完整的元信息，请使用提取元信息完成事件。
素材上传完成事件	MaterialUploadComplete	点播服务端接收完上传的素材后，会产生 MaterialUploadComplete 事件。
URL 批量拉取上传完成事件	FileUploadByUrlComplete	调用 UploadMediaByUrl 接口后，点播服务端拉取每个 URL 上传完成后，会产生 FileUploadByUrlComplete 事件。
媒资上传提取元信息完成事件	UploadGetMetaComplete	点播服务端抽取完上传的音视频资源的元信息后，会产生 UploadGetMetaComplete 事件。

Vid 模式和 DirectUrl 模式说明

默认情况下，音视频资源上传至点播服务后，点播服务会自动生成一个 Vid，用于媒资生命周期管理或媒体处理。对于习惯使用标准对象存储的用户，视频点播还提供 DirectUrl 模式，以文件路径 FileName 作为音视频资源在点播存储桶中的唯一标识。更多信息，请见 Vid 模式与 DirectUrl 模式的全链路说明。

上传之后

媒资上传完成后可使用的视频点播功能及注意事项如下：

功能模块	说明
媒资管理（上传后）	音视频资源上传至点播服务之后，默认为未发布状态，此时无法获取到播放地址。因此在音视频播放前，您需要先修改音视频状态为已发布。具体操作请参见修改音视频发布状态。上传完成后，可管理媒体文件，如音视频源文件、转码后的文件等。
媒体处理	可对上传的音视频资源进行转码、画质增强、截图、AI 处理等操作。
音视频播放	对于上传到点播的音视频资源，您可通过点播控制台预览、集成视频点播播放器 SDK 或获取播放地址在任意播放器进行播放。