示例代码
针对开发者的接入反馈的高频问题,腾讯云提供有更加简洁的 API-Example 工程,方便开发者可以快速的了解相关 API 的使用,欢迎使用。
功能介绍
在了解自适应码率播放之前,首先要了解什么是无缝切流。
无缝切流:在切换不同码率的转码流时,能够做到无缝衔接,不会出现声音画面中断或者跳变的情况,实现观感和听感的平滑过渡。
自适应码率播放:在无缝切流的基础上更进一步,无需用户干预,完全由当前网络带宽来决定实现自动无缝切流,减少网络波动对播放流畅度的影响。
开启自适应播放
自适应播放功能依托于腾讯云的直播自适应码率支撑,如果您想要对接这个功能,需要在腾讯云的管理控制台 开通直播自适应码率服务。服务开通之后,需要创建至少一个自适应模板并包含两个子流,才可使用自适应播放功能。
创建自适应码率模板
2. 配置子流:至少应该配置两个子流。
3. 绑定域名:创建转码模板之后,需要绑定域名。
说明:
获取 HLS 自适应播放地址
1. 通过 地址生成器,选择创建的自适应码率模板,单击生成。
2. 通过自适应模板的名称,来拼接地址。HLS 自适应播放的格式为:
http://{Domain}/{AppName}/{StreamName}_{AdaptiveTemplate}.m3u8
在上述的 URL 中,存在一些关键字段,关于其中关键字段的含义信息,详见下表:
字段名称 | 字段含义 |
http:// | HLS URL 的前缀字段 |
Domain | HLS 直播播放域名 |
AppName | 应用名称,指的是直播流媒体文件存放路径,默认云直播会分配一个路径:live |
StreamName | 流名称,指每路直播流唯一的标识符 |
AdaptiveTemplate | 自适应码率模板名称,表明使用哪一个配置模板 |
URL 地址样例(hlsAutoTest 为自适应码率模板名称):
类型 | URL地址 |
原始 | http://xxx.liveplay.myqcloud.com/stream_name.m3u8 |
自适应播放 | http://xxx.liveplay.myqcloud.com/stream_name_hlsAutoTest.m3u8 |
实现 HLS 自适应播放
使用 V2TXLivePlayer 对象可以使用 HLS 自适应播放,具体做法如下(传入正确的 URL 是关键):
示例代码:
// 创建⼀个 V2TXLivePlayer 对象;V2TXLivePlayer player = new V2TXLivePlayerImpl(mContext);player.setObserver(new MyPlayerObserver(playerView));player.setRenderView(mSurfaceView);// 传⼊HLS自适应播放地址,即可开始播放;player.startLivePlay("http://{Domain}/{AppName}/{StreamName}_{AdaptiveTemplate}.m3u8");
// 创建⼀个 V2TXLivePlayer 对象;V2TXLivePlayer *player = [[V2TXLivePlayer alloc] init];[player setObserver:self];[player setRenderView:videoView];// 传⼊HLS自适应播放地址,即可开始播放;[player startLivePlay:@"http://{Domain}/{AppName}/{StreamName}_{AdaptiveTemplate}.m3u8"];
实现 HLS 无缝切流
使用 V2TXLivePlayer 对象可以使用 HLS 无缝切流,具体做法如下:
1. 播放自适应地址,并且设置 Observer 回调
// 创建⼀个 V2TXLivePlayer 对象;V2TXLivePlayer player = new V2TXLivePlayerImpl(mContext);player.setObserver(new MyPlayerObserver(playerView));player.setRenderView(mSurfaceView);// 传⼊HLS自适应播放地址,即可开始播放;player.startLivePlay("http://{Domain}/{AppName}/{StreamName}_{AdaptiveTemplate}.m3u8");
// 创建⼀个 V2TXLivePlayer 对象;V2TXLivePlayer *player = [[V2TXLivePlayer alloc] init];[player setObserver:self];[player setRenderView:videoView];// 传⼊HLS自适应播放地址,即可开始播放;[player startLivePlay:@"http://{Domain}/{AppName}/{StreamName}_{AdaptiveTemplate}.m3u8"];
2. 在 onConnected 回调中,获取全部的子流地址
/*** 已经成功连接到服务器* @param player 回调该通知的播放器对象* @param extraInfo 扩展信息*/public void onConnected(V2TXLivePlayer player, Bundle extraInfo){ArrayList<V2TXLiveStreamInfo> streams = player.getStreamList();}
/*** 已经成功连接到服务器* @param player 回调该通知的播放器对象* @param extraInfo 扩展信息*/- (void)onConnected:(id<V2TXLivePlayer>)player extraInfo:(NSDictionary *)extraInfo {self.streams = [player getStreamList]}
3. 切换到一个子流
// 选择期望质量的码流V2TXLiveStreamInfo stream = streams.get(index);// 切换到期望质量的码流player.switchStream(stream.url);
// 选择期望质量的码流V2TXLiveStreamInfo *streamInfo = self.streams[index];// 切换到期望质量的码流[self.player switchStream:streamInfo.url];
4. 切换回自适应播放
player.switchStream("http://{Domain}/{AppName}/{StreamName}_{AdaptiveTemplate}.m3u8");
[self.player switchStream:@"http://{Domain}/{AppName}/{StreamName}_{AdaptiveTemplate}.m3u8"];