腾讯云直播SDK标准直播拉流_音视频解决方案_同尘科技

直播SDK 2年前 (2023-09-19) 浏览 135

基础知识

本文主要介绍视频云 SDK 的直播播放功能。

直播和点播

直播(LIVE)的视频源是主播实时推送的。因此,主播停止推送后,播放端的画面也会随即停止,而且由于是实时直播,所以播放器在播直播 URL 的时候是没有进度条的。点播(VOD)的视频源是云端的一个视频文件,只要未被从云端移除,视频就可以随时播放, 播放中您可以通过进度条控制播放位置,腾讯视频和优酷土豆等视频网站上的视频观看就是典型的点播场景。

协议的支持

通常使用的直播协议如下,标准直播推荐使用 FLV 协议的直播地址(以http开头,以.flv 结尾),快直播使用 WebRTC 协议,更多信息请参见 快直播拉流:

直播协议 优点 缺点 播放延迟
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 三种格式的点播地址。

示例代码

针对开发者的接入反馈的高频问题,腾讯云提供有更加简洁的 API-Example 工程,方便开发者可以快速的了解相关 API 的使用,欢迎使用。

所属平台 GitHub 地址
iOS Github
Android Github
Flutter Github

对接攻略

1. 下载 SDK 开发包

下载 SDK 开发包,并按照 SDK 集成指引 将 SDK 嵌入您的 App 工程中。

2. 给 SDK 配置 License 授权

1. 获取 License 授权:若您已获得相关 License 授权,需在 云直播控制台 获取 License URL 和 License Key。
若您暂未获得 License 授权,需先参考 新增与续期 License 进行申请。2. 在您的 App 调用 LiteAVSDK 的相关功能之前(建议在 - [AppDelegate application:didFinishLaunchingWithOptions:] 中)进行如下设置:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {    NSString * const licenceURL = @"";    NSString * const licenceKey = @"";
// V2TXLivePremier 位于 "V2TXLivePremier.h" 头文件中 [V2TXLivePremier setLicence:licenceURL key:licenceKey]; [V2TXLivePremier setObserver:self]; NSLog(@"SDK Version = %@", [V2TXLivePremier getSDKVersionStr]); return YES;}
#pragma mark - V2TXLivePremierObserver- (void)onLicenceLoaded:(int)result Reason:(NSString *)reason { NSLog(@"onLicenceLoaded: result:%d reason:%@", result, reason);}@end

注意License 中配置的 BundleId 必须和应用本身一致,否则会播放失败。

3. 创建 Player

视频云 SDK 中的 V2TXLivePlayer 模块负责实现直播播放功能。

V2TXLivePlayer *_txLivePlayer = [[V2TXLivePlayer alloc] init];

4. 渲染 View

接下来我们要给播放器的视频画面找个地方来显示,iOS 系统中使用 view 作为基本的界面渲染单位,所以您只需要准备一个 view 并调整好布局就可以了。

//用 setRenderView 给播放器绑定决定渲染区域的view.[_txLivePlayer setRenderView:_myView];

内部原理上,播放器并不是直接把画面渲染到您提供的 view (示例代码中的_myView)上,而是在这个 view 之上创建一个用于 OpenGL 渲染的子视图(subView)。如果您要调整渲染画面的大小,只需要调整您所常见的 view 的大小和位置即可,SDK 会让视频画面跟着您的 view 的大小和位置进行实时的调整。
如何做动画?
针对 view 做动画是比较自由的,不过请注意此处动画所修改的目标属性应该是 transform 属性而不是 frame 属性。

[UIView animateWithDuration:0.5 animations:^{        _myView.transform = CGAffineTransformMakeScale(0.3, 0.3); //缩小1/3}];

5. 启动播放

NSString* url = @"http://2157.liveplay.myqcloud.com/live/2157_xxxx.flv";[_txLivePlayer startLivePlay:url];

6. 画面调整

setRenderFillMode:铺满 or 适应

可选值 含义
V2TXLiveFillModeFill 将图像等比例铺满整个屏幕,多余部分裁剪掉,此模式下画面不会留黑边,但可能因为部分区域被裁剪而显示不全
V2TXLiveFillModeFit 将图像等比例缩放,适配最长边,缩放后的宽和高都不会超过显示区域,居中显示,画面可能会留有黑边

setRenderRotation:视频画面顺时针旋转角度

可选值 含义
V2TXLiveRotation0 不旋转
V2TXLiveRotation90 顺时针旋转90度
V2TXLiveRotation180 顺时针旋转180度
V2TXLiveRotation270 顺时针旋转270度



7. 暂停播放

对于直播播放而言,并没有真正意义上的暂停,所谓的直播暂停,只是画面冻结关闭声音,而云端的视频源还在不断地更新着,所以当您调用 resume 的时候,会从最新的时间点开始播放,这是和点播对比的最大不同点(点播播放器的暂停和继续与播放本地视频文件时的表现相同)。

// 暂停[_txLivePlayer pauseAudio];[_txLivePlayer pauseVideo];// 恢复[_txLivePlayer resumeAudio];[_txLivePlayer resumeVideo];

8. 结束播放

// 停止播放[_txLivePlayer stopPlay];

9. 屏幕截图

通过调用 snapshot 您可以截取当前直播画面为一帧屏幕通过 V2TXLivePlayerObserver 的 onSnapshotComplete 回调截屏图片,此功能只会截取当前直播流的视频画面,如果您需要截取当前的整个 UI 界面,请调用 iOS 的系统 API 来实现。


...[_txLivePlayer setObserver:self];[_txLivePlayer snapshot];...
- (void)onSnapshotComplete:(id)player image:(TXImage *)image { if (image != nil) { dispatch_async(dispatch_get_main_queue(), ^{ [self handle:image]; }); }}

延时调节

腾讯云 SDK 的直播播放功能,并非基于 ffmpeg 做二次开发, 而是采用了自研的播放引擎,所以相比于开源播放器,在直播的延迟控制方面有更好的表现,我们提供了三种延迟调节模式,分别适用于:秀场,游戏以及混合场景。三种模式的特性对比

控制模式 卡顿率 平均延迟 适用场景 原理简述
极速模式 较流畅偏高 2s- 3s 美女秀场(冲顶大会) 在延迟控制上有优势,适用于对延迟大小比较敏感的场景
流畅模式 卡顿率最低 >= 5s 游戏直播(企鹅电竞) 对于超大码率的游戏直播(例如绝地求生)非常适合,卡顿率最低
自动模式 网络自适应 2s-8s 混合场景 观众端的网络越好,延迟就越低;观众端网络越差,延迟就越高

三种模式的对接代码

//自动模式[_txLivePlayer setCacheParams:1 maxTime:5];//极速模式[_txLivePlayer setCacheParams:1 maxTime:1];//流畅模式[_txLivePlayer setCacheParams:5 maxTime: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保持一致。

非定时触发的状态通知

其余的回调仅在事件发生时才会抛出来。

对音视频的解决方案有疑惑?想了解解决方案收费? 联系解决方案专家

腾讯云限时活动1折起,即将结束: 马上收藏

同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠

阿里云解决方案也看看?: 点击对比阿里云的解决方案

- 0人点赞 -

发表点评 (0条)

not found

暂无评论,你要说点什么吗?