一. 实践步骤
1. 准备您的 腾讯云COS 视频文件链接,您需要:
1.1 创建一个存储桶;
![](https://ask.qcloudimg.com/developer-images/article/5909132/sowu6yfhiu.png?imageView2/2/w/1620)
1.2 上传对象;
![](https://ask.qcloudimg.com/developer-images/article/5909132/czc6v7126y.png?imageView2/2/w/1620)
1.3 在对象信息详情里复制对象地址;
![](https://ask.qcloudimg.com/developer-images/article/5909132/jnou1srr88.png?imageView2/2/w/1620)
![](https://ask.qcloudimg.com/developer-images/article/5909132/p8f7evh2nv.png?imageView2/2/w/1620)
目前腾讯云有COS特惠活动,新人1元起
2. 在页面中引入播放器样式文件与脚本文件:
<!--播放器样式文件-->
<link href="https://web.sdk.qcloud.com/player/tcplayer/release/v4.2.2/tcplayer.min.css" rel="stylesheet"/>
<!--如果需要在 Chrome 和 Firefox 等现代浏览器中通过 H5 播放 HLS 格式的视频,需要在 tcplayer.v4.2.2.min.js 之前引入 hls.min.0.13.2m.js。-->
<script src="https://web.sdk.qcloud.com/player/tcplayer/release/v4.2.2/libs/hls.min.0.13.2m.js"></script>
<!--播放器脚本文件-->
<script src="https://web.sdk.qcloud.com/player/tcplayer/release/v4.2.2/tcplayer.v4.2.2.min.js"></script>
建议在正式使用播放器 SDK 时,自行部署以上相关静态资(https://web.sdk.qcloud.com/player/tcplayer/release/v4.2.2/release.zip) 部署解压后的文件夹,不能调整文件夹里面的目录,避免资源互相引用异常。
3. 设置播放器容器节点:
在需要展示播放器的页面位置加入播放器容器。例如,在 index.html 中加入如下代码(容器 ID 以及宽高都可以自定义)。
<video id="player-container-id" width="414" height="270" preload="auto" playsinline webkit-playsinline>
</video>
说明:
- 播放器容器必须为
<video>
标签。 - 示例中的
player-container-id
为播放器容器的 ID,可自行设置。 - 播放器容器区域的尺寸,建议通过 CSS 进行设置,通过 CSS 设置比属性设置更灵活,可以实现例如铺满全屏、容器自适应等效果。
- 示例中的
preload
属性规定是否在页面加载后载入视频,通常为了更快的播放视频,会设置为auto
,其他可选值:meta
(当页面加载后只载入元数据),none
(当页面加载后不载入视频),移动端由于系统限制不会自动加载视频。 playsinline
和webkit-playsinline
这几个属性是为了在标准移动端浏览器不劫持视频播放的情况下实现行内播放,此处仅作示例,请按需使用。- 设置
x5-playsinline
属性在 TBS 内核会使用 X5 UI 的播放器。
4. 初始化播放器,并传入 COS 视频文件对象地址 URL:
var player = TCPlayer('player-container-id', {}); // player-container-id 为播放器容器 ID,必须与 html 中一致
player.src(cosObjectUrl); // url 播放地址
二. 具体播放场景
场景一:播放公有读视频文件
存储桶公有读权限包括两种:公有读私有写、公有读写。其中,公有读私有写权限下,任何人(包括匿名访问者)都对该存储桶中的对象有读权限,但只有存储桶创建者及有授权的账号才对该存储桶中的对象有写权限。公有读写权限下,任何人(包括匿名访问者)都对该存储桶中的对象有读权限和写权限,不推荐使用。
播放公有读权限的视频文件的步骤为:
1、将存储桶设置为公有读;
![](https://ask.qcloudimg.com/developer-images/article/5909132/n4qfx47vja.png?imageView2/2/w/1620)
2、上传视频文件后,复制对象地址;
3、结合前面的步骤流程,使用 TCPlayer 播放公有读视频文件地址,代码如下:
<script>
var tcplayer = TCPlayer("player-container-id", {})
tcplayer.src('https://examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com/path/test.mp4')
</script>
4、效果:
![](https://ask.qcloudimg.com/developer-images/article/5909132/e0dny2sd57.png?imageView2/2/w/1620)
场景二:播放私有读视频文件
为了保障存储桶数据的安全性能,一般推荐将存储桶设为私有读写权限。此时只有该存储桶的创建者及有授权的账号才对该存储桶中的对象有读写权限,其他任何人对该存储桶中的对象都没有读写权限。
播放私有读权限的视频文件的步骤为:
1、将存储桶设置为私有读;
![](https://ask.qcloudimg.com/developer-images/article/5909132/yh1u20oo7a.png?imageView2/2/w/1620)
2、由于存储桶为私有读,因此访问的对象地址需要携带上签名,有三种方式:
方法一:在对象信息中复制临时链接,该临时链接携带有效期为1小时的签名参数;
![](https://ask.qcloudimg.com/developer-images/article/5909132/zgawdz0zd6.png?imageView2/2/w/1620)
方法二:利用 COS 签名工具,计算您的对象签名;
方法三:利用 API 或对应 SDK,计算您的对象签名;
以上三种方法中,正式使用时推荐使用方法三的 SDK 签名方式,更加方便安全地计算您的对象签名。
3、结合前面的步骤流程,利用 TCPlayer 播放携带签名的私有读视频文件地址,完整代码如下:
<script>
var tcplayer = TCPlayer("player-container-id", {})
tcplayer.src('https://examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com/path/test.mp4?<Authorization>')
</script>
4、效果:
![](https://ask.qcloudimg.com/developer-images/article/5909132/2b9ukxcovs.png?imageView2/2/w/1620)
场景三:播放公有读 HLS 视频文件
HTTP Live Streaming(HLS)是一个由苹果公司提出的基于 HTTP 的流媒体网络传输协议。是苹果公司 QuickTime X 和 iPhone 软件系统的一部分。它的工作原理是把整个流分成一个个小的基于 HTTP 的文件来下载,每次只下载一些。当媒体流正在播放时,客户端可以选择从许多不同的备用源中以不同的速率下载同样的资源,允许流媒体会话适应不同的数据速率。在开始一个流媒体会话时,客户端会下载一个包含元数据的 extended M3U m3u8playlist 文件,用于寻找可用的媒体流。
对象存储(COS)数据处理提供了 HLS 视频转码的功能。您可以结合 COS 数据工作流转码任务,播放 HLS 视频文件。
1、创建音视频转码任务;
![](https://ask.qcloudimg.com/developer-images/article/5909132/ufd4nfweg8.png?imageView2/2/w/1620)
2、选择系统模版中的任一 HLS 转码任务,配置任务生成 HLS 视频文件;
![](https://ask.qcloudimg.com/developer-images/article/5909132/44faac1z7y.png?imageView2/2/w/1620)
3、复制生成的 m3u8 文件对象地址;
![](https://ask.qcloudimg.com/developer-images/article/5909132/4bxjoienho.png?imageView2/2/w/1620)
4、结合前面的步骤流程,利用TCPlayer播放公有读 HLS 视频文件地址,完整代码如下:
<script>
var tcplayer = TCPlayer("player-container-id", {})
tcplayer.src('https://examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com/path/test.m3u8')
</script>
5、效果:
![](https://ask.qcloudimg.com/developer-images/article/5909132/4jzycul2ad.png?imageView2/2/w/1620)
场景四:播放私有读 HLS 视频文件
在场景三的基础上,为了保证存储桶数据的安全性,我们把存储桶设置为私有读写权限,同时结合 PM3U8 API,进行私有 HLS 视频文件的播放,具体步骤如下:
1、将存储桶设置为私有读;
![](https://ask.qcloudimg.com/developer-images/article/5909132/yh1u20oo7a.png?imageView2/2/w/1620)
2、由于存储桶是私有的,所以需要给每块TS分片设置请求签名。COS提供了 PM3U8 API,让你在请求m3u8文件时,携带上相关的参数?ci-process=pm3u8&expires=3600
,返回的文件中的 TS 分片请求路径就能携带上对应的请求签名。
2.1 普通 m3u8 文件的请求结果如下,ts分片不带签名:
![](https://ask.qcloudimg.com/developer-images/article/5909132/2hagpnmpje.png?imageView2/2/w/1620)
2.2 利用 PM3U8 API,请求的结果如下,ts分片携带签名:
![](https://ask.qcloudimg.com/developer-images/article/5909132/5vwbvkhqsk.png?imageView2/2/w/1620)
2.3 结合前面的步骤流程,利用TCPlayer播放 私有读 HLS 视频文件地址,完整代码如下:
<script>
var tcplayer = TCPlayer("player-container-id", {})
tcplayer.src('https://examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com/path/test.m3u8?ci-process=pm3u8&expires=3600&sign')
</script
2.4 效果:
![](https://ask.qcloudimg.com/developer-images/article/5909132/wgex5eo0po.png?imageView2/2/w/1620)