开放平台
平台概述
开发者文档
  • API文档
  • SDK文档
  • 接入指南
  • 集成方案
产品功能
  • 新手入门
  • 产品功能
常见问题首页
平台概述
开发者文档
  • API文档
  • SDK文档
  • 接入指南
  • 集成方案
产品功能
  • 新手入门
  • 产品功能
常见问题首页
  1. 互动工具
  • DEMO示例
  • JS SDK
    • web 点播 sdk
      • 更新记录
      • 点播上传SDK
    • web 观播 sdk
      • 产品介绍
      • 快速接入
      • 对接示例
      • 观看直播
      • 文档白板
      • 互动连麦
      • 暖场视频
      • 全局事件
      • 全局错误码
      • 房间消息说明
      • 版本更新记录
      • 互动工具
        • 互动-抽奖
        • 互动-礼物
        • 互动-签到
        • 互动-问卷
        • 互动-公告
        • 互动-商品
        • 互动-问答
        • 互动-推屏卡片
        • 互动-快问快答
        • 互动-聊天
        • 互动-优惠券
        • 互动-点赞
      • 直播间拓展功能
        • 资料下载
        • 观看限制验证
        • 观看协议
        • 回放章节
  • iOS SDK
    • 整体介绍
    • 快速接入
    • SDK 登录
    • 暖场视频
    • 视频轮询
    • 直播彩排
    • 高级美颜
    • 云导播
    • 观看协议
    • 文档白板演示
    • 聊天功能
    • 视频直播
      • 发起视频直播
      • 观看视频直播
    • 互动直播
      • 观众互动
      • 推流摄像头
      • 互动直播API
      • 主播发起互动直播
      • 嘉宾加入互动直播
    • 无延迟直播
      • 主播发起无延迟直播
      • 观众观看无延迟直播
    • 互动工具
      • 互动-抽奖
      • 互动-礼物
      • 互动-签到
      • 互动-问卷
      • 互动-章节打点
      • 互动-公告
      • 互动-商品
      • 互动-计时器
      • 互动-问答
      • 互动-推屏卡片
      • 互动-快问快答
      • 互动-优惠券
      • 互动-点赞
    • 直播间拓展能力
      • 直播间特色功能配置项
      • 文件下载
      • 修改角色昵称
      • 观看权限校验
      • 投屏
      • 虚拟人数
    • 观看回放
      • 观看回放
    • 防录屏
      • 跑马灯
    • 字段说明
      • 互动活动详情字段
      • 错误码说明
      • 常量定义
      • 活动详情字段说明
    • 版本更新说明
      • 版本更新信息
      • v2.3.0 到 v2.4.0 升级说明
      • v3.0.1 到 v3.2.0 升级说明
      • V2.9.0到v3.0.1升级说明
      • v6.3.0
      • v6.2.1
      • v3.2.0 到 v4.0.1
      • v2.7.0 到 v2.8.0、v2.9.0 升级说明
      • 6.5.0
      • v5.0.x 到 v6.0.0
      • v6.4.0
  • Adroid SDK
    • 整体介绍
    • 快速接入
    • SDK登录
    • 暖场视频
    • 视频轮巡功能
    • 直播彩排
    • 高级美颜
    • 云导播功能
    • 观看协议
    • 文档白板
    • 聊天功能
    • 房间消息
    • 信息采集说明
    • 视频直播
      • 发起视频直播
      • 观看视频直播
    • 互动直播
      • 互动直播API
      • 主播发起互动直播
      • 嘉宾加入互动直播
      • 观众观看互动直播
    • 无延迟直播
      • 主播发起无延迟直播
      • 观众观看无延迟直播
    • 互动工具
      • 互动-抽奖
      • 互动-礼物
      • 互动-签到
      • 互动-问卷
      • 互动-公告
      • 互动-商品
      • 互动-计时器
      • 互动-问答
      • 互动-推屏卡片
      • 互动-快问快答
      • 互动-优惠券
      • 互动-点赞
    • 直播拓展功能
      • 修改角色名称
      • 文件下载
      • 投屏演示
      • 虚拟人数
      • 观看权限校验
      • 直播间特色功能配置项
    • 观看回放
      • 观看回放/点播
    • 防录屏
      • 直播水印
      • 跑马灯
    • 字段说明
      • 房间消息字段说明
      • 聊天消息字段说明
      • 活动详情字段说明
    • 更新记录
      • 更新记录
    • 版本更新说明
      • v6.4.0
      • v6.3.0
      • v6.2.3
      • v6.2.1
      • v6.2.0
      • v6.1.0
      • v6.0.0
      • v5.0.0
      • v4.1.0
      • v4.0.0
      • v3.3.0
  • Harmony SDK
    • 整体介绍
    • 快速接入
    • SDK初始化
    • 登录&登出
    • 活动基础信息
    • 观看协议
    • 观看权限校验&预约
    • 开屏海报
    • 暖场视频
    • 观看直播
    • 观看回放/点播
    • 聊天
    • 房间消息
    • 在线人数&热度
    • 文档/白板
    • 版本更新
    • 私聊
    • 播放器错误码
    • 互动工具
      • 互动-问答
      • 互动-问卷
      • 互动-公告
      • 互动-抽奖
      • 互动-签到
      • 互动-计时器
      • 互动-礼物
      • 互动-互动有礼
      • 互动-快问快答
      • 互动-口令红包
      • 互动-推屏卡片
      • 互动-商品
      • 互动-优惠卷
      • 互动-观看有礼
      • 互动-点赞
    • 防录屏
      • 播放器水印&跑马灯
    • 菜单
      • 自定义菜单
      • 文件下载
      • 概要总结
      • 回放列表
      • 邀请卡
  • 微信小程序 SDK
  • 相关协议
    • 微吼直播 SDK 隐私政策
    • 微吼直播 SDK 开发者使用规范
  1. 互动工具

