メインコンテンツまでスキップ

画面と閲覧者

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をアップロードしてもリセットされません。

画面ごとのURL​

LXPがコンテンツを表示するURLのフラグメントで画面が決まります。コンテンツがこの値を直接扱う必要はなく、init()が読み取ります。

URLタイミング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です。このとき、提出・記録はサーバーに残りません。