视频轮巡功能

企业培训和培训课堂场景下，想监控培训学员的学习状态，使用微吼提供的视频轮巡功能，可以通过摄像头实时采集学员画面展示在监控端。从SDK进入的观众支持加入视频轮巡。

注意事项

sdk 6.5.0之后支持观众参与视频轮巡
所有进入互动房间之后需要过滤轮巡的流（自己不显示）

权限说明

轮巡是在收到主持人轮巡的消息静默推一路静音的流（需要音视频权限），所以建议在进入直播间之前申请音视频的权限，如果没有权限则推的是黑流

轮巡推流设置

轮巡本地流必须这么设置

轮巡流程

获取当前轮巡用户

接口API

接口入参

参数名称	是否必须	示例	备注
room_id	是	lss222222222	房间id webinarInfo.vss_room_id
is_next	是	1	是否是下一组， 0：当前组， 1：下一组目前只用0
RoundUserListData			返回信息

代码示例

MessageServer 增加消息类型

参数字段	描述
MessageServer.EVENT_VIDEO_ROUND_START	开始轮巡
MessageServer.EVENT_VIDEO_ROUND_END	结束轮巡
MessageServer.EVENT_VIDEO_ROUND_USERS	参与轮巡的用户 uids

MsgInfo 增加新的字段

参数字段	描述
List#String uids	当前参与轮巡的用户id，如果没有自己则要退出

互动新增轮巡流类型

互动流类型

VhallStreamType	说明
VhallStreamTypeOnlyAudio	纯音频
VhallStreamTypeOnlyVideo	纯视频
VhallStreamTypeAudioAndVideo	音视频
VhallStreamTypeScreen	桌面共享（pc端发起）
VhallStreamTypeFile	文件插播（pc插播）
VhallStreamTypeVideoPatrol	视频轮巡 since 6.5.0

demo 使用文档

视频直播参与轮巡-参考 WatchLivePresenter

1、收到轮巡消息

case MessageServer.EVENT_VIDEO_ROUND_START:
                        //轮巡开启
                        watchView.showToast("主办方开启了视频轮巡功能，在主持人端将会看到您的视频画面，请保持视频设备一切正常");
                        break;
                    case MessageServer.EVENT_VIDEO_ROUND_END:
                        //轮巡结束
                        releaseRound();
                        break;
                    case MessageServer.EVENT_VIDEO_ROUND_USERS:
                        //轮巡用户 再次之前必需要有麦克风、摄像头权限 uids次轮参与用户id
                        dealRound(messageInfo.uids, false);
                        break;

2、处理轮巡用户

2.1 如果包含自己

已经参加轮轮巡不处理

没有参加轮巡、初始化互动并且创建轮巡本地流，然后推流

2.2 如果不包含自己

已经参加、下麦销毁互动房间

没有参加轮巡不处理

3、断网

直播里面需要自己监控网络状态、可以参考demo的NetUtil ，

在网络恢复的时候，已经参与轮巡；不处理，在互动的房间监听里面自动处理，VhallSDK.getRoundUsers，如果自己还在轮训里面，直接推流。

在网络恢复的时候，没有参与轮巡；需要请求接口，VhallSDK.getRoundUsers，如果自己还在轮训里面，初始化互动并且推流

收到 VHRoomStatusError 需要销毁互动房间（这个时候互动房间链接断开，一般断网会触发）

4、推到后台、回到前台

推到后台、如果参加轮训，需要下麦并且销毁互动
回到前台、VhallSDK.getRoundUsers，如果自己还在轮训里面，初始化互动并且推流
第一次进入活动，等于说也需要走一遍回到前台的动作就是onResume，如果之前退出房间，再进来也需要请求接口，并且自己还在轮训里面，初始化互动并且推流

5、离开直播

需要销毁互动房间

无延迟直播参与轮巡参考 WatchNoDelayLivePresenter

因为无延迟房间是互动直播间，所以轮巡的时候不需要创建新的互动直播间，只需要创建轮巡的本地流并且推流就可以

1、收到轮巡消息

2、处理轮巡用户

2.1 如果包含自己

已经参加轮轮巡不处理

没有参加轮巡、创建轮巡本地流，然后推流

2.2 如果不包含自己

已经参加、下麦

没有参加轮巡不处理

3、断网，互动有断网重连

进入房间和断网重连都会触发 onDidConnect

收到 VHRoomStatusError 需要销毁互动房间，重新进入（这个时候互动房间链接断开，一般断网会触发）

4、推到后台、回到前台

推到后台、如果参加轮训，需要下麦

回到前台、VhallSDK.getRoundUsers，如果自己还在轮训里面，推流

第一次进入活动，等于说也需要走一遍回到前台的动作就是onResume，如果之前退出房间，再进来也需要请求接口，并且自己还在轮训里面，初始化互动并且推流

5、离开直播

需要销毁互动

视频轮巡功能

视频轮巡功能#

注意事项#

权限说明#

轮巡推流设置#

轮巡流程#

获取当前轮巡用户#

MessageServer 增加消息类型#

MsgInfo 增加新的字段#

互动新增轮巡流类型#

demo 使用文档#

视频直播参与轮巡-参考 WatchLivePresenter#

1、收到轮巡消息#

2、处理轮巡用户#

2.1 如果包含自己#

2.2 如果不包含自己#

3、断网#

4、推到后台、回到前台#

5、离开直播#

无延迟直播参与轮巡 参考 WatchNoDelayLivePresenter#

1、收到轮巡消息#

2、处理轮巡用户#

2.1 如果包含自己#

2.2 如果不包含自己#

3、断网，互动有断网重连#

4、推到后台、回到前台#

5、离开直播#

视频轮巡功能

注意事项

权限说明

轮巡推流设置

轮巡流程

获取当前轮巡用户

MessageServer 增加消息类型

MsgInfo 增加新的字段

互动新增轮巡流类型

demo 使用文档

视频直播参与轮巡-参考 WatchLivePresenter

1、收到轮巡消息

2、处理轮巡用户

2.1 如果包含自己

2.2 如果不包含自己

3、断网

4、推到后台、回到前台

5、离开直播

无延迟直播参与轮巡参考 WatchNoDelayLivePresenter

1、收到轮巡消息

2、处理轮巡用户

2.1 如果包含自己

2.2 如果不包含自己

3、断网，互动有断网重连

4、推到后台、回到前台

5、离开直播