有奖捉虫:办公协同&微信生态&物联网文档专题 HOT
本文针对音视频平台常见的长视频播放场景,推出播放器播放长视频教程。用户将掌握如何在 Web 端、iOS 端、Android 端播放器上播放视频,同时开启 KEY 防盗链、自动切换自适应码流、预览视频缩略图、添加视频打点信息。

学习目标

学习本阶段教程,您将掌握:
如何在云点播设置 KEY 防盗链,实现有效时间、播放人数、播放时长等控制。
如何在云点播转出自适应码流(播放器能够根据当前带宽,动态选择最合适的码率播放)。
如何在云点播设置视频打点信息。
如何在云点播使用雪碧图做缩略图。
如何使用播放器进行播放。
阅读之前,请先确保已经学习播放器指引的 阶段1:用播放器播放视频 篇部分,了解云点播 FileId 的概念。

操作步骤

步骤1:开启 KEY 防盗链

以您账号下的默认分发域名开启 KEY 防盗链为例:
注意:
请避免直接对生产环境的现网域名开启防盗链,否则可能造成现网的视频无法播放。
1. 登录云点播控制台 > 应用管理,单击目标应用名称进入应用管理页,在左侧导航栏选择分发播放设置 > 域名管理,进入设置页面。



2. 单击“访问控制”页签,找到Key 防盗链,单击灰色按钮开启,在弹出的设置页面单击随机生成来生成一个随机的 Key,然后单击确定保存生效。







步骤2:转出自适应码流与雪碧图

本步骤,我们将指导您如何对视频转出自适应码流与雪碧图。
1. 进入目标应用管理页后,在左侧导航栏选择媒体处理设置 > 模板设置,进入“转自适应码流模板”页单击创建转自适应码流模板



通过模板创建用户需要的自适应码流,本文创建一条名为 testAdaptive 的自适应码流模板,总共包含三条子流,分辨率分别为480p,720p和1080p。视频码率、视频帧率、音频码率则保持与原视频一致。



2. 选择媒体处理设置 > 模板设置 > 截图模板,单击创建截图模板



通过模板创建用户需要的雪碧图,本文创建一个名为 testSprite 的雪碧图模板,采样间隔为5%,小图行数:10,小图列数:10。



3. 通过任务流,添加自适应码流模板与雪碧图模板。 选择媒体处理设置 > 任务流设置,单击创建任务流



通过任务流,添加用户需要处理的任务,本文为展示播放自适应码流过程,创建了一条 testPlayVideo 的任务流,该任务流仅增加了自适应码流模板和雪碧图模板。



4. 选择媒资管理 > 音视频管理,勾选需要处理的视频(FileId 为 387xxxxx8142975036),单击任务流,选择任务流模板,发起任务。



5. 至此,我们可以在任务中心中,查看任务执行情况,完成后获取任务结果。




步骤3:增加视频打点信息

本步骤,我们将指导您新增的一组视频打点信息。
1. 进入云点播服务端 API 文档 > 媒资管理相关接口 > 修改媒体文件属性,单击点击调试,进入云 API 控制台进行调试。




2. 通过参数名称 AddKeyFrameDescs.N 添加指定视频打点信息。


至此您已经完成了在云端上的操作,此时您在云点播已经转出自适应码流,视频雪碧图和添加了相关视频打点信息。
注意:
该功能仅支持桌面端浏览器。
在浏览器劫持视频播放的情况下,该功能无法使用。

步骤4:生成播放器签名

本步骤,我们使用签名工具快速生成播放器签名,用于播放器播放视频。
1. 进入目标应用管理页后,在左侧导航栏选择分发播放设置 > 播放器签名工具,填写如下信息:
视频 fileId:填写 步骤2 使用的 FileId(387xxxxx8142975036)。
签名过期时间戳:播放器签名过期时间,不填表示签名不过期。
可播放的视频类型:选择“转自适应码流(不加密)”。
可播放的自适应码流模板:选择 testAdaptive (1429229)
用于缩略图预览的雪碧图:选择 testSprite (131353)
防盗链&加密配置开关打开,配置如下:
链接过期时间:设置获取的播放链接的防盗链签名过期时间。
最多可播放 IP 数:设置最多允许多少个 IP 不同的终端播放。
2. 单击生成签名结果,得到签名结果字符串。




