下载媒体文件 - 视频点播

视频点播支持将存储在视频点播里的媒体文件下载到本地磁盘或其它存储上，提供了控制台、客户端和接口用于查询各种媒体文件的下载地址。本文为您介绍媒体文件、下载地址类型、下载限制和获取方法。

媒体文件

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

音视频
- 源文件：上传至点播的音视频源文件；
- 转码输出文件：下载转码输出的流文件（某个清晰度）。
图片
- 上传至点播的图片文件；
- 经视频点播自动截图处理后生成的图片文件（封面截图和雪碧图）；
- 提交媒体截图作业后生成的图片文件（普通截图、雪碧图和组成雪碧图的原始小图）。

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

存储地址
- 未配置CDN加速域名时，各媒体文件的下载地址统一为存储地址。存储地址更多信息，请参见存储管理。
- 配置CDN加速域名时，各媒体文件的下载地址统一为CDN加速地址。其中，源文件和转码输出文件下载地址支持强制返回源站地址，具体参考文档获取源文件信息和获取视频播放地址，调用以上接口时，需要设置OutputType值为oss。当您的视频存储地址为输入bucket时（bucket名称以in-开头），配置CDN加速域名的情况下，源文件下载地址仍然为存储地址。
加速地址
当您在点播配置了CDN加速域名后，各媒体文件的下载地址为CDN加速地址。配置CDN加速域名具体操作，请参见域名管理。

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

查看
- 音视频源文件和转码输出文件下载地址：
  在点播控制台>媒资库>音视频页面，单击要查看的文件右侧的管理。
  在视频地址页面中单击复制地址，即可复制文件的下载地址；支持复制原文件和各个清晰度的转码输出文件的下载地址。
- 上传至点播的图片文件下载地址：
  在点播控制台>媒资库>图片页面，单击要查看的文件右侧的管理。
- 在图片详情页面中，单击复制，即可复制图片链接。
导出
- 音视频转码输出文件：
  在点播控制台>媒资库>音视频页面，通过单击右上角图标导出媒体地址，获取当前筛选条件下的前200条音视频对应的转码输出文件下载地址（各个清晰度）。
- 上传至点播的图片文件：
  在点播控制台>媒资库>图片页面，通过单击右上角图标导出媒体地址，获取当前筛选条件下的前100条图片对应的文件下载地址。

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

获取信息	描述	参考文档
源文件地址	返回结果Mezzanine对象中的`FileURL`字段为源文件地址。	获取源文件信息
播放信息	返回结果PlayInfo对象中的`PlayURL`字段为转码输出流地址。	获取视频播放地址
视频信息	返回结果Video对象中的`CoverURL`字段为封面地址，`Snapshots`字段为自动截图处理后截图地址数组。	获取视频信息
图片信息	返回结果ImageInfo对象中的`URL`字段为图片地址。	获取图片信息
媒资信息	媒资类型为音视频时，返回结果Video和Audio对象中的`CoverURL`字段为封面地址，`Snapshots`字段为视频截图地址数组，`SpriteSnapshots`字段为自动截图处理后的雪碧图地址数组；媒资类型为图片时，返回结果Image对象中的`URL`字段为图片地址。	搜索媒体信息
截图数据	返回结果MediaSnapshot对象中的`Snapshots`字段为与`SnapshotType`（截图类型）)对应的截图地址数组。	查询截图数据

调用方式：

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

下载设置

您可以在控制台的下载设置页面中设置离线下载的方式。具体操作，请参见下载设置。

播放器SDK

iOS和Android播放器SDK同时支持客户端下载和缓存功能，具体操作，请参见iOS播放器功能使用和Android播放器功能使用。