화면과 보는 사람
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에 따라 제출 처리(채점 · 저장 · 거절)만 다릅니다.
상황별 값
| 상황 | scope | viewer | screen | 제출 |
|---|---|---|---|---|
| 학생이 자료를 엶 | learn | student | learn | 채점하고 저장. 점수가 수업에 반영됨 |
| 과목 관리자가 자료를 엶 | learn | instructor | learn(교육자 화면이 있어도) | 채점만 하고 저장하지 않음 |
| 튜터가 학생 화면을 봄 | learn | tutor | learn | 거절됨(read_only_mode). result와 history()는 학생의 것 |
| 편집 페이지 설정 화면 | edit | instructor | edit | 없음. saveSettings()로 저장 |
| 편집 페이지에서 저장된 버전의 학생 · 교육자 화면 미리보기 | edit | instructor | learn 또는 instructor(교육자 화면이 없으면 learn) | 서버가 판단 |
| 편집 페이지에서 draft · 저장 전 업로드 · 지난 버전 미리보기 | learn | instructor | learn | 서버 없이 흉내 내고 메모리에만 남김 |
| 저장 전 업로드의 설정 화면 | edit | instructor | edit | 없음. 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입니다. 이때 제출 · 기록은 서버에 남지 않습니다.