下载媒体文件

简介

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

媒体文件分类

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

音视频

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

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

图片

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

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

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

下载地址类型

获取的媒体文件下载地址，一般为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 字段为图片地址；
• 搜索媒资信息，媒资类型为音视频时，返回结果 Video 和 Audio 对象中的 CoverURL 字段为封面地址，Snapshots 字段为视频截图地址数组，SpriteSnapshots 字段为自动截图处理后的雪碧图地址数组；媒资类型为图片时，返回结果 Image 对象中的 URL 字段为图片地址；
• 查询截图数据，返回结果 MediaSnapshot 对象中的 Snapshots 字段为与 SnapshotType(截图类型) 对应的截图地址数组。

调用方式

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

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

客户端下载

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

下载设置

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

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

播放器SDK

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