互动-快问快答

快问快答#

提供直播间内的可视化问答式互动能力,在直播间进行随堂测验,完成【出题 → 快速答题 → 即时得分 → 得分排行榜】的全过程,增强直播间的内容传递效果

关键方法#

方法方法描述
VHSaaSDK.getInstance().performExamIn获取快问快答列表
VHSaaSDK.getInstance().setExamUserAnswerStatus指定快问快答的用户答题状态
VHSaaSDK.getInstance().getExamUserPerformanceList快问快答成绩排名列表
VHSaaSDK.getInstance().getExamPersonalReport查看个人成绩详情
VHExamInternal.getExamUrl快问快答嵌入页

事件监听#

方法方法描述
imReceiveRoomMessage消息回调监听

关键事件#

方法方法描述
VHRoomEventType.PAPER_SEND发送答题
VHRoomEventType.PAPER_SEND_RANK公布成绩
VHRoomEventType.PAPER_AUTO_SEND_RANK自动公布成绩
VHRoomEventType.PAPER_END结束答题

发送答题#

当主播正在直播,可以发布快问快答,观看用户可以进行答题
VHRoomEventType.PAPER_SEND
接收房间消息

快问快答推送信息#

VHExaminationModel 类定义
VHExaminationModel 成员类型描述
role_namestring角色名称
send_timestring发送时间
answer_conditionAnswerRecord配置信息
paper_titlestring试卷标题
webinar_idstring活动id
nick_namestring创建人昵称
typestring消息类型
paper_idstring考试ID
send_time_stampnumber当前时间

公布成绩和自动公布成绩消息#

VHExamRank 成员类型描述
paper_titlestring标题名称
webinar_idstring活动id
role_namestring公布者角色
nick_namestring公布者昵称
typestring消息类型
paper_idstring快问快答id
answer_conditionAnswerRecord配置信息

快问快答配置信息#

AnswerRecord 成员类型描述
viewing_minutesnumber累计观看时长可参与答题
typenumberviewing_minutes 对应的单位类型(分或秒)

快问快答配置信息#

当主播正在直播,答题完成之后,可以公布答题成绩,或者自动公布成绩
VHRoomEventType.PAPER_SEND_RANK
VHRoomEventType.PAPER_AUTO_SEND_RANK
接收房间消息

结束答题#

当主播正在直播,点击收卷之后,用户就不能在继续答题
VHRoomEventType.PAPER_END
接收房间消息

获取快问快答列表#

接口 API
接口入参
参数名称是否必须示例备注
source_id是966397514数据来源id
source_type是1数据类型
switch_id是213123场次id
scene_type是0场景类型
callback是xxxVHExamListCallback
接口使用示例
  ExamListHttp() {
    VHSaaSDK.getInstance()
      .performExamIn(this.webinar_info?.webinar?.id!, 1, this.webinar_info?.switch_info?.switch_id!, 0, {
        onSucceed: (data) => {
          this.ExamList = data as VHExamList[]
          console.log(`获取快问快答列表成功: ${JSON.stringify(data)}`);
        },
        onFailure: (errorCode, errorMsg) => {
          console.log(`获取快问快答列表失败: ${errorMsg}`);
        }
      })
  }

快问快答列表数据#

VHExamList 成员类型描述
titlestring试卷标题
push_timestring创建时间
scorenumber得分
question_numstring问卷题数
limit_timenumber限时(数值)
limit_time_switchnumber限时开关 0关闭 1开启
statusnumber是否作答 0. 否 1. 是
is_endnumber答题是否结束 0. 否 1. 是
paper_idnumber试卷 id
limit_time_typenumber限时单位类型:0 分(默认) 1 秒
display_scorenumber是否显示成绩和答案:1.是,0.否
mandatory_fillingnumber是否强制填写,0-否(默认) 1-是
push_modenumber推送方式,0-手动(默认) 1-自动
can_re_answernumber是否可重新作答,0-否(默认) 1-是
answer_conditioncondition答题条件
replay_fillingnumber是否支持回放填写,0-否(默认) 1-是
total_scorenumber总分
condition定义
condition 成员类型描述
typenumber类型
viewing_minutesnumber观看分钟数

