云导播功能

微吼提供网页版云导播台进行视频混流直播功能，支撑大会和异地直播场景。SDK发起端既可以作为视频推流工具推流到云导播台，也可以作为直播主持人接受云导播推流发起直播。

sdk 6.4.0之后支持云导播功能

关键类

类	类描述
WatchLive	主持人拉流类（原观众观看类）
Broadcast	机位推流类（原主持人发视频直播类）

关键方法

方法	方法描述
VhallSDK.getBaseWebinarInfo	获取基础活动信息
VhallSDK.getDirectorStatus	获取云导播开关
VhallSDK.getDirectorStreamStatus	获取直播间流状态
VhallSDK.getDirectorSeatList	获取当前云导播活动下的机位列表
VhallSDK.directorSelectSeat	占用当前云导播活动下的机位
VhallSDK.initDirector	机位推流初始化
VhallSDK.startBroadcast	开始云导播
VhallSDK.finishBroadcast	结束云导播

关键事件

方法	方法描述
MessageServer.EVENT_DIRECTOR_STREAM	云导播活动流状态

获取基础活动信息

接口API

接口入参

参数名称	是否必须	示例	备注
id	是	234700561	活动id
WebinarInfo			返回数据类

WebinarInfo

参数名称	备注
webinar_id	活动id
is_director	0:不是云导播活动 1:是云导播活动
webinar_show_type	0:竖屏，1:横屏

代码示例

获取云导播开关

接口API

接口入参

参数名称	是否必须	示例	备注
id	是	234700561	活动id
director_status			返回数据（0：未开启， 1：已开启）

代码示例

获取直播间流状态

接口API

接口入参

参数名称	是否必须	示例	备注
id	是	234700561	活动id
director_stream_status			返回数据流状态， 1 推流中 2 未推流

代码示例

获取当前云导播活动下的机位列表

接口API

接口入参

参数名称	是否必须	示例	备注
id	是	234700561	活动id
DirectorSeatListData			返回数据类

DirectorSeatListData-机位列表

参数名称	备注
list#ListBean	机位列表

DirectorSeatListData-ListBean

参数名称	备注
seat_id	机位 ID
status	机位状态， 0：未被占用， 1：已被占用
name	机位名称

代码示例

占用当前云导播活动下的机位

接口API

接口入参

参数名称	是否必须	示例	备注
id	是	234700561	活动id
seatId	是	11	机位id

代码示例

机位推流初始化

接口API

接口入参

参数名称	是否必须	示例	备注
id	是	234700561	活动id
seatId	是	11	机位id
WebinarInfo			返回数据类

代码示例

开始云导播

备注：修改直播间状态

接口API

接口入参

参数名称	是否必须	示例	备注
id	是	234700561	活动id 在网页上创建

代码示例

结束云导播

备注：修改直播间状态

接口API

接口入参

参数名称	是否必须	示例	备注
id	是	234700561	活动id 在网页上创建
accessToken	否	dn313n4242424242	请求API获取的Token 新控制台（化蝶）创建的直播可以不写
rehearsal	否		是否是彩排

代码示例

云导播活动流状态

由pc云导播台控制

参数说明

字段	描述
director_stream_status	流状态 2 没有流 1 有流（有流主持人才可以开始直播）

代码示例

demo 使用文档

一、根据活动id判断当前云导播活动是否开启

判读是否是云导播，否退出，是调用接口VhallSDK.getDirectorStatus 获取云导播开关，获取当前是否支持机位进入

选择主持人进入 initBroadcast

如果当前云导播台开启（getDirectorStatus），可以选择机位进入，如果没开则不可以选择机位

拉取机位列表（getDirectorSeatList），选择一个没有被占用的机位，占用（directorSelectSeat），然后进入房间推流（initDirector）

二、机位进入

1、先根据活动id获取机位列表 VhallSDK.getDirectorSeatList

2、选择一个可用的机位，然后占用机位

进入机位推流房间 DirectorPushActivity，使用 VhallSDK.initDirector获取房间详情

机位注意

断网或者推到后台会中断推流，再回到前台或者网络重联的时候需要重新调用 2占用机位，判断是否可以继续占用机位推流，可以继续推流不可以直接退出房间

当前房间只能推流不支持聊天等其他操作

三、主持人进入

1、依照之前逻辑进入BroadcastActivity

2、根据当前活动是云导播活动，进入DirectorFragment

3、直播间不能推流，只能拉流显示具体参考DirectorFragment、DirectorPresenter

需要使用 WatchLive

消息

//云导播活动流状态
case MessageServer.EVENT_DIRECTOR_STREAM: directorView.setDirectorError(messageInfo.director_stream_status);

关键类#

关键方法#

关键事件#

获取基础活动信息#

WebinarInfo#

获取云导播开关#

获取直播间流状态#

获取当前云导播活动下的机位列表#

DirectorSeatListData-机位列表#

DirectorSeatListData-ListBean#

占用当前云导播活动下的机位#

机位推流初始化#

开始云导播#

结束云导播#

云导播活动流状态#

demo 使用文档#

一、根据活动id判断当前云导播活动是否开启#

二、机位进入#

1、先根据活动id获取机位列表 VhallSDK.getDirectorSeatList#

2、选择一个可用的机位，然后占用机位#

进入机位推流房间 DirectorPushActivity，使用 VhallSDK.initDirector获取房间详情#

机位注意#

三、主持人进入#

1、依照之前逻辑 进入BroadcastActivity#

2、根据当前活动是云导播活动，进入DirectorFragment#

3、直播间不能推流，只能拉流显示 具体参考DirectorFragment、DirectorPresenter#

消息#

关键类

关键方法

关键事件

获取基础活动信息

WebinarInfo

获取云导播开关

获取直播间流状态

获取当前云导播活动下的机位列表

DirectorSeatListData-机位列表

DirectorSeatListData-ListBean

占用当前云导播活动下的机位

机位推流初始化

开始云导播

结束云导播

云导播活动流状态

demo 使用文档

一、根据活动id判断当前云导播活动是否开启

二、机位进入

1、先根据活动id获取机位列表 VhallSDK.getDirectorSeatList

2、选择一个可用的机位，然后占用机位

进入机位推流房间 DirectorPushActivity，使用 VhallSDK.initDirector获取房间详情

机位注意

三、主持人进入

1、依照之前逻辑进入BroadcastActivity

2、根据当前活动是云导播活动，进入DirectorFragment

3、直播间不能推流，只能拉流显示具体参考DirectorFragment、DirectorPresenter

消息