全部产品
云市场

下载媒体文件

更新时间:2019-01-21 15:47:45

简介

存储在视频点播里的媒体文件,往往需要下载到本地磁盘或其它存储上,点播服务提供了各种媒体文件下载地址的查询接口,获取到下载地址后即可进行相关下载处理。

媒体文件分类

使用视频点播服务时可能会产生多种可下载的媒体文件,包括源文件、转码输出的流文件、视频截图文件、上传的图片文件等,点播提供了各种媒体文件的查询和下载,包括:

音视频

  • 源文件:上传至点播的音视频原文件;

  • 转码输出文件:下载转码输出的流文件(某个清晰度)。

图片

  • 上传至点播的图片文件;

  • 经视频点播自动截图处理后生成的图片文件(封面截图和雪碧图);

  • 提交媒体截图作业 后生成的图片文件(普通截图、雪碧图和组成雪碧图的原始小图)。

下载地址类型

获取的媒体文件下载地址,一般为OSS源站地址或CDN加速地址,前者会产生 媒资管理(存储) 费用,即OSS外网流出流量的费用;后者会产生CDN流量费用,即视频加速(CDN)的费用。

存储地址

  • 未配置CDN加速域名时,各媒体文件的下载地址统一为存储地址;存储地址参考 控制台-存储管理
  • 配置CDN加速域名时,各媒体文件的下载地址统一为CDN加速地址。其中,源文件和转码输出文件下载地址支持强制返回源站地址,具体参考文档 获取源文件地址获取播放地址,调用以上接口时,需要设置 OutputType 值为 oss。当您的视频存储地址为输入bucket时(bucket名称以in-开头),配置CDN加速域名的情况下,源文件下载地址仍然为存储地址。

加速地址

  • 当您在点播配置了CDN加速域名后,各媒体文件的下载地址为CDN加速地址。配置CDN加速域名参考 控制台-添加域名

下载限制

如果使用了防盗链配置、视频加密等,即便获取到媒体文件的下载地址,在下载媒体时仍可能受到同样的限制。

  • 配置了 访问限制 时,通过CDN加速地址下载,会受到配置的Refer防盗链、IP黑名单等策略的限制,与在线播放相同;通过OSS源站地址下载,则不受此限制;
  • 使用视频加密,不管通过哪种方式下载,得到的转码输出的文件仍然为加密文件,需要解密后进行播放,请参考 视频加密
  • OSS存储如设置私有,则地址存在时效性,下载时要注意可能会过期,此时需要重新获取,建议设置较长有效期;
  • CDN加速域名如开启了URL鉴权,则地址会在一段时间后过期,此时需要重新获取,建议设置较长有效期。

获取下载地址

控制台

查看

  • 音视频源文件和转码输出文件下载地址:在 点播控制台->媒资库->音视频->管理->视频地址复制 原始文件 的下载地址;同时可以 复制 各个清晰度的转码输出文件的下载地址。
  • 上传至点播的图片文件下载地址:在 点播控制台->媒资库->图片->管理->图片详情复制 图片链接

导出

  • 音视频转码输出文件:在 点播控制台->媒资库->音视频 页面,通过 导出媒体地址 获取当前筛选条件下的前200条音视频对应的转码输出文件下载地址(各个清晰度);
  • 上传至点播的图片文件:在 点播控制台->媒资库->图片 页面,通过 导出媒体地址 获取当前筛选条件下的前100条图片对应的文件下载地址。

API/SDK

媒体文件下载包括下载音视频源文件、下载音视频流、下载自动截图文件、下载图片文件。您可以通过以下接口获取到相应的文件地址进行下载。

相关API

  • 获取源文件地址,返回结果 Mezzanine 对象中的 FileURL 字段为源文件地址;
  • 获取播放地址,返回结果 PlayInfo 对象中的 PlayURL 字段为转码输出流地址;
  • 获取视频信息,返回结果 Video 对象中的 CoverURL 字段为封面地址,Snapshots 字段为自动截图处理后截图地址数组;
  • 获取图片信息,返回结果 ImageInfo 对象中的 URL 字段为图片地址;
  • 搜索媒资信息,媒资类型为音视频时,返回结果 VideoAudio 对象中的 CoverURL 字段为封面地址,Snapshots 字段为视频截图地址数组,SpriteSnapshots 字段为自动截图处理后的雪碧图地址数组;媒资类型为图片时,返回结果 Image 对象中的 URL 字段为图片地址;
  • 查询截图数据,返回结果 MediaSnapshot 对象中的 Snapshots 字段为与 SnapshotType(截图类型) 对应的截图地址数组。

调用方式

推荐使用 服务端SDK 调用API来获取下载信息,更为简单、高效,详情可参考各API文档的SDK示例

您也可以参考 公共参数API示例,来生成HTTP/HTTPS请求。

客户端下载

针对移动端的使用场景,阿里云播放器SDK提供了离线下载功能,您可以根据业务需要,通过启用下载功能,允许终端用户将音视频流文件缓存至本地进行观看。离线下载提供两种下载方式:普通下载和安全下载。

下载设置

您可以在 点播控制台-全局设置-下载设置 中设置离线下载的方式。

  • 普通下载的音视频文件不会被加密,可拷贝,也可使用任意播放器播放,请谨慎使用;
  • 安全下载的音视频文件会使用生成的密钥文件进行加解密,保障视频安全。需要使用阿里云播放器SDK完成解密播放,点播控制台提供了加密私钥的生成工具。

播放器SDK

iOSAndroid 播放器SDK同时支持客户端下载和缓存功能,具体实现请参考 iOS文件下载Android文件下载