指定快问快答的用户答题状态#

接口 API
接口入参
参数名称是否必须示例备注
paper_id是xxx试卷id
source_id是209182911活动id
switch_id是xxx场次id
callback是xxxVHExamUserAnswerStatusCallback
接口使用示例
 private handleExamEnd(message: VHIMMessageModel) {
    this.VHExamDialog.close()
    this.examData = message.data as VHExaminationModel
    VHSaaSDK.getInstance()
      .setExamUserAnswerStatus(this.examData.paper_id,this.webinar_info?.webinar?.id!,
        this.webinar_info?.switch_info?.switch_id!, {
          onSucceed: (data: VHExamUserAnswerStatus) => {
            ToastUtil.showToast('data')
          },
          onFailure: (errorCode: number, errorMsg: string) => {
            ToastUtil.showToast(errorMsg)
          }
        });

    this.pageInfos.removeByName("ExamPage")
    ToastUtil.showToast("答题已结束")
  }
用户答题状态信息#
VHExamUserAnswerStatus 成员类型描述
answer_conditionAnswerRecord配置信息
display_scorenumber是否显示成绩和答案,0-否 1-是
is_endnumber答题是否已结束,0-否 1-是
limit_timenumber限制时长
limit_time_switchnumber限制时长开关,0-关 1-开
limit_time_typenumber限制时长类型,0-分 1-秒
mandatory_fillingnumber是否强制填写,0-否(默认) 1-是
paper_idnumber快问快答id
push_timestring推送时间,格式:yyyy-MM-dd HH:mm:ss
question_numnumber题目数量
right_ratestring正确率
scorenumber得分
statusnumber答题状态,0-未作答 1-已作答
titlestring标题
total_scorenumber试卷总分

快问快答成绩排名列表#

接口 API
接口入参
参数名称是否必须示例备注
paper_id是596384试卷id
limit是10每页数量
pos是0每页数量
callback是xxxVHExamPerformanceCallback
接口使用示例
 aboutToAppear(): void {
    //获取前50个成绩
    VHSaaSDK.getInstance().getExamUserPerformanceList(this.examRank.paper_id,50,0,{
      onSucceed: (data: VHExamReportList) =>{
        if(data.total > 0){
          this.highlightDataSource.updateData(data.list);
        }
      },
      onFailure: (errorCode: number, errorMsg: string) => {

      }
    });
    //获取自己的成绩 VHSaaSDK.getInstance().getExamPersonalReport(this.webinar_info.webinar?.id.toString()!,this.examRank.paper_id, {
      onSucceed: (data: VHExamPersonalReport) =>{

      },
      onFailure: (errorCode: number, errorMsg: string) => {

      }
    });

  }

成绩排名列表信息#

VHExamReportList 成员类型描述
totalnumber总数量
listVHExamReport[]成绩排名详情信息
VHExamReport 成员类型描述
idnumber快问快答id
account_idstring账户id
account_typenumber默认0
user_namestring姓名
head_imgstring头像地址
rank_nonumber排名
total_scorenumber排名
right_ratestring正确率
scorenumber得分
use_timenumber用时 秒
is_initiativenumber是否主动交卷 0.否 1.是
statusnumber是否有效 0.否 1.是
mobilestring手机号
emailstring邮箱
join_timestring参与答题时间 格式:yyyy-MM-dd HH:mm:ss

快问快答嵌入页#

快问快答的答题部分由以嵌入页web实现。当收到快问快答推送消息后,通过此方法获取嵌入地址加载webview。
接口 API
接口入参
参数名称是否必须示例备注
webinars是initWatch初始化数据
exam_id是快问快答id
接口使用示例
    this.ExamUrl =
      VHExamInternal.getExamUrl(this.webinar_info!, id, type) as string

查看个人成绩详情#

接口 API
接口入参
参数名称是否必须示例备注
webinarId是596643384活动id
paper_id是xxx试卷id
callback是xxxVHExamPersonalReportCallback

个人成绩详情信息#

VHExamPersonalReport 成员类型描述
account_idstring账户id
account_typestring默认 0
can_re_answernumber是否可重新作答,0-否(默认) 1-是
emailstring邮箱
error_numnumber错误个数
head_imgstring头像地址
is_initiativenumber是否主动交卷 0.否 1.是
mobilestring手机号
question_detailstring答题详情
ranknumber个人排名 ,0 为无成绩
rank_allnumber排行榜总数
right_numnumber正确数
right_ratestring正确率
scorenumber得分
total_scorenumber问卷总分
unanswer_numnumber未答数
titlestring标题
use_timestring用时 秒
user_formstring题型
user_infostring用户信息
user_namestring用户名
修改于 2025-11-19 08:22:07
上一页
互动-互动有礼
下一页
互动-口令红包
Built with