본문으로 건너뛰기

화면과 보는 사람

SDK는 어느 페이지가 콘텐츠를 열었는지(scope), 누가 보는지(viewer), 어떤 진입 파일이 실행 중인지(screen)를 구분합니다. 값은 init()이 끝난 뒤에 읽습니다.

sdk.scope; // 'learn' | 'edit' 어느 페이지가 열었나
sdk.viewer; // 'student' | 'instructor' | 'tutor' 누가 보나
sdk.screen; // 'learn' | 'instructor' | 'edit' 어떤 진입 파일이 실행 중인가
sdk.account; // { anonymousId: 'a1b2…', fullname: null }
sdk.result; // { score: 50, submitCount: 2, completedAt: null } 또는 null
sdk.isDraft; // 편집 화면의 미리보기 · 저장 전 업로드면 true

교육자도 학습 페이지에서는 학생 화면을 봅니다​

학습 페이지(learn 범위 토큰)에서는 보는 사람과 상관없이 screen이 늘 learn입니다. 교육자 화면(instructor)은 편집 페이지 미리보기에서 교육자를 골랐을 때만 열립니다.

그러니 학습 페이지에서 교육자에게만 보일 기능을 학생 화면 안에서 viewer로 나누지 마세요. 학생 화면은 누가 보든 같은 화면이고, viewer에 따라 제출 처리(채점 · 저장 · 거절)만 다릅니다.

상황별 값​

상황scopeviewerscreen제출
학생이 자료를 엶learnstudentlearn채점하고 저장. 점수가 수업에 반영됨
과목 관리자가 자료를 엶learninstructorlearn(교육자 화면이 있어도)채점만 하고 저장하지 않음
튜터가 학생 화면을 봄learntutorlearn거절됨(read_only_mode). result와 history()는 학생의 것
편집 페이지 설정 화면editinstructoredit없음. saveSettings()로 저장
편집 페이지에서 저장된 버전의 학생 · 교육자 화면 미리보기editinstructorlearn 또는 instructor(교육자 화면이 없으면 learn)서버가 판단
편집 페이지에서 draft · 저장 전 업로드 · 지난 버전 미리보기learninstructorlearn서버 없이 흉내 내고 메모리에만 남김
저장 전 업로드의 설정 화면editinstructoredit없음. saveSettings()는 draft_not_saved
  • edit 토큰으로 연 화면(설정 화면 · 편집 페이지 미리보기)에서는 account와 result가 null입니다.
  • account.anonymousId는 학습자를 구분할 때 쓰는 익명 id입니다. 학습자 개인정보 대신 이 값을 씁니다.
  • result는 자료 단위입니다. score는 가장 최근 채점 값, submitCount는 누적 제출 수, completedAt은 처음 완료된 시각이고 지워지지 않습니다. 교육자가 새 zip을 올려도 초기화되지 않습니다.

화면별 주소​

LXP가 콘텐츠를 띄우는 주소의 fragment로 화면이 정해집니다. 콘텐츠가 이 값을 직접 다룰 일은 없고, init()이 읽습니다.

주소언제SDK 동작
…/index.html#token=…학습 페이지(학생 · 교육자 · 튜터, 모두 학생 화면)서버와 통신
…#token=… (edit 범위 토큰)편집 페이지에서 설정 화면(entries.edit)을 띄울 때settings는 draft 값, saveSettings()가 draft에 저장
…#token=…&screen=learn, …&screen=instructor편집 페이지에서 저장된 버전의 학생 · 교육자 화면을 미리 볼 때해당 화면으로 열림
…#preview=1편집 페이지에서 저장 전 업로드를 미리 볼 때서버 없이 동작. 제출은 메모리에만 남고 채점을 흉내 냄
…#token=…&preview=1편집 페이지에서 draft의 학생 화면을 draft 설정값으로 미리 볼 때자료(draft settings)만 토큰으로 읽고, 제출 · 기록은 메모리에만
…#token=…&preview=1&versionId=…편집 페이지 버전 기록에서 지난 버전을 그 버전의 설정값으로 미리 볼 때그 버전의 settings · 진입 파일을 읽음. 없는 버전이면 init()이 invalid_param으로 실패
…#edit=1편집 페이지에서 저장 전 업로드의 설정 화면을 띄울 때서버 없이 동작. saveSettings()는 draft_not_saved

sdk.isDraft는 #preview=1(토큰이 있어도), edit 토큰 + versionId, #edit=1일 때 true입니다. 이때 제출 · 기록은 서버에 남지 않습니다.