有奖捉虫:云通信与企业服务文档专题,速来> HOT
媒体上传是指用户将视频、音频、封面图片等媒体文件上传到云点播的存储中,以进行后续的处理和分发等。

上传方式

云点播支持以下几种上传方式:
上传方式
说明
在云点播控制台上传页面进行操作,将本地媒体文件上传到云点播。适用于开发者直接管理少量媒体的场景,具有方便快捷、无技术门槛的优点。
在云点播控制台上传页面进行操作,指定待上传媒体的 URL,由云点播后台进行离线拉取。
开发者将存储在其后台服务器中的媒体文件上传到云点播,适用于自动化、系统化的生产环境。云点播提供了以下编程语言的服务端上传 SDK:
Java SDK
C# SDK
终端用户将客户端本地视频上传到云点播,适用于 UGC、PGC 等场景。云点播提供了以下平台的客户端上传 SDK:
使用云点播提供的服务端 API 拉取上传接口,指定待上传媒体的 URL,由云点播后台进行离线拉取。适用于大量或自动化的媒体文件迁移场景。
通过云直播提供的录制功能,将直播流的视频内容存储到云点播,以进行存档、剪辑和回看等。

存储地域

已支持地域列表

云点播在全球多个地域有存储节点,媒体上传过程中会选择其中一个地域进行存储。云点播目前支持的存储地域如下:
存储地域
地域英文简称
北京
ap-beijing
上海
ap-shanghai
广州
ap-guangzhou
重庆
ap-chongqing
天津
ap-beijing-1
南京
ap-nanjing
成都
ap-chengdu
中国香港
ap-hongkong
中国台北
ap-taipei
新加坡
ap-singapore
印度孟买
ap-mumbai
印度尼西亚雅加达
ap-jakarta
韩国首尔
ap-seoul
泰国曼谷
ap-bangkok
日本东京
ap-tokyo
美国硅谷(美西)
na-siliconvalley
美国弗吉尼亚(美东)
na-ashburn
巴西圣保罗
sa-saopaulo
加拿大多伦多
na-toronto
德国法兰克福
eu-frankfurt

开通存储地域

多存储地域的一个重要作用是提升媒体上传质量(成功率和速度)。上传者与存储节点的距离对上传质量有影响,一般来说近距离的上传质量要优于远距离。
开发者开通云点播服务后,云点播会自动分配重庆存储地域。开发者可以根据业务需要开通其它的存储地域,具体操作请参见 上传存储设置存储地域一旦开通将无法关闭

默认存储地域

开发者已有的存储地域中,有且仅有一个将作为默认存储地域。如果开发者仅有1个存储地域(即重庆),那么它将是默认存储地域;如果开发者开通了多个存储地域,那么可以在控制台选择其它地域作为默认存储地域。具体操作请参见 存储地域设置
默认存储地域的作用:在某些场景下,优先选择该地域作为媒体上传的目标地域。具体说明请阅读下文。

选择存储地域

媒体上传时需要选择一个存储地域,默认由云点播后台自动选择,也可以由开发者在上传请求中指定。
当云点播后台自动选择存储地域时:
如果开发者仅有1个存储地域(即重庆),那么所有上传的媒体都会存储在该地域。
如果开发者开通了多个存储地域,那么各种上传方式的选择策略如下:
上传方式
地域选择策略
控制台本地上传
根据上传者地理位置,就近选择存储地域
控制台拉取上传
固定选择默认存储园区
服务端上传
根据上传者地理位置,就近选择存储地域
客户端上传
根据上传者地理位置,就近选择存储地域
API 拉取上传
固定选择默认存储园区
直播录制
根据直播推流所在地域,就近选择存储地域
当开发者指定存储地域时,各种上传方式的指定方法如下:
上传方式
地域指定方法
控制台本地上传
不支持
控制台拉取上传
不支持
服务端上传
Java SDK
C# SDK
PHP SDK
Go SDK
客户端上传
API 拉取上传
直播录制
不支持

功能与限制

媒体类型

