問卷

功能概述

• 本 SDK 主要包括管理問卷資料和開始問卷互動的功能。以下操作僅支援角色為講師/嘉賓/助教/管理員的使用者執行。
• 問卷題目類型可分為選擇題和問答題。
  • 選擇題分為單選題和多選題，可設定必填和題目分數功能。
  • 問答題：可設定必填，不可設定題目分數。
• 問卷管理
  • 支援新增和刪除問卷功能。
  • 提供問卷匯入功能，可以下載預設的範本進行編輯後重新上傳。
  • 可發布問卷、停止問卷、發送問卷結果。
  • 取得發布過的歷史問卷列表和問卷詳情。
  • 取得房間內提交人數。
  • 下載問卷統計結果。

數量限制

開發時需要注意做好以下限制，否則在請求介面時會回傳失敗。

• 單份問卷的最大題目數量：100
• 每道單選題/多選題的選項個數最多 10 個，最少 2 個
• 字數限制。注意一個非英文字元佔用 2 個字元，如 "中文abc" 應算作 7 個字元。
  • 問卷名稱：60
  • 選項內容：400
  • 題目內容：500

基本流程

1. new Questionnaire()

const app = new InteractionsLaunchSDK.Questionnaire();

// 注册监听事件 在 Polyv 聊天室连接成功后，立即调用 `on()` 注册监听事件。
app
        // 成功广播开始问卷消息后，`'start'` 事件被触发，执行回调。
        .on('start', this.handleStart)
        // 收到问卷结束消息后， `'stop'`件被触发，执行回调 。
        .on('stop', this.handleStop)
        // 每次观众提交回答， `'answer'` 事件都会被触发一次，执行回调。
        .on('answer', this.handleAnswer)
        // 调用 `app.sendResult()` `'show-result'` 事件触发，执行回调。
        .on('show-result', this.handleShowResult);

// 上传问卷数据。
app.uploadTemplate(file);
// 编辑或创建问卷。
app.save(questionnaire);
// 发起问卷。
app.start(questionnaireData);
// 分页获取问卷列表，可以获取到某个频道号下的所有问卷，列表中问卷状态值为 `'published'` 的是正在进行的问卷。
app.getQuestionnairePageList({pageNumber, pageSize});
// 获取问卷详情。包括问卷基本信息、问卷题目列表、提交结果统计数据（如果问卷已结束）。
app.getQuestionnaireDetail(questionnaireId);