观看视频直播

视频直播活动中，观众可以通过 SDK 进入直播间观看视频直播，是在直播间中进行聊天互动的基础动作。

注意事项

看直播房间和互动房间不能同时播放，进入互动需要暂停直播

必需登录成功之后才可以进入活动

用视频模式观看无延迟直播也会有视频延迟

观看互动直播才有连麦功能

观看直播步骤

初始化直播间信息 - initWatch（只设置一次）

初始化看直播实例 - WatchLive.build()（只设置一次）

设置直播间详情 - watchLive.setWebinarInfo（只设置一次）

开始观看 - watchLive.start （发送聊天等可以在这一步调用）

暂停播放 - watchLive.stop

销毁直播间 - watchLive.destroy （退出房间必须调用，只设置一次）

核心类

类名	描述
WatchLive	看直播核心类
VHPlayerListener	直播事件回调
MessageServer#Callback	房间消息回调
ChatServer#Callback	聊天消息回调

关键方法

方法	方法描述
initWatch	初始化直播间信息
WatchLive.build()	初始化看直播实例
watchLive.setWebinarInfo	设置直播间详情
watchLive.setScaleType	本地预览填充模式
watchLive.getDefinition	获取当前的分辨率
watchLive.setDefinition	设置分辨率
watchLive.setPCSwitchDefinition	PC 端切换分辨率
watchLive.isPlaying	播放状态
watchLive.start	开始观看
watchLive.sendChat	发送聊天
watchLive.sendCustom	发送自定义消息
watchLive.sendQuestion	发送问答消息
watchLive.onRaiseHand	申请上麦/取消申请上麦操作
watchLive.replyInvitation	是否同意上麦
watchLive.acquireChatRecord	获取历史聊天记录
watchLive.setVideoBackgroundColor	设置播放器背景颜色
watchLive.setVideoBackgroundImage	设置播放器背景背景图片
watchLive.stop	暂停播放
watchLive.takeVideoScreenshot	播放器截图
watchLive.destroy	销毁直播间
VHPlayerListener	直播事件回调

初始化直播间信息

只有正在直播的活动才可以成功

接口 API

接口入参

参数名称	是否必须	示例	备注
id	是	234700561	活动 id 在网页上创建
email	否	123456	邮箱
nickName	否	" name"	昵称
password	否	123	密码/k 值
status	是	WebinarInfo.LIVE	活动状态 WebinarInfo.LIVE 看直播/WebinarInf.BESPEAK 看回放
k_id	否	123	k_id 值
LoadWebinarInfoCallback#WebinarInfo			活动详情

代码示例

初始化看直播实例

接口 API

内部变量说明

参数名称	是否必须	示例	备注
Context	是	watchView.getActivity()	上下文对象
containerLayout	是	RelativeLayout	回显视频 view
bufferSeconds	否	6	超时时间 6s
ChatServer.Callback	否		聊天监听
MessageServer.Callback	否		消息监听
VHPlayerListener	否		播放器消息

代码示例

设置直播间详情

备注：只设置一次，不能多次设置

接口 API

代码示例

本地预览填充模式

接口 API

接口入参

参数名称	是否必须	示例	备注
mode	是	VHLivePushFormat.DRAW_MODE_ASPECTFIT	本地相机预览填充模式

代码示例

适配类型	描述
Constants.DrawMode.kVHallDrawModeNone.getValue()	默认
Constants.DrawMode.kVHallDrawModeAspectFit.getValue()	自适应居中
Constants.DrawMode.kVHallDrawModeAspectFill.getValue()	铺满全屏

获取当前的分辨率

接口 API

代码示例

设置分辨率

接口 API

接口入参

参数名称	是否必须	示例	备注
definition	是	360	要设置的分辨率

代码示例

PC 端切换分辨率

接口 API

接口入参

参数名称	是否必须	示例	备注
definition	是	360	要设置的分辨率

代码示例

播放状态

获取当前播放状态

接口 API

代码示例

开始观看

接口 API

代码示例

发送聊天

备注：接口成功之后在消息监听里面接收自己的消息

接口 API

接口入参

参数名称	是否必须	示例	备注
content	是	消息内容	消息内容

代码示例

发送自定义消息