云点播支持上传以下类型的媒体文件:
视频:WMV、RM、MOV、MPEG、MP4、3GP、FLV、AVI、RMVB、TS、ASF、MPG、WEBM、MKV 、M3U8、WM、ASX、RAM、MPE、VOB、DAT、MP4V、M4V、F4V、MXF、QT、OGG。
音频:MP3、M4A、FLAC、OGG、WAV、RA、AAC、AMR。
封面图片:JPG、JPEG、PNG、GIF、BMP、TIFF、AI、CDR、EPS、TIF、HEIF。

事件通知

媒体上传完成后,云点播后台可以将这一事件通知给开发者。事件通知原理请参见 事件通知,配置方法请参见 事件通知配置。 各种上传方式对应的事件通知类型如下:
上传方式
事件通知类型
控制台本地上传
服务端上传
客户端上传
直播录制
控制台拉取上传
API 拉取上传

附属功能

云点播媒体上传支持多种附属功能,包括媒资管理相关、视频处理和事件通知相关、上传控制相关。

媒资管理相关

附带封面:在上传视频的同时附带上传一张图片,该图片将在云点播媒资系统中自动设为该视频的封面。
指定过期时间:在上传时指定该媒体文件的过期时间,当到达指定时间后,云点播后台自动删除该媒体文件及其附属文件(如转码文件、截图等)。
指定分类:在上传后将该媒体文件设置为某个分类。
各种上传方式的支持情况和用法如下表:

视频处理和事件通知相关

自动视频处理:在上传媒体的同时指定一个 任务流,上传完成后,云点播自动执行该任务流。常见的场景有:截取视频首帧图像作为封面、转码和内容审核等。
视频处理事件通知透传字段:如果启用了自动视频处理,在处理完成后,云点播后台发起事件通知时透传该字段给开发者。
上传事件通知透传字段:在上传完成后,云点播后台发起事件通知时透传该字段给开发者。
各种上传方式的支持情况和用法如下表:
功能
控制台本地上传
控制台拉取上传
服务端上传
客户端上传
API 拉取上传
直播录制
自动视频处理
不支持
Java SDK
C# SDK
PHP SDK
Go SDK
不支持
视频处理事件通知透传字段
不支持
不支持
不支持
客户端上传签名 sessionContext 参数
不支持
上传事件通知透传字段
不支持
不支持
不支持
不支持

上传控制相关

断点续传:上传过程如果意外终止(如网络中断、关闭浏览器等),当用户再次尝试上传同一文件时,可以从中断处继续上传,不需要重新上传整个文件。
暂停/恢复上传:上传过程中,用户可以主动暂停,并可主动恢复上传。
取消上传:上传过程中,用户可以主动终止本次上传。
获取上传进度:媒体已上传到云点播部分的大小占比。
分片上传:在上传时将媒体文件切分为多个小分片,分别上传。一方面可以在弱网环境下将网络异常导致的中断影响降低;另一方面可以在高带宽环境中并发上传多个分片,充分利用网络带宽。
各种上传方式的支持情况和用法如下表:
功能
控制台本地上传
控制台拉取上传
服务端上传
客户端上传
API 拉取上传
直播录制
断点续传
不支持
不涉及
不支持
Web SDK
iOS SDK
小程序 SDK
不涉及
不涉及
暂停和恢复上传
不支持
不涉及
不支持
Web SDK
iOS SDK
小程序 SDK 不支持
不涉及
不涉及
取消上传
刷新或关闭浏览器页面
不涉及
不支持
Web SDK
iOS SDK
小程序 SDK 不支持
不涉及
获取上传进度
页面默认显示进度
不支持
不支持
Web SDK
iOS SDK
不支持
不涉及
分片上传
已启用
不涉及
Java SDK
C# SDK
PHP SDK
Go SDK
Web SDK 默认启用
Android SDK 默认启用
iOS SDK 默认启用
小程序 SDK
不涉及
不涉及

限制

媒体文件大小的限制如下:
上传方式
媒体大小限制
控制台本地上传
客户端上传 - Web SDK
60GB
服务端上传
控制台拉取上传
API 拉取上传
48.82TB(50,000GB)
客户端上传 - Android SDK
客户端上传 - iOS SDK
10GB
直播录制
MP4/FLV 格式为48.82TB(50,000GB)
HLS 格式总大小无限制
其它限制取决于 直播录制
文件数量:无限制。