嵌入页消息推送

在将嵌入直播观看页嵌入到客户自有网页中，嵌入页内发生活动状态变更、链接跳转等动作，外层页面都没办法知晓并做逻辑处理，例如，嵌入页内点击外链跳转只能覆盖嵌入区域内的页面，造成跨域问题无法使用，特此提供外链跳转消息推送机制，将外链点击事件推送到主页面，供客户主页面跳转页面。

消息事件

openHref [废弃]

{
  "type": "openHref",
  "data": "https://www.vhall.com"
}

vhOpenHref

用途 : 在上层应用跳转到其他 URL 地址

{
  "type": "vhOpenHref",
  "data": "https://www.vhall.com"
}

层级	字段	类型	说明
根级	`type`	string	固定值 : `vhOpenHref`
根级	`data`	string	需要跳转的完整 URL 地址

webinarInfo

用途 : 获取被嵌入页面的详情信息

{
  "type": "webinarInfo",
  "data": {
    "webinarStatus": "live",
    "webinarType": 1
  }
}

层级	字段	类型	说明
根级	`type`	string	固定为 `webinarInfo`
根级	`data`	object	状态数据
data →	`webinarStatus`	string	页面状态 : "subscribe"(预约页), "live"(直播页)
data →	`webinarType`	number	1-直播 2-预约 3-结束 4-点播 5-回放

vhPlayerSdkEvent

用途 : 视频事件处理

{
  "type": "vhPlayerSdkEvent",
  "data": {
    "event_type": "PLAY",
    "video_content_type": 3,
    "business_id": "72035607"
  }
}

层级	字段	类型	说明
根级	`type`	string	固定值："vhPlayerSdkEvent"
根级	`data`	object	事件数据
data →	`event_type`	string	事件类型："PLAY"、"PAUSE"等
data →	`video_content_type`	number	视频播放格式
data →	`business_id`	string	租户 id

vhCustomToolsEntryClick

用途 : 底部自定义入口

{
  "type": "vhCustomToolsEntryClick",
  "data": {
    "webinar_id": 658171537,
    "extends": {
      "status": 1,
      "icon": "https://cnstatic01.e.vhall.com/upload/interacts/screen-imgs/202505/9e/d7/9ed7818c73d48f1432a75e1de262c7c63588.jpeg"
    },
    "email": "1747361983@example.com"
  }
}

层级	字段	类型	说明
根级	`type`	string	固定值：`"vhCustomToolsEntryClick"`（自定义工具入口点击事件类型）
根级	`data`	object	事件数据容器
data	`webinar_id`	number	直播活动唯一 ID（示例值：`658171537`）
data	`email`	string	用户参会邮箱（示例值：`"1747361983@example.com"`）
data.extends	-	object	扩展信息（可选字段）
data.extends	`status`	number	入口状态：`1`-开启，`0`-关闭
data.extends	`icon`	string	图标 URL（示例：`"https://.../9ed7818c.jpeg"`）

消息事件#

openHref [废弃]#

vhOpenHref#

webinarInfo#

vhPlayerSdkEvent#

vhCustomToolsEntryClick#

外链跳转示例代码#

消息事件

openHref [废弃]

vhOpenHref

webinarInfo

vhPlayerSdkEvent

vhCustomToolsEntryClick

外链跳转示例代码