备注：接口成功之后在消息监听里面接收自己的消息

接口 API

接口入参

参数名称	是否必须	示例	备注
content	是	JSONObject	消息内容

代码示例

发送问答消息

备注：接口成功之后在消息监听里面接收自己的消息

接口 API

接口入参

参数名称	是否必须	示例	备注
content	是	问题	提问的问题内容

代码示例

申请上麦/取消申请上麦操作

接口 API

接口入参

参数名称	是否必须	示例	备注
webinarId	是	123456789	活动 id
type	是	1	类型 1 申请 2 取消申请

代码示例

回应互动邀请

接口 API

接口入参

参数名称	是否必须	示例	备注
webinarId	是	123456789	活动 id
type	是	1	类型 1 接受，2 拒绝，3 超时失败

代码示例

获取历史聊天记录

接口 API

接口入参

参数名称	是否必须	示例	备注
show_all	否	1	true 显示所有聊天最条为 100 条 false 为 20 条
List#ChatServer.ChatInfo			返回数据类

接口入参

参数名称	是否必须	示例	备注
page	否	1	获取条目节点，默认为 1
limit	否	1-100	获取条目数量，最大 100
msgId	否	msg_97161	锚点消息 id,此参数存在时 anchor_path 参数必须存在
anchorPath	否	20	锚点方向，up 向上查找，down 向下查找,此参数存在时 msg_id 参数必须存在
isRole	否	0	0：不筛选主办方 1：筛选主办方默认是 0
List#ChatServer.ChatInfo			返回数据类

代码示例

设置播放器背景颜色

接口 API

接口入参

参数名称	是否必须	示例	备注
color	是	Color.parseColor("#000000")	颜色色值

代码示例

设置播放器背景背景图片

接口 API

接口入参

参数名称	是否必须	示例	备注
bitmap	是	Bitmap	图片的 bitmip

代码示例

暂停播放

接口 API

代码示例

播放器截图

接口 API

代码示例

销毁直播间

接口 API

代码示例

直播事件回调

VHPlayerListener

状态码说明-onStateChanged

状态码	描述
Constants.State.START	开始推流
Constants.State.BUFFER	推流阻塞
Constants.State.STOP	停止推流

事件码说明-eventCode

事件码	描述
Constants.Event .EVENT_DOWNLOAD_SPEED	下载速度
Constants.Event .EVENT_DPI_CHANGED	分辨率切换
Constants.Event .EVENT_DPI_LIST	支持的分辨率
Constants.Event .EVENT_VIDEO_SIZE_CHANGED	视频的宽高
ErrorCode .ERROR_LOGIN_MORE	被其他人踢出
Watch.EVENT_INIT_PLAYER_SUCCESS	播放器初始化成功

错误码说明-errorCode

错误码	描述
Push.ERROR_NOT_INIT	初始化视频信息失败（没有设置活动信息）

代码示例

附加说明

屏幕保持常亮

设置观看布局

注意事项#

观看直播步骤#

核心类#

关键方法#

初始化直播间信息#

初始化看直播实例#

内部变量说明#

设置直播间详情#

本地预览填充模式#

获取当前的分辨率#

设置分辨率#

PC 端切换分辨率#

播放状态#

开始观看#

发送聊天#

发送自定义消息#

发送问答消息#

申请上麦/取消申请上麦操作#

回应互动邀请#

获取历史聊天记录#

设置播放器背景颜色#

设置播放器背景背景图片#

暂停播放#

播放器截图#

销毁直播间#

直播事件回调#

状态码说明-onStateChanged#

事件码说明-eventCode#

错误码说明-errorCode#

附加说明#

注意事项

观看直播步骤

核心类

关键方法

初始化直播间信息

初始化看直播实例

内部变量说明

设置直播间详情

本地预览填充模式

获取当前的分辨率

设置分辨率

PC 端切换分辨率

播放状态

开始观看

发送聊天

发送自定义消息

发送问答消息

申请上麦/取消申请上麦操作

回应互动邀请

获取历史聊天记录

设置播放器背景颜色

设置播放器背景背景图片

暂停播放

播放器截图

销毁直播间

直播事件回调

状态码说明-onStateChanged

事件码说明-eventCode

错误码说明-errorCode

附加说明