媒体上传是指用户将视频、音频、封面图片等媒体文件上传到云点播的存储中,以进行后续的处理和分发等。
上传方式
云点播支持以下几种上传方式:
上传方式 | 说明 |
在云点播控制台上传页面进行操作,将本地媒体文件上传到云点播。适用于开发者直接管理少量媒体的场景,具有方便快捷、无技术门槛的优点。 | |
在云点播控制台上传页面进行操作,指定待上传媒体的 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-jakarta |
韩国首尔 | ap-seoul |
泰国曼谷 | ap-bangkok |
日本东京 | ap-tokyo |
美国硅谷(美西) | na-siliconvalley |
美国弗吉尼亚(美东) | na-ashburn |
巴西圣保罗 | sa-saopaulo |
德国法兰克福 | eu-frankfurt |
开通存储地域
多存储地域的一个重要作用是提升媒体上传质量(成功率和速度)。上传者与存储节点的距离对上传质量有影响,一般来说近距离的上传质量要优于远距离。
默认存储地域
开发者已有的存储地域中,有且仅有一个将作为默认存储地域。如果开发者仅有1个存储地域(即重庆),那么它将是默认存储地域;如果开发者开通了多个存储地域,那么可以在控制台选择其它地域作为默认存储地域。具体操作请参见 存储地域设置。
默认存储地域的作用:在某些场景下,优先选择该地域作为媒体上传的目标地域。具体说明请阅读下文。
选择存储地域
媒体上传时需要选择一个存储地域,默认由云点播后台自动选择,也可以由开发者在上传请求中指定。
当云点播后台自动选择存储地域时:
如果开发者仅有1个存储地域(即重庆),那么所有上传的媒体都会存储在该地域。
如果开发者开通了多个存储地域,那么各种上传方式的选择策略如下:
上传方式 | 地域选择策略 |
控制台本地上传 | 根据上传者地理位置,就近选择存储地域 |
控制台拉取上传 | 固定选择默认存储园区 |
服务端上传 | 根据上传者地理位置,就近选择存储地域 |
客户端上传 | 根据上传者地理位置,就近选择存储地域 |
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 拉取上传 | 直播录制 |
断点续传 | 不支持 | 不涉及 | 不支持 | ?Web SDK? ?iOS SDK? 小程序 SDK | 不涉及 | 不涉及 |
暂停和恢复上传 | 不支持 | 不涉及 | 不支持 | ?Web SDK? ?iOS SDK? 小程序 SDK 不支持 | 不涉及 | 不涉及 |
取消上传 | 刷新或关闭浏览器页面 | 不涉及 | 不支持 | ?Web SDK? ?iOS SDK? 小程序 SDK 不支持 | 不涉及 | |
获取上传进度 | 页面默认显示进度 | 不支持 | 不支持 | ?Web SDK? ?iOS SDK? ?小程序 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 格式总大小无限制 其它限制取决于 直播录制服务规则? |
文件数量:无限制。