下载媒体文件

媒体文件

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

• 音视频

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

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

• 图片

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

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

  • 提交媒体截图作业后生成的图片文件（普通截图、雪碧图和组成雪碧图的原始小图）。详情请参见提交媒体截图作业。

下载地址类型

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

• 存储地址

  • 未配置加速域名时，各媒体文件的下载地址统一为存储地址。更多信息，请参见存储管理。

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

• 加速地址

  当您在点播配置了加速域名后，各媒体文件的下载地址为加速地址。具体操作，请参见域名管理。

下载限制

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

• 配置了访问限制时，通过加速地址下载，会受到配置的Refer防盗链、IP黑名单等策略的限制，与在线播放相同；通过存储地址下载，则不受此限制；

• 使用视频加密，不管通过哪种方式下载，得到的转码输出的文件仍然为加密文件，需要解密后进行播放。更多信息，请参见概述-视频加密；

• OSS存储如设置私有，则地址存在时效性，下载时要注意可能会过期，此时需要重新获取，建议设置较长有效期；

• CDN加速域名如开启了URL鉴权，则地址会在一段时间后过期，此时需要重新获取，建议设置较长有效期。

通过控制台获取下载地址

• 查看

  登录视频点播控制台，在点播控制台左侧的导航栏选择媒资库，单击音/视频或图片，进入音/视频或图片页面，在音视频或图片页面单击要查看的文件右侧的管理。在详情页中单击复制，即可获取下载地址。

• 导出

  • 音视频转码输出文件：

    登录视频点播控制台，在点播控制台左侧的导航栏选择媒资库，单击音/视频，进入音视频页面，通过单击右上角图标导出媒体地址，获取当前筛选条件下的前200条音视频对应的转码输出文件下载地址（各个清晰度）。

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

    登录视频点播控制台，在点播控制台左侧的导航栏选择媒资库，单击图片，进入图片页面，通过单击右上角图标导出媒体地址，获取当前筛选条件下的前100条图片对应的文件下载地址。

通过API/SDK获取下载地址

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

调用方式：

• 推荐使用服务端SDK调用API来获取媒资信息，更为简单、高效。更多信息，请参见使用说明，API详情可参考各API文档的SDK示例。

• 您也可以参见请求结构，来生成HTTP/HTTPS请求。

客户端下载

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

下载设置

您可以登录视频点播控制台，在点播控制台左侧的导航栏选择配置管理，单击分发加速配置 > 下载设置，进入下载设置页面，在下载设置页面中设置离线下载的方式。具体操作，请参见下载设置。

• 普通下载的音视频文件不会被加密，可拷贝，也可使用任意播放器播放，请谨慎使用。

• 安全下载的音视频文件会使用生成的密钥文件进行加解密，保障视频安全。需要使用阿里云播放器SDK完成解密播放，点播控制台提供了加密私钥的生成工具。

播放器SDK

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