全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
视频点播

使用说明

更新时间:2017-11-02 18:37:51

简介

播放SDK提供了播放视频点播服务中托管视频的功能,包含视频播放控制、清晰度切换、全屏播放、音量调节、离线断点下载、视频加解密,边播边下缓存、倍数播放等核心功能。详细产品介绍

播放器SDK:点击下载

功能说明

功能 描述
播放控制 支持开始、停止、暂停、继续等视频播放控制功能
视频seek 支持视频拖动到某一个时间点进行播放,支持获取当前播放进度、载入进度和视频时长
清晰度切换 上传视频到点播平台后可以根据设置的清晰度进行转码,播放器可以选择不同清晰度进行播放
设置视频显示模式 可支持按视频的原始比例或者占满全屏填充
播放器回调 支持播放器开始、暂停、清晰度切换等多种状态回调满足复杂的播放场景
离线断点下载 支持多视频离线断点下载,保存到指定目录
视频加解密 支持在服务端对视频进行加密,通过SDK解密播放,保证视频仅能通过唯一的App进行播放
边播边下缓存 开启缓存功能后,被完整播放的视频可以缓存到本地,循环播放时直接播放本地文件,减少网络带宽使用
倍速播放 支持0.5~2倍的变速播放,支持音频变速不变调
多语言 支持多语言配置,默认提供中英文,用户可以自定义

播放流程

方式1. 通过获取播放凭证完成视频播放

流程:服务端获取播放凭证 -> 将播放凭证下发给客户端 -> 完成视频播放。

  • 获取播放凭证

客户在服务器侧通过调用播放鉴权SDK,向视频点播服务获取播放凭证。

注意:播放凭证时效为100秒,只能用于获取指定视频的播放地址,不能混用或重复使用;如果凭证过期则无法获取播放地址,请重新获取凭证。

  • 完成视频播放

播放器SDK根据视频ID和播放凭证向视频点播服务获取视频的播放地址,从而加载视频流并解码完成播放。

注意:播放器SDK根据播放凭证会自动获取播放地址进行解码播放,播放地址的时效为30分钟,若失效请重新获取播放凭证回传给播放器SDK用于刷新播放地址。

方式2.通过匿名方式播放,即直接通过url地址播放(满足安全性要求低,需要分享视频的场景)

流程:向播放器SDK提供播放url->播放器SDK发起播放请求->完成视频播放。

注意:播放地址通过自己部署应用Server下发给播放SDK,请参考openApi中获取视频地址的接口。

客户端上传并播放流程说明

流程:用户App获取上传凭证 -> 服务端下发上传凭证 -> 用户上传视频并获取vid -> 服务端获取播放凭证 -> 将播放凭证下发给客户端 -> 完成视频播放。

播放流程

注意:AppServer为用户App的服务端,需要用户自行开发。

安全下载说明

概念说明:安全下载是指将视频文件通过私钥进行二次加密,下载后在SDK内部完成视频解密,保障离线视频仅能通过唯一应用(安全下载中设定的bundleID或keystore)进行安全播放的一种下载方式。

使用场景:终端用户有离线观看视频的需求,并且需要保护视频版权,防止视频被盗用的情况下,可将离线下载设置为安全下载。设置安全下载后,离线下载的视频仅能通过在点播控制台设定的唯一应用并且集成点播播放器SDK来播放,确保视频文件被盗用的情况下别的应用也无法播放,让离线视频更加安全。

具体流程和设置方法如下:

在点播控制台全局设置-下载设置里面设置为安全下载->填写应用的bundleID或keystore的SHA1->生成并下载加密私钥文件->在SDK内集成并调用setEncrptyFile/setSecretImagePath设置加密私钥文件路径

控制台下载加密私钥参考: 控制台

离线视频加密私钥说明:加密私钥为一个二进制文件,是根据您输入的APP唯一标识和自定义加密私钥字符串(长度在16-32之间、可由英文字符和数字自由组合),利用私有算法生成并提供下载。

详细流程如下:

安全下载

备注:用户使用安全下载后,必须从控制台下载秘钥文件并集成在SDK里面。这样下载的视频不论是否是加密流,在本地都会存储为加密视频。如果使用普通下载,则无论是否是加密流,在本地都会存储为非加密视频,可以用任意播放器观看。

概念和说明

  • 播放凭证

    每个播放凭证都绑定了用户的身份标识,不同用户的播放凭证不能互换,否则无法正常播放视频。另外,播放凭证是有时效性的。具体参数获取方法查看文档 获取播放凭证

    客户端开发也可以通过python脚本获取播放凭证进行调试,具体流程如下:

    • 安装python2.7+pip环境(Mac环境下自带,Windows环境自行安装)
    • 使用终端安装SDK,运行以下命令:
      1. pip install aliyun-python-sdk-core
      2. pip install aliyun-python-sdk-vod
    • 下载Python脚本,从阿里云控制台获取accessKeyId和accessKeySecret并替换脚本里面的字段内容,从点播控制台获取已经上传视频的videoID并替换脚本里面的字段内容。
    • 在python脚本所在目录下通过终端执行以下命令:
      1. python playAuth.py
    • 在终端中查看获取的PlayAuth和VideoId。
    • 在播放器SDK中使用获取的PlayAuth和VideoId进行播放,注意PlayAuth的时效为100秒,如果过期请重新获取。
  • 现提供了3种终端的播放器SDK:

    • Web:包括Flash和H5,可以分别集成到PC的浏览器和移动端的浏览器中,开发语言JavaScript。

    • iOS:提供了带标准UI和不带UI的两个版本及Demo,可以集成到iOS系统的APP中,开发语言Object-C。

    • Android:提供了带标准UI和不带UI的两个版本及Demo,可以集成到Android系统的APP中,开发语言Java。

本文导读目录