튜터링 (Tutoring)

tutoring 객체는 튜터링 모드에서 사용할 수 있는 메서드와 속성을 제공합니다.

1. 메서드

⚠️ 모든 tutoring 메서드는 Elice 플랫폼 튜터링 모드를 통해 등록된 계정의 외부 콘텐츠에 접근할 경우에만 사용할 수 있습니다.

getAccountList (계정 목록)

getAccountList 메서드를 사용하여 과목을 수강 중인 계정 목록을 불러올 수 있습니다.

다음과 같은 매개변수가 필요합니다:

  • offset: 계정 목록 페이지의 시작 위치

  • count: 가져올 계정 목록의 수

import { eliceContents } from 'src/constants';

const getAccountList = async () => {
    const accountList = await eliceContents.tutoring.getAccountList();
    console.log(accountList); // [{ fullname: 'elice', uid: 123 }, ...]
};

getAccountKvstore (계정 Kvstore)

getAccountKvstore 메서드를 사용하여 수강중인 특정 계정의 학습이력을 불러올 수 있습니다.

필수 파라미터는 다음과 같습니다:

  • uid: 계정의 고유 식별자.

  • key: kvstore의 키.

import { eliceContents } from 'src/constants';

const getAccountKvstore = async () => {
    const kvstore = await eliceContents.tutoring.getAccountKvstore({ uid: 123, key: 'quiz01.answer' });
    console.log(kvstore); // 'Elice'
};

2. 속성

isTutoringMode (튜터링 모드)

⚠️ isTutoringMode 속성은 v1.0.0 버전부터 삭제될 예정입니다. 대신 eliceContents.tutoring.isEnabled를 사용해주세요.

import { eliceContents } from 'src/constants';

console.log(eliceContents.isTutoringMode);  // false 또는 true

isEnabled (튜터링 활성화 여부)

isEnabled 속성은 튜터링 모드가 활성화되어 있는지 여부를 확인하는데 사용됩니다. 튜터링 모드가 활성화되어 있으면 값이 true이고, 그렇지 않으면 false입니다.

import { eliceContents } from 'src/constants';

eliceContents
  .init()
  .then(() => {
    console.log(eliceContents.tutoring.isEnabled); // false 또는 true
});

⚠️ 튜터링 모드는 아래 조건을 모두 충족할 때 활성화됩니다:

  • 사용자가 Elice 플랫폼 튜터링 모드를 통해 등록된 계정의 외부 콘텐츠에 접근한 경우

  • 외부 콘텐츠 SDK가 초기화된 경우

Last updated