画面と閲覧者
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をアップロードしてもリセットされません。
画面ごとの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です。このとき、提出・記録はサーバーに残りません。