簽到

功能概述

• 本功能僅支援角色為講師/嘉賓/助教/管理員的使用者進行發起和停止等操作。
• 發起簽到時可自訂設定簽到時長和簽到提示語。

程式碼範例

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

基本流程

const app = new CheckIn();
let appData = {
  checkInId: '',
};

// 订阅事件监听。
app
  .on('start', ({ checkInId, tips, duration }) => {
    appData = Object.assign(appData, { checkInId, tips, duration });
  })
  .on('stop', () => {})
  .on('show-result', ({ checkInId }) => {
  // 获取签到详情。
  app.getCheckInDetail({ checkInId });
  // 调用接口 app.downloadCheckInDetail() 可以下载签到详情的 Excel 文件。
});

// 如果需要多端同步，可以在初始化完成后，获取签到状态及签到文案、剩余时间、总时长等。
const { isCheckingIn } = app.getCheckInStatus();
// 发起签到。操作成功后，'start' 事件会被触发。
app.start({ tips: '同学们，开始签到啦！', duration: 30 });

// 定时器每秒更新签到人数。
let timer = 0;
function clearTimer() {
  if (!timer) return;
  clearTimeout(timer);
  timer = 0;
}
async function updateCheckInNum() {
  app.getCheckInNum();
  clearTimer();
  timer = setTimeout(updateCheckInNum, 1000);
}
updateCheckInNum();

// 结束签到。操作成功后，'stop' 事件会被触发。
app.stop();
// 发送签到统计结果。
app.sendResult(appData.checkInId);