步骤5:播放器端集成

经过步骤4,我们得到播放视频所需的三个参数:appIdfileId以及播放器签名(psign) 本步骤,我们将指导您在 Web 端、iOS 端、Android 端播放器播放自适应码流、添加缩略图与打点信息。
Web 端
iOS 端
Android 端
用户需要集成视立方播放器请参见 集成指引,引入播放器 SDK 文件之后,使用 appIdfileId以及播放器签名(psign)进行播放。
播放器的构建方法为TCPlayer, 通过其创建播放器实例即可播放。

1. 在 html 文件放置播放器容器

在需要展示播放器的页面位置加入播放器容器。例如,在 index.html 中加入如下代码(容器 ID 以及宽高都可以自定义)。
<video id="player-container-id" width="414" height="270" preload="auto" playsinline webkit-playsinline>
</video>

2. 使用 fileID 播放

在 index.html 页面初始化的代码中加入以下初始化脚本,传入获取到的 fileID 与 appID 即可播放。
var player = TCPlayer('player-container-id', { // player-container-id 为播放器容器 ID,必须与 html 中一致
fileID: '387xxxxx8142975036', // 要播放的视频 fileID
appID: '1400329073', // 要播放视频的点播账号 appID
psign:'psignxxxx' // psign 即播放器签名,签名介绍和生成方式参见链接:https://cloud.tencent.com/document/product/266/42436
});
用户需要集成视立方播放器请参见 集成指引,集成完后,使用 appIdfileId以及播放器签名(psign)进行播放。
播放器主类为SuperPlayerView,创建后即可播放视频:
// 引入头文件
#import <SuperPlayer/SuperPlayer.h>

// 创建播放器
_playerView = [[SuperPlayerView alloc] init];
// 设置代理,用于接受事件
_playerView.delegate = self;
// 设置父 View,_playerView 会被自动添加到 holderView 下面
_playerView.fatherView = self.holderView;

使用 fileId 播放

SuperPlayerModel *model = [[SuperPlayerModel alloc] init];
model.appId = 1400329073;// 配置 AppId
model.videoId = [[SuperPlayerVideoId alloc] init];
model.videoId.fileId = @"387xxxxx8142975036"; // 配置 FileId
// pSign 即播放器签名,签名介绍和生成方式参见链接:https://cloud.tencent.com/document/product/266/42436
model.videoId.pSign = @"psignxxxx";
[_playerView playWithModelNeedLicence:model];
[_playerView playWithModel:model];
集成视立方播放器请参考集成指引 ,集成完后,使用 appIdfileId以及播放器签名(psign)进行播放。
播放器主类为SuperPlayerView,创建后即可播放视频:

1. 在布局文件创建SuperPlayerView

<!-- 播放器-->
<com.tencent.liteav.demo.superplayer.SuperPlayerView
android:id="@+id/superVodPlayerView"
android:layout_width="match_parent"
android:layout_height="200dp" />

2. 使用 fileId 播放

//在布局文件引入SuperPlayerView ,然后创建实例
mSuperPlayerView = (SuperPlayerView) findViewById(R.id.superVodPlayerView);

SuperPlayerModel model = new SuperPlayerModel();
model.appId = 1400329073;// 配置 AppId
model.videoId = new SuperPlayerVideoId();
model.videoId.fileId = "387xxxxx8142975036"; // 配置 FileId
// pSign 即播放器签名,签名介绍和生成方式参见链接:https://cloud.tencent.com/document/product/266/42436
model.videoId.pSign = "psignxxxx";

mSuperPlayerView.playWithModel(model);

总结

至此,您就可以在播放器播放开启了 KEY 防盗链的点播账号下的媒体文件,查看雪碧图预览、视频打点信息和自动切换动态自适应码流。 更多播放器功能请参见 功能说明