问卷

问卷是直播中收集观众数据，沉淀营销线索的直播利器，集成问卷功能后通过SDK进入的观众即可完成问卷提交。

关键方法

方法	方法描述
VHSaaSDK.getInstance().performQuestionnaireListIn	获取历史问卷列表
VHSaaSDK.getInstance().getSurveyAnswerReplay	获取用户提交的答案
VHSaaSDK.getInstance().getLastPublishWebinarSurvey	获取最新发布的问卷
VHSaaSDK.getInstance().getInteractAwardList	问卷关联的我的礼品列表
VHSaaSDK.getInstance().setQaLike	设置问卷同问
VHSurveyInternal.getSurveyUrl	获取问卷嵌入Url

事件监听

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

关键事件

方法	方法描述
VHRoomEventType.QUESTIONNAIRE_PUSH	问卷消息

问卷消息

当主播正在直播，可以发布问卷，观看用户可以显示问卷

发起问卷

VHRoomEventType.QUESTIONNAIRE_PUSH

代码示例

推送问卷信息

VHQuestionnairePushModel 类定义

房间推送问卷消息的基本信息

VHQuestionnairePushModel成员	类型	描述
mandatory_filling	number	是否必填（0：非必填，1：必填，默认0）
questionnaire_id	string	问卷ID
room_join_id	string	房间加入ID
nick_name	number	创建者昵称
alias	string	用户别名
room_role	number	房间角色
type	string	消息类型
title	string	问卷标题

获取历史问卷列表

接口API

接口入参

参数名称	是否必须	示例	备注
switch_id	是	2222	场次id
roomId	是	lss123345	房间id
webinar_id	是	123456789	活动id
callback	是	xxxx	VHQuestionnaireCallback

查询房间历史问卷

问卷列表信息

VHHistoryQuestionnaireInfo类定义

初始化活动时通过接口回调获取的房间历史问卷基本信息。

VHHistoryQuestionnaireInfo 成员	类型	描述
total	number	个数
list	VHHistoryQuestionnaire	问卷标题内容
my_award_status	number	中奖状态 0-不可用 1-可用
limit	number	条目数
total	number	个数
pos	number	开始位置

问卷标题内容

VHHistoryQuestionnaire 类定义

获取的问卷标题基本信息。

VHHistoryQuestionnaire 成员	类型	描述
title	string	名称
webinar_id	number	活动id
question_id	number	问卷id
question_no	string	问卷编号
alias	string	别名
is_answered	string	是否参与 1参与 0未参与
created_at	string	创建时间
updated_at	string	更新时间

获取问卷嵌入Url

接口API

SDK问卷填写部分以嵌入方式实现。当收到问卷推送消息后，根据问卷id调用此接口获取嵌入地址，使用Webview进行加载显示。

  public static getSurveyUrl(webinars: VHWebinarData, id: string): string

接口入参

参数名称	是否必须	示例	备注
webinars	是		initWatch响应信息
id	是		问卷id

问卷关联的我的礼品列表

接口API

接口入参

参数名称	是否必须	示例	备注
pos	是	0	列表起始位置
limit	是	200	个数
callback	是	xxxx	VHInteractMyAwardListCallback

问卷关联的我的礼品示例代码

问卷关联的互动有礼奖品列表数据

VHInteractMyAward 问卷关联的互动有礼奖品信息。

VHInteractMyAward 成员	类型	描述
total	number	奖品数量
list	VHInteractMyAwardDetails	礼物详情
pos	number	请求位置
limit	number	请求个数

礼物详情

VHInteractMyAwardDetails 问卷关联的互动有礼奖品列表数据详情。

VHInteractMyAwardDetails 成员	类型	描述
id	number	记录id
receive_award_way	number	领奖方式，1-寄送奖品 2-私信兑奖 3-无需领奖
display_of_results	number	展示效果，0-全屏（默认） 1-半屏
award_name	string	奖品名称
award_img_url	string	奖品图片地址
winning_time	string	中奖时间
status	number	领取状态，0-未领取 1-已领取 2-已中奖
winner_award_remark	string	中奖者领奖备注，即：用户提交的领奖信息
interact_reward_id	number	互动有礼id
compulsory_award	number	强制领奖：0否 1是

获取用户提交的答案

接口API

接口入参

参数名称	是否必须	示例	备注
surveyId	是	161657	问卷id
callback	是	xxxx	VHSurveyAnswerReplayCallback

获取提交的答案

获取提交的答案

VHSurveyAnswerReplayList 成员	类型	描述
answer_replay_list	VHSurveyAnswerReplayInfo[]	答案内容

答案内容

VHSurveyAnswerReplayInfo 成员	类型	描述
id	string	问卷ID
question_answer_id	number	答案ID
third_party_user_id	string	用户ID
question_id	number	问题ID
answer	string	答案

设置问卷同问

接口API

接口入参

参数名称	是否必须	示例	备注
webinarId	是	161657	直播id
questionId	是	983032	问题id
likeStatus	是	0	是否点赞
callback	是	xxxx	VHCallBack

设置问卷同问示例代码

获取最新发布的问卷

接口API

接口入参

参数名称	是否必须	示例	备注
room_id	是	lss123345	房间id
start_time	是		对应场次的开始时间
end_time	否		对应场次的结束时间
callback	是	xxxx	VHLastPublishWebinarSurveyCallback

获取最新发布的问卷示例代码

获取的最后一次推送的问卷信息

VHWebinarSurvey通过接口回调获取到的获取最后一次推送的问卷信息基本信息。

VHWebinarSurvey 成员	类型	描述
account_id	string	发送用户id
alias	string	别称
app_id	string	应用id
category	number	分类
cover	string	遮罩
created_at	string	创建时间
description	string	描述
extend	string	拓展信息
is_public	number	公共信息
question_id	number	问卷id
question_no	string	问卷序号
title	string	标题
topic_num	number	标题编号

VHWebinarSurveyExtend 类定义

进行直播活动时通过接口回调获取到的获取最新发布的问卷的基本信息。

VHWebinarSurveyExtend 成员	类型	描述
mandatory_filling	number	是否开启强制提交
privacy_agreement	number	开启隐私协议
playback_filling	number	是否开启回放填写问卷
has_tpl	number	是否有模板
phone_verification_switch	number	是否开启手机验证
enable_banner	number	是否开启banner

互动-问卷

问卷#

关键方法#

事件监听#

关键事件#

问卷消息#

发起问卷#

推送问卷信息#

获取历史问卷列表#

问卷列表信息#

问卷标题内容#

获取问卷嵌入Url#

问卷关联的我的礼品列表#

问卷关联的互动有礼奖品列表数据#

礼物详情#

获取用户提交的答案#

获取提交的答案#

答案内容#

设置问卷同问#

获取最新发布的问卷#

获取的最后一次推送的问卷信息#

问卷

关键方法

事件监听

关键事件

问卷消息

发起问卷

推送问卷信息

获取历史问卷列表

问卷列表信息

问卷标题内容

获取问卷嵌入Url

问卷关联的我的礼品列表

问卷关联的互动有礼奖品列表数据

礼物详情

获取用户提交的答案

获取提交的答案

答案内容

设置问卷同问

获取最新发布的问卷

获取的最后一次推送的问卷信息