答題卡

功能概述

本 SDK 主要包括發起答題卡、管理答題卡題庫等功能。以下操作僅支援角色為講師/嘉賓/助教/管理員的使用者執行。

• 答題卡可以分為快速問答和普通答題卡。
  • 快速問答只有單選和多選兩種型別，沒有具體的選項內容，最多可有 5 個選項。
  • 普通答題卡題目型別包括：單選、多選、評分、投票，最多可有 15 個選項。普通答題卡還可以設定答題時長，倒數計時結束後將自動停止答題並發送結果。
• 答題卡題庫用於管理多套普通答題卡集合。
  • 預設顯示預設題庫，預設題庫不可刪除，支援應用和下載。
  • 提供題庫上傳功能。可以下載預設的題庫模板進行編輯後重新上傳。
  • 應用題庫後，該題庫內的答題卡會儲存是否已發送的狀態。重新應用題庫後已發送狀態會自動重設為未發送。
• 發起答題卡
  • 答題卡資料可以由使用者直接上傳題庫並應用，或在頁面編輯後儲存。
  • 答題中離開頁面後重新進入可以透過介面獲取房間內答題情況。
  • 答題結束後呼叫傳送結果介面，房間內所有使用者都會收到訊息。

程式碼範例

注意，在開始以下步驟前需要先進行全域初始化設定。可參考文件。

基本流程

const app = new AnswerCard();

// 订阅事件监听。
app
  .on('start', () => {})
  .on('stop', () => {})
  .on('answer', () => {})
  .on('show-result', () => {});

// 发起答题卡。操作成功后，'start' 事件会被触发。
app.start(startOptions);
// 期间如有观众提交答题，'answer'事件会被触发。

// 结束答题卡。操作成功后，'stop' 事件会被触发。
app.stop(questionId);

// 发送答题统计结果。操作成功后，'send-result'事件会被触发。
// 如需要显示统计结果，可以在事件回调中调用 `getQuestionStatistics()` 获取统计结果数据
app.sendResult(result);

多角色同步操作

支援講師/嘉賓/助教/管理員多角色間同步答題卡進行情況

// 登录聊天室房间后，查询当前答题卡进行情况
const ongoingStatus = await app.getOngoingStatus();
if (ongoingStatus.isOngoing) {
 // 正在进行答题
}