文档

下载媒体文件

更新时间:

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

媒体文件

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

  • 音视频

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

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

  • 图片

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

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

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

下载地址类型

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

  • 存储地址

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

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

  • 加速地址

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

下载限制

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

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

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

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

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

通过控制台获取下载地址

  • 查看

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

  • 导出

    • 音视频转码输出文件:

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

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

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

通过API/SDK获取下载地址

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

获取信息

描述

参考文档

源文件地址

返回结果Mezzanine对象中的FileURL字段为源文件地址。

获取源文件信息

播放信息

返回结果PlayInfo对象中的PlayURL字段为转码输出流地址。

获取视频播放地址

视频信息

返回结果Video对象中的CoverURL字段为封面地址,Snapshots字段为自动截图处理后截图地址数组。

获取视频信息

图片信息

返回结果ImageInfo对象中的URL字段为图片地址。

获取图片信息

媒资信息

媒资类型为音视频时,返回结果VideoAudio对象中的CoverURL字段为封面地址,Snapshots字段为视频截图地址数组,SpriteSnapshots字段为自动截图处理后的雪碧图地址数组;媒资类型为图片时,返回结果Image对象中的URL字段为图片地址。

搜索媒体信息

截图数据

返回结果MediaSnapshot对象中的Snapshots字段为与SnapshotType(截图类型)对应的截图地址数组。

查询截图数据

调用方式:

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

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

客户端下载

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

下载设置

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

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

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

播放器SDK

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

  • 本页导读 (1)
文档反馈