保利威文档中心

帮助中心

模块事件

更新时间:2026-01-19 09:16:42

一、频道安装失败

说明: 安装 channel 模块失败时会触发该事件

Event 事件: ChannelEvents.ChannelSetupFail

回调参数: Object 对象,详细类型说明如下

属性名 说明 类型
failReason 频道安装失败原因 ChannelSetupFailReason
failMessage 频道安装失败信息 string

二、直播状态改变事件

说明: 当主讲开始/结束直播后,频道的直播状态都会改变,通过该事件监听直播状态改变

Event 事件: ChannelEvents.LiveStatusChange

回调参数: Object 对象,详细类型说明如下

属性名 说明 类型
liveStatus 新的直播状态 LiveStatus
newLiveStatus 新的直播状态 LiveStatus
oldLiveStatus 旧的直播状态 LiveStatus

示例:

watchCore.channel.eventEmitter.on(ChannelEvents.LiveStatusChange, (data) => {
  console.log('频道状态改变,新状态:', data.liveStatus);
});

三、场次号改变事件

说明: 主讲开次新的一次直播后,都会生成一个新的直播场次号,可以通过频道模块的该事件监听直播场次号改变。

Event 事件: ChannelEvents.SessionIdChange

回调参数: Object 对象,详细类型说明如下

属性名 说明 类型
sessionId 新的场次号 string

示例:

watchCore.channel.eventEmitter.on(ChannelEvents.LiveStatusChange, (data) => {
  console.log('频道状态改变,新状态:', data.liveStatus);
});

四、研讨会主持加入分组讨论事件

Event 事件: ChannelEvents.SeminarHostJoinInGroup

五、研讨会主持离开分组讨论事件

Event 事件: ChannelEvents.SeminarHostLeaveGroup

六、观众累计观看时长

Event 事件: ChannelEvents.ViewerWatchDuration

回调参数: Object 对象,详细类型说明如下

属性名 说明 类型
duration 累计观看时长,单位秒 number

示例:

watchCore.channel.eventEmitter.on(ChannelEvents.ViewerWatchDuration, (data) => {
  console.log('观众累计观看时长', data.duration);
});

七、转播双师房间切换

Event 事件: ChannelEvents.TransmitDoubleRoomChange

回调参数: Object 对象,详细类型说明如下

属性名 说明 类型
to 切换到哪个类型的房间: main(主房间),child(子房间) 'main' | 'child'
roomId 房间 Id string

八、关联转播状态变更

Event 事件: ChannelEvents.TransmitChannelSwitch

回调参数: Object 对象,详细类型说明如下

属性名 说明 类型
enabled 开关 boolean

九、管理员公告跑马灯

Event 事件: ChannelEvents.ManagerBulletinMarquee

回调参数: Object 对象,详细类型说明如下

属性名 说明 类型
enabled 开关 boolean

十、测试模式变更

Event 事件: ChannelEvents.TestModeChange

回调参数: Object 对象,详细类型说明如下

属性名 说明 类型
inTestMode 当前是否处于测试模式 boolean

十一、授权过期

Event 事件: ChannelEvents.AuthExpired

联系客服,在线咨询