基础知识
本文主要介绍视频云 SDK 的直播播放功能。
直播简介
直播（LIVE）的视频源是主播实时推送的。因此，主播停止推送后，播放端的画面也会随即停止，而且由于是实时直播，所以播放器在播直播 URL 的时候是没有进度条的。
协议的支持
直播协议 | 优点 | 缺点 | 播放延迟 |
FLV | 成熟度高、高并发无压力 | 需集成 SDK 才能播放 | 2s - 3s |
RTMP | 延迟较低 | 高并发情况下表现不佳 | 1s - 3s |
HLS(m3u8) | 手机浏览器支持度高 | 延迟非常高 | 10s - 30s |
WebRTC | 延迟最低 | 需集成 SDK 才能播放 | < 1s |
特别说明
视频云 SDK 不会对播放地址的来源做限制，即您可以用它来播放腾讯云或非腾讯云的播放地址。但视频云 SDK 中的播放器只支持 FLV、RTMP、HLS（m3u8）和 WebRTC 四种格式的直播地址，以及 MP4、HLS（m3u8）和 FLV 三种格式的点播文件。
对接攻略
步骤1：下载 SDK 开发包
步骤2：给 SDK 配置 License 授权
1. 获取 License 授权：
若您已获得相关 License 授权，需在云直播控制台获取 License URL 和 License Key。
若您暂未获得 License 授权，需先参考 新增与续期 License 进行申请。
2. 在您的 App 调用全功能版 SDK 相关功能之前进行如下设置：
import { getV2TXLivePremierShareInstance } from 'liteavsdk';export default class EntryAbility extends UIAbility {onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {let licenseUrl: string = "<获取到的licenseUrl>";let licenseKey: string = "<获取到的key>";getV2TXLivePremierShareInstance(this.context).setLicence(licenseUrl, licenseKey);}}
注意
License 中配置的 bundleName 必须和应用本身一致，否则会播放失败。
步骤3：创建 Player
视频云 SDK 中的 V2TXLivePlayer 模块负责实现直播播放功能。
import { createV2TXLivePlayer, V2TXLivePlayer, V2TXLiveFillMode, V2TXLiveRotation, V2TXLivePlayerObserver } from 'liteavsdk';@Entry@Componentstruct LivePlayer {private player: V2TXLivePlayer | null = null;private viewId: string = 'live_player_view';}
步骤4：添加渲染 View
在鸿蒙系统中使用 XComponent 来渲染视频画面。在布局中声明 XComponent 时，需指定 libraryname 为
'liteavsdk'，并为其设置一个唯一的 id：build() {XComponent({id: this.viewId,type: XComponentType.SURFACE,libraryname: 'liteavsdk'}).width('100%').height('100%').backgroundColor(Color.Black)}
然后在
aboutToAppear 中将 viewId 传给 setRenderView：aboutToAppear(): void {this.player = createV2TXLivePlayer(getContext());this.player.setRenderView(this.viewId);}
页面销毁时，需停止播放并注销 Observer，释放资源：
aboutToDisappear(): void {if (this.isPlaying) {this.player?.stopPlay();}this.player?.setObserver(null);this.player = null;}
步骤5：启动播放
startLivePlay(): void {this.player?.startPlay('https://your-domain/live/stream-id.flv');}
步骤6：画面调整
view：大小和位置
setRenderFillMode：铺满 or 适应
可选值 | 含义 |
V2TXLiveFillModeFill | 将图像等比例铺满整个屏幕，多余部分裁剪掉，此模式下画面不会留黑边，但可能因为部分区域被裁剪而显示不完整。 |
V2TXLiveFillModeFit | 将图像等比例缩放，适配最长边，缩放后的宽和高都不会超过显示区域，居中显示，画面可能会留有黑边。 |
setRenderRotation：视频画面顺时针旋转角度
可选值 | 含义 |
V2TXLiveRotation0 | 不旋转。 |
V2TXLiveRotation90 | 顺时针旋转90度。 |
V2TXLiveRotation180 | 顺时针旋转180度。 |
V2TXLiveRotation270 | 顺时针旋转270度。 |
// 设置填充模式this.player.setRenderFillMode(V2TXLiveFillMode.V2TXLiveFillModeFill);// 设置画面渲染方向this.player.setRenderRotation(V2TXLiveRotation.V2TXLiveRotation0);
步骤7：暂停播放
对于直播播放而言，并没有真正意义上的暂停，所谓的直播暂停，只是画面冻结和关闭声音，而云端的视频源还在不断地更新着，所以当您调用 resume 的时候，会从最新的时间点开始播放，这是和点播对比的最大不同之处（点播播放器的暂停和继续与播放本地视频文件时的表现相同）。
// 暂停this.player?.pauseAudio();this.player?.pauseVideo();// 恢复this.player?.resumeAudio();this.player?.resumeVideo();
步骤8：结束播放
结束播放非常简单，直接调用
stopPlay 即可。stopLivePlay(): void {this.player?.stopPlay();}
步骤9：屏幕截图
通过调用 snapshot 您可以截取当前直播画面为一帧画面，此功能只会截取当前直播流的视频画面，如果您需要截取当前的整个 UI 界面，请调用鸿蒙的系统 API 来实现。
private observer: V2TXLivePlayerObserver = {onSnapshotComplete: (player: V2TXLivePlayer, pixelMap: image.PixelMap) => {let imageInfo = pixelMap.getImageInfoSync();},}this.player.setObserver(this.observer);this.player.snapshot();
延时调节
腾讯云 SDK 的云直播播放功能，并非基于 ffmpeg 做二次开发， 而是采用了自研的播放引擎，所以相比于开源播放器，在直播的延迟控制方面有更好的表现，我们提供了三种延迟调节模式，分别适用于秀场、游戏以及混合场景。
三种模式的特性对比
控制模式 | 卡顿率 | 平均延迟 | 适用场景 | 原理简述 |
极速模式 | 较流畅偏高 | 2s- 3s | 美女秀场（冲顶大会） | 在延迟控制上有优势，适用于对延迟大小比较敏感的场景 |
流畅模式 | 卡顿率最低 | >= 5s | 游戏直播（企鹅电竞） | 对于超大码率的游戏直播（例如绝地求生）非常适合，卡顿率最低 |
自动模式 | 网络自适应 | 2s-8s | 混合场景 | 观众端的网络越好，延迟就越低；观众端网络越差，延迟就越高 |
三种模式的对接代码
// 自动模式this.player.setCacheParams(1, 5);// 极速模式this.player.setCacheParams(1, 1);// 流畅模式this.player.setCacheParams(5, 5);// 设置完成之后再启动播放
说明：
SDK 事件监听
您可以为 V2TXLivePlayer 对象绑定一个 V2TXLivePlayerObserver，之后 SDK 的内部状态信息例如播放器状态、播放音量回调、音视频首帧回调、统计数据、警告和错误信息等会通过对应的回调通知给您。
定时触发的状态通知
onStatisticsUpdate 通知每2秒都会被触发一次，目的是实时反馈当前的播放器状态，它就像汽车的仪表盘，可以告知您目前 SDK 内部的一些具体情况，以便您能对当前网络状况和视频信息等有所了解。
评估参数 | 含义说明 |
appCpu | 当前 App 的 CPU 使用率（％） |
systemCpu | 当前系统的 CPU 使用率（％） |
width | 视频宽度 |
height | 视频高度 |
fps | 帧率（fps） |
audioBitrate | 音频码率（Kbps） |
videoBitrate | 视频码率（Kbps） |
onPlayoutVolumeUpdate 播放器音量大小回调。这个回调仅当您调用 enableVolumeEvaluation 开启播放音量大小提示之后才会工作。回调的时间间隔也会与您在设置
enableVolumeEvaluation 的参数 intervalMs 保持一致。非定时触发的状态通知
其余的回调仅在事件发生时才会抛出来。
