The SCORM Run-Time Environment

Definition

_children キーワードは、LMS がサポートする core カテゴリ内のすべての要素を取得するために使用する。子を持たないがサポートされている要素については、空文字列が返される。要素自体がサポートされていない場合も空文字列が返される。続けて last error を要求することで、その要素がサポートされていないかどうかを確認できる。

Usage

LMS がどの cmi.core データ要素をサポートしているかを判定するために使用する。

Format

戻り値は、LMS がサポートする core カテゴリ内のすべての要素名のカンマ区切りリスト。

LMS Behavior

• Initialization: このグループのサポート対象子要素のセットを初期化する。LMSGetValue() 要求に対して適切なリストを返せるようにする。
• LMSGetValue(): サポートされている要素のカンマ区切りリストを返す。
  • API 呼び出し例：LMSGetValue("cmi.core._children")
  • 典型的な戻り値："student_id,student_name,lesson_location,credit,lesson_status,entry,score,total_time,exit,session_time"
  • Error Code：401 — Not implemented error。本要素は必須なので LMS がサポートしなければならない。
• LMSSetValue(): 本要素はキーワードのため、設定不可。402（Invalid set value, element is a keyword）を返す。

SCO Usage Example

var coreChildren = LMSGetValue("cmi.core._children");
if (coreChildren.indexOf("student_name") != -1)
{
    studentName = LMSGetValue("cmi.core.student_name");
}

Definition

LMS の単一ユーザーを参照する一意な英数字コード／識別子。

Usage

学習者を一意に識別するために使用する。

Format

スペースを含まない最大 255 文字の英数字。ハイフンとアンダースコアは使用可。ピリオドは使用不可。大文字小文字は区別しない。

LMS Behavior

• Initialization: 学習者登録に基づき LMS が責任を持つ。
• LMSGetValue(): LMS が学習者について保持する現在値を返す。
  • 戻り値の例："Joe_Student1"、"JS-2000"、"joe2000-3"
  • Error Code：401 — Not implemented error（必須要素のためサポート必須）
• LMSSetValue(): 読み取り専用。403（Element is read only）を返す。

SCO Usage Example

var coreStudentID = LMSGetValue("cmi.core.student_id");

Definition

通常はコース名簿で使用される学習者の正式名。ファーストネームのみではなく完全な名前。

Usage

学習者の正式名を表すために使用する。

Format

姓、名、ミドルイニシャルの順。姓と名はカンマで区切る。名前内のスペースは保持される。

LMS Behavior

• Initialization: 学習者登録に基づき LMS が責任を持つ。
• LMSGetValue(): LMS が保持する現在値を返す。
  • 戻り値の例："Student, Joseph A."、"Student, Mike A. Jr."
• LMSSetValue(): 読み取り専用。403 を返す。

SCO Usage Example

var coreStudentName = LMSGetValue("cmi.core.student_name");

Definition

学習者が前回 SCO を経験した際に LMS に渡された SCO の出口点に対応する。学習者が以前に離脱した位置から SCO に戻れるようにする 1 つの仕組みとなる。すなわち、本要素は学習者の出口点を識別でき、その出口点を SCO は次回起動時の入り口点として利用できる。

Usage

学習者が SCO 内で最後にどこにいたかを表す。SCO がセッション中に「ブックマーク」として保存する用途に使える。SCO が中断され後で再開された場合、SCO は lesson_location を使って学習者を離脱位置に戻すことができる。

Format

実装依存。LMS は本データを保持し、学習者が再入する際に SCO が要求すれば返す。SCO が LMS に渡したものがそのまま返される。フォーマットは SCO が期待する形式（SCO 自身が作成する）。SCO への初回入場時、または推奨開始位置がない場合、lesson_location は空文字列 ("") でよい。

LMS Behavior

• Initialization: LMS は空文字列に設定すべき。SCO が任意で値を設定し、SCO 再入時に取得できる。
• LMSGetValue(): LMS が保持する現在値を返す。Error Code 401。
• LMSSetValue(): 渡された値でデータモデル要素を設定する。値はデータ型に一致しなければならない。Error Code：405（Incorrect Data Type）、401。

SCO Usage Example

// HTML のアンカーを使う SCO の例（onLoad で呼び出す関数）
var coreSCOLocation = LMSGetValue("cmi.core.lesson_location");
if (LMSGetLastError() == "0")
{
    // coreSCOLocation には HTML 内のアンカー名が入っている
    // 学習者を前回離脱位置から再開させる
    window.location.hash = coreSCOLocation;
}
else
{
    // エラー処理
}

Definition

学習者がこの SCO のパフォーマンス（合否やスコア）に基づき LMS によって credit（評価）を付与されるかどうかを示す。

Usage

学習者が SCO を credit 対象として受講しているかどうかを LMS が示すために使用する。cmi.core.credit は lesson_mode と組み合わせて使用される。詳細は cmi.core.lesson_mode を参照。cmi.core.credit は lesson_status の決定にも使用される。詳細は cmi.core.lesson_status を参照。

Format

定義済み語彙のいずれか：

• "credit"：学習者は SCO を credit 対象として受講している。SCO が LMS にデータを送信した場合、LMS は学習者にそれを credit する。
• "no-credit"：学習者は SCO を no-credit で受講している。現在の credit（たとえばスコア 80 で passed）は、この SCO のパフォーマンスによって変更されない。

LMS Behavior

• Initialization: 学習者がコースを credit／no-credit のどちらで受講しているかは LMS が決定する。SCORM では credit／no-credit の指定方法を定義していないため、実装は LMS 固有となる。
• LMSGetValue(): 現在値（"credit" または "no-credit"）を返す。Error Code 401。
• LMSSetValue(): 読み取り専用。403。

SCO Usage Example

var creditFlag = LMSGetValue("cmi.core.credit")
if (creditFlag == "credit")
{
    // credit 対象。それに応じた処理
}
else
{
    // no-credit 対象。それに応じた処理
}

Definition

LMS が判定する現在の学習者ステータス。可能な値は 6 つ。

Usage

通常、SCO 自身がステータスを決定し LMS に渡す。次の挙動に注意：

1. cmi.core.credit が "credit" で、manifest に adlcp:masteryscore がある場合、LMS は学習者のスコアと mastery score の比較に応じて、ステータスを "passed" または "failed" に変更できる。
2. manifest に mastery score がない場合、LMS は SCO が決定したステータスを上書きできない。
3. 学習者が SCO を no-credit で受講している場合、lesson_status は変更されない。ただし例外として、lesson_mode が "browse" の場合、no-credit であっても lesson_status は "browsed" に変更されることがある。

Format

定義済み語彙のいずれか：

• "passed"：必要数の objective に習熟した、または必要なスコアを達成した。SCO 完了かつ合格。
• "completed"：合格／不合格に関わらず、SCO 内のすべての要素を経験した。たとえば、合格判定が LMS 側のスコアに依存し、SCO は素点しか把握していない場合に使う。
• "failed"：SCO に合格しなかった。すべての要素を完了していない場合もある。SCO 完了かつ不合格。
• "incomplete"：SCO を開始したが完了していない。
• "browsed"：初回試行時、LMS モード「Browse」で SCO を起動した。
• "not attempted"：SCO を開始すらしていない（目次や概要のみを見て、まだ準備ができないと判断した等）。"not attempted" から "incomplete" への移行判定アルゴリズムは SCO 内で任意に決定できる。

LMS Behavior

• Initialization: 初回試行時、LMS は "not attempted" を初期値として設定する。SCO が cmi.core.lesson_status を設定しない場合の追加要件：
  • 初回起動時、LMS は cmi.core.lesson_status を "not attempted" に設定する。
  • LMSFinish() を受信、または学習者が画面遷移した場合、LMS は cmi.core.lesson_status を "completed" に設定する。
  • "completed" 設定後、LMS は cmi.student_data.mastery_score（サポートされていれば）または manifest に mastery score が指定されているかチェックする。指定があり SCO が cmi.core.score.raw を設定していれば、LMS は raw スコアと mastery score を比較して "passed" または "failed" に設定する。指定がなければ "completed" のままとする。
• LMSGetValue(): データモデルに保存された値を返す。値は定義済み語彙のいずれか。Error Code 401。
• LMSSetValue(): 値はデータ型に一致しなければならない。Error Code 405、401。

SCO Usage

• "passed"：SCO を credit で受講する場合に使用
• "failed"：SCO を credit で受講する場合に使用
• "completed"：SCO を no-credit で受講する場合に使用
• "incomplete"：SCO が passed/failed/completed を判定する前に終了した場合（credit/no-credit 共通）
• "browsed"：lesson_mode が browse の場合に使用
• "not attempted"：SCO が設定すべきではない（学習者が SCO を初回試行する際に LMS が初期化する）

SCO Usage Example

var lessonStatus = LMSGetValue("cmi.core.lesson_status");
if (lessonStatus == "failed")
{
    // 学習者が不合格。それに応じた処理
}
else
{
    // それ以外。それに応じた処理
}

Definition

学習者が当該 SCO に過去にいたかどうかを示す。

Usage

学習者が初回入場の場合、LMS は "ab-initio" に設定すべき。中断状態から再入する場合は "resume" に設定すべき。

Format

• "ab-initio"：SCO への初回入場。pre-test で全 objective に合格した場合など、"not attempted" でない状態で SCO を初めて見ることもありうるため、"not attempted" は信頼できる初回判定の指標にならない。
• "resume"：学習者が以前 SCO 内にいた。中断状態から再開している。
• ""：初回（ab-initio）でも中断からの再開（resume）でもない入場。たとえば SCO が完了済みで、後にレビュー目的で読み込まれた場合などに使う。

LMS Behavior

• Initialization: 初回起動時、LMS は "ab-initio" に初期化する。次回起動時の値は、SCO が前回設定した cmi.core.exit によって決まる。exit="suspend" なら entry="resume"、それ以外なら entry=""。
• LMSGetValue(): データモデル値を返す。Error Code 401。
• LMSSetValue(): 読み取り専用。403、401。

SCO Usage Example

var entryStatus = LMSGetValue("cmi.core.entry")
if (LMSGetLastError() == "0")
{
    if (entryStatus == "resume")
    {
        // SCO 再開中
    }
    else
    {
        // SCO への初回入場
    }
}

Definition

_children キーワードは、LMS がサポートする score カテゴリ内のすべての要素を取得するために使用する。

Usage

LMS がどの cmi.core.score 子要素をサポートしているかを判定する。raw のみ必須でサポートされなければならない。

Format

戻り値はカンマ区切りリスト。例："raw"（最低限）、"raw,min,max"、"raw,min"。

LMS Behavior

• LMSGetValue(): サポート要素のカンマ区切りリストを返す。Error Code 401。
• LMSSetValue(): キーワードのため設定不可。402、401。

SCO Usage Example

var scoreChildren = LMSGetValue("cmi.core.score._children");
if (scoreChildren.indexOf("min") != -1)
{
    LMSSetValue("cmi.core.score.min", "10");
}

Definition

SCO の前回試行における学習者のパフォーマンス指標。SCO 設計者が任意に算出方式を決められる（達成 objective の割合、選択式テストの素点、埋め込み問題への正解数など）。cmi.core.score.raw は 0〜100 の範囲で正規化された値でなければならない。

Usage

学習者が SCO に初回試行している間は空文字列 ("") に設定すべき。追加試行では、前回試行で記録された値を反映する。SCO 内でセットされていない状態で取得が要求された場合、空文字列を返す。

Format

小数値または空文字列。

LMS Behavior

• Initialization: SCO 起動時に空文字列で初期化。値の設定責務は SCO にある。
• LMSGetValue(): CMIDecimal または CMIBlank を返す。例：LMSGetValue("cmi.core.score.raw")。Error Code 401。
• LMSSetValue(): 値はデータ型に一致しなければならない。例：LMSSetValue("cmi.core.score.raw", "85.7")。Error Code 405、401。

SCO Usage Example

LMSSetValue("cmi.core.score.raw", "85");

Definition

学習者が達成し得た最大スコアまたは合計値。0〜100 の範囲で正規化された値でなければならない。

Usage

学習者が達成し得た最大スコアを示す。

Format

小数値または空文字列。

LMS Behavior

• Initialization: 空文字列で初期化。SCO が値を設定する責務を持つ。
• LMSGetValue(): CMIDecimal または CMIBlank を返す。Error Code 401。
• LMSSetValue(): 値はデータ型に一致しなければならない。Error Code 405、401。

Definition

学習者が達成し得た最小スコア。0〜100 の範囲で正規化された値でなければならない。

Usage

学習者が達成し得た最低スコアを示す。

Format

小数値または空文字列。

LMS Behavior

• Initialization: 空文字列で初期化。SCO が値を設定する責務を持つ。
• LMSGetValue(): CMIDecimal または CMIBlank を返す。Error Code 401。
• LMSSetValue(): 値はデータ型に一致しなければならない。Error Code 405、401。

Definition

当該 SCO における学習者の全セッション時間の累積。

Usage

SCO の全セッション時間を学習者単位で追跡する。LMS は SCO 起動時にデフォルト値で初期化し、SCO が報告する session_time を加算して累計を維持する。

Format

時:分:秒 をコロン区切り。HHHH:MM:SS.SS。時は最小 2 桁・最大 4 桁、分はちょうど 2 桁、秒は 2 桁＋オプションで小数点と 1〜2 桁。

LMS Behavior

• Initialization: SCO 起動時に "0000:00:00.00" で初期化。LMSFinish() または学習者の画面遷移時に、SCO が最後に設定した session_time（設定があれば）を total_time に加算する。session_time への複数回の LMSSetValue() は加算せず、最新値で上書きする。
• LMSGetValue(): CMITimespan を返す。例："00:29:00"、"01:27:45.5"。Error Code 401。
• LMSSetValue(): 読み取り専用。403、401。

Definition

SCO 起動後に望まれる SCO 動作を識別する。多くの SCO は単一の動作だが、講師や設計者の判断によって、提示する情報量・順序・トレーニング哲学を変えられる SCO も存在する。本標準は、SCO の動作に影響しうる 3 つのパラメータの伝達をサポートする。

Usage

SCO がどのモードで起動されたかを表す。lesson_status と組み合わせて使用する。

Format

• "browse"：学習者は教材をプレビューしたいが、必ずしも評価対象として SCO に挑戦したいわけではない。
• "normal"：学習者が学習に対する credit を得るために設計どおりに動作すべきことを示す。
• "review"：学習者は教材を一度以上経験し、評価済みである。

認識できない／想定外の lesson_mode を受信した場合、SCO は normal を仮定する。

LMS Behavior

• Initialization: SCO の起動モードを LMS が決定する（SCORM では指定方法を未定義のため LMS 固有実装）。
• LMSGetValue(): 定義済み語彙のいずれかを返す。Error Code 401。
• LMSSetValue(): 読み取り専用。403、401。

SCO Usage Example

var mode = LMSGetValue("cmi.core.lesson_mode");
if (LMSGetLastError() == "0")
{
    if (mode == "browse")         { /* ブラウズ中 */ }
    else if (mode == "review")   { /* レビュー中（既に評価済み） */ }
    else                          { /* normal モードで起動 */ }
}

Definition

学習者が SCO を離脱した方法または理由を示す。

Usage

SCO が最後に終了した理由を示すために使用する。

Format

• "time-out"：時間が超過した、または max_time_allowed を超えたために SCO が終了した（max_time_allowed は manifest の adlcp:maxtimeallowed）。
• "suspend"：学習者は離脱位置から後で戻る意図で SCO を離脱した。
• "logout"：LMS に戻ってログアウトするのではなく、SCO 内からログアウトした。SCO は LMS に制御を渡し、LMS は適切なデータモデル要素を更新した上で、コースから自動ログアウトする。
• ""：通常の終了状態を表す。

LMS Behavior

• Initialization: 初期化不要。LMSGetValue() は呼ばれない。SCO が制御する。SCO が設定した値に基づき、次回起動時の cmi.core.entry が決まる：
  • exit="time-out" または "logout" または未設定 → 次回 entry=""
  • exit="suspend" → 次回 entry="resume"
  • exit="" → 次回 entry=""
  • 加えて exit="logout" の場合、LMS は LMSFinish() 時または画面遷移時にコースから学習者をログアウトする。
• LMSGetValue(): 書き込み専用のため、SCO が呼ぶと 404 を返し空文字列を返す。Error Code 401、404。
• LMSSetValue(): 値はデータ型に一致しなければならない。Error Code 405、401。

SCO Usage Example

LMSSetValue("cmi.core.exit", "time-out")

Definition

学習者が SCO を離脱した時点までに、当該 SCO 内で過ごした時間（時:分:秒）。すなわち、本セッションの開始から SCO の単一利用の終了までの時間を表す。

Usage

1 セッション中の SCO 滞在時間を追跡する。LMS は本値を使って cmi.core.total_time を算定する。

Format

HHHH:MM:SS.SS。時は最小 2 桁・最大 4 桁、分はちょうど 2 桁、秒は 2 桁＋オプションで小数点と 1〜2 桁。

LMS Behavior

• Initialization: 初期化不要。SCO が制御。SCO は単一実行中に複数回 session_time を設定可能。LMSFinish() または画面遷移時、LMS は SCO が最後に設定した session_time（あれば）を total_time に加算する。複数回の LMSSetValue() は加算せず最新値で上書きする。
• LMSGetValue(): 書き込み専用。404、401。
• LMSSetValue(): 値はデータ型に一致しなければならない。例：LMSSetValue("cmi.core.session_time", "0010:34:34.56")。Error Code 405、401。

SCO Usage Example

LMSSetValue("cmi.core.session_time", "0000:12:30")

Definition

SCO の過去の利用時に生成された一意な情報で、現在の利用にも必要となるもの。起動中の SCO に固有の情報であり、通常は SCO の再起動情報として使用される。SCO が作成し、LMS が保存して、次回 SCO 実行時に SCO に返す。LMS は SCO ごと・学習者ごとに、本グループ用の領域を確保しなければならない。学習者がコース内にいる間、本データは保持される。

Usage

SCO の再開時にのみ利用可能。SCO 完了前に学習者が離脱した場合に値を設定し、再開時にこの情報を利用できる。

Format

SCO 固有。制約は次の 2 点のみ：

1. データは ASCII 形式で送受信されなければならない。SCO は必要な形式に変換できる。
2. LMS の負担を避けるため、本要素は 4096 バイトに制限すべきである。

LMS Behavior

• Initialization: 空文字列で初期化。SCO が値を設定する責務を持つ。
• LMSGetValue(): データモデル値を返す。Error Code 401。
• LMSSetValue(): データ型に一致した値で設定。Error Code 405、401。

SCO Usage Example

// SCO 再起動時に suspend_data を取得
var suspendData = LMSGetValue("cmi.suspend_data")
if (LMSGetLastError() == "0")
{
    // suspend_data を利用
}

Definition

SCO の作成時に生成され、起動のたびに必要となる一意な情報。これがないと SCO は実行できないことがある。

Usage

cmi.launch_data は SCO の起動を補助するために SCO に提供される。所与の SCO に対して常に同じ値となる。

Format

テキストフィールド。SCO が良好に機能するためにシステム固有の必要情報を含む。本フィールドは 4096 文字に制限される。

LMS Behavior

• Initialization: manifest（adlcp:datafromlms 要素）から値を取得して初期化。manifest に launch data がない場合は空文字列にする。
• LMSGetValue(): データモデル値を返す。Error Code 401。
• LMSSetValue(): 読み取り専用。403、401。

SCO Usage Example

var launchData = LMSGetValue("cmi.launch_data")
if (LMSGetLastError() == "0")
{
    // launch_data を利用
}

Definition

SCO からの自由形式フィードバック。たとえば、学習者が SCO 内の任意の地点でコメントを残したり、SCO 終了時にコメントを求められたりする。コメントには SCO 内で作成された場所や時刻を埋め込むこともできる。

Usage

SCO が SCO に関するコメントを LMS に送信する用途。学習者が入力したコメントの収集に使える。

Format

自由形式の英数字テキストおよび特殊文字。

LMS Behavior

• Initialization: 空文字列で初期化。値の設定責務は SCO にある。
• LMSGetValue(): データモデル値を返す。コメント未提供なら空文字列。Error Code 401。
• LMSSetValue(): 値を設定する。コメントは連結されるべきである。Error Code 401、405。

SCO Usage Example

var comments = LMSGetValue("cmi.comments")
if (LMSGetLastError() == "0") { /* コメントを利用 */ }

Definition

LMS 由来のコメントを表す。たとえば講師コメントなど、学習者向けのコメントとして SCO が必要に応じて表示できる。

Usage

SCO に関連する LMS 起源のコメントを SCO が参照する用途。

Format

特定の形式は指定なし。

LMS Behavior

• Initialization: 提供されていれば LMS が初期化。
• LMSGetValue(): データモデル値を返す。コメントなしなら空文字列。Error Code 401。
• LMSSetValue(): 読み取り専用。403、401。

SCO Usage Example

var commentsFromLMS = LMSGetValue("cmi.comments_from_lms");
if (LMSGetLastError() == "0") { /* LMS からのコメントを利用 */ }

Definition

LMS がサポートする cmi.objectives カテゴリ内の全要素を取得するキーワード。

Usage

LMS がサポートする要素を判定する。シミュレーションなどの複雑なシナリオで、学習者のパフォーマンスについてどの詳細情報を収集できるかを示す。

Format

カンマ区切りリスト。例："id,score"、"id,status"。

LMS Behavior

• LMSGetValue(): サポート要素のカンマ区切りリストを返す。Error Code 401。
• LMSSetValue(): キーワードのため設定不可。402、401。

Definition

cmi.objectives リスト内の現在のレコード数を取得するキーワード。

Usage

LMS が保存している objective 数を判定する。SCO はこの値から、どの objective レコードを取得・設定するかを決定できる（"3" が返れば 0〜2 のレコードが存在）。

Format

整数値。

LMS Behavior

• Initialization: SCO 起動時に 0 で初期化。
• LMSGetValue(): objective レコード総数を返す。例："0"、"4"。Error Code 401。
• LMSSetValue(): キーワードのため設定不可。402、401。

SCO Usage Example

var totalObj = LMSGetValue("cmi.objectives._count")
// 0 ベースなので -1 して新規 objective の id を設定
var request = "cmi.objectives." + (totalObj - 1) + ".id"
LMSSetValue(request, "Obj1_110")

Definition

objective を識別するための、開発者が定義する SCO 固有の内部識別子。

Usage

objective を識別する手段。

Format

内部スペースのない英数字文字列。

LMS Behavior

• Initialization: 空文字列で初期化。値の設定責務は SCO にある。
• LMSGetValue(): 保存された objective id を返す。Error Code 401。
• LMSSetValue(): 値はデータ型に一致しなければならない。例：LMSSetValue("cmi.objectives.0.id", "Obj1")。Error Code 405、401。

Definition

LMS がサポートする cmi.objectives.n.score カテゴリ内の全要素を取得するキーワード。

Format

カンマ区切りリスト。例："raw,min,max"、"raw"、""。

LMS Behavior

• LMSGetValue(): サポート要素のカンマ区切りリストを返す。Error Code 401。
• LMSSetValue(): キーワードのため設定不可。402、401。

Definition

各試行後の objective に対する学習者パフォーマンスの数値表現。0〜100 で正規化された値。

Format

小数値または空文字列。

LMS Behavior

• Initialization: 空文字列で初期化。
• LMSGetValue(): objective の raw スコアを返す。Error Code 401。
• LMSSetValue(): 例：LMSSetValue("cmi.objectives.0.score.raw", "5")。Error Code 405、401。

Definition

各 objective で達成し得た最大スコア。0〜100 で正規化された値。

LMS Behavior

• Initialization: 空文字列で初期化。
• LMSGetValue(): Error Code 401。
• LMSSetValue(): Error Code 405、401。

Definition

各 objective で達成し得た最小スコア。0〜100 で正規化された値。

LMS Behavior

• Initialization: 空文字列で初期化。
• LMSGetValue(): Error Code 401。
• LMSSetValue(): Error Code 405、401。

Definition

各試行後の objective に対するステータス。cmi.core.lesson_status と同じ 6 種類の語彙："passed"、"completed"、"failed"、"incomplete"、"browsed"、"not attempted"。

LMS Behavior

• Initialization: SCO が制御。
• LMSGetValue(): Error Code 401。
• LMSSetValue(): 例：LMSSetValue("cmi.objectives.0.status", "failed")。Error Code 405、401。

Definition

LMS がサポートする student_data カテゴリ内の全要素を取得するキーワード。

Format

カンマ区切りリスト。例："mastery_score,time_limit_action,max_time_allowed"。

LMS Behavior

• LMSGetValue(): サポート要素のカンマ区切りリストを返す。Error Code 401。
• LMSSetValue(): キーワードのため設定不可。402、401。

Definition

合格スコア。SCO 外で決定される。SCO のスコアが mastery score 以上のとき、学習者はコンテンツに合格／習熟したとみなされる。SCO によっては、合格スコアが LMS により決定されるため、SCO 自身ではこれを把握しない場合がある。

Usage

LMS が mastery_score をサポートするには、SCO から渡されたスコアに基づいて lesson_status を変更できる必要がある。SCO に mastery_score を渡すだけでは、本機能の完全サポートにはならない。

Format

小数値。

LMS Behavior

• Initialization: manifest の adlcp:masteryscore から値を取得。
• LMSGetValue(): 現在値を返す。例："75"、"100"、"5"。Error Code 401。
• LMSSetValue(): 読み取り専用。403、401。

Definition

当該 SCO の現在の試行において、学習者が利用可能な最大時間。制限超過時の SCO の挙動は time_limit_action を参照。

Format

HHHH:MM:SS.SS。例："00:14:30"、"02:03:00"。

LMS Behavior

• Initialization: manifest の adlcp:maxtimeallowed から値を取得。
• LMSGetValue(): Error Code 401。
• LMSSetValue(): 読み取り専用。403、401。

Definition

max_time_allowed 超過時に SCO が取るべき動作を指示する。SCO が「終了するか継続するか」「学習者にメッセージを表示するか」の 2 軸で指定する。

Format

定義済み語彙のいずれか：

• "exit,message"
• "exit,no message"
• "continue,message"
• "continue,no message"

LMS Behavior

• Initialization: manifest の adlcp:timelimitaction から値を取得。
• LMSGetValue(): Error Code 401。
• LMSSetValue(): 読み取り専用。403、401。

Definition

LMS がサポートする student_preference カテゴリ内の全要素を取得するキーワード。

Format

カンマ区切りリスト。例："audio,language,speed"。

LMS Behavior

• LMSGetValue(): サポート要素のカンマ区切りリストを返す。Error Code 401。
• LMSSetValue(): キーワードのため設定不可。402、401。

Definition

音声のオン／オフおよび音量レベルを示す。

Format

−1 から 100 までの整数：

• −1：オフ（負数すべてオフを意味する）
• 0：変更なし（SCO のデフォルト、または前 SCO のステータス継続）
• 1〜100：音量（1 が最弱、100 が最大）

LMS Behavior

• Initialization: サポート時は 0 で初期化。
• LMSGetValue(): Error Code 401。
• LMSSetValue(): Error Code 405、401。

Definition

多言語対応 SCO の場合、配信言語を識別する。

Format

空白を含み得る英字文字列。例："English"、"French"。

LMS Behavior

• Initialization: 空文字列で初期化。
• LMSGetValue(): Error Code 401。
• LMSSetValue(): Error Code 405、401。

Definition

SCO のコンテンツ配信速度を制御する。

Format

−100 から 100 までの整数：

• −100：システム上の最も遅い速度
• 0：変更なし（SCO のデフォルト、通常速度）
• 100：システム上の最大速度

LMS Behavior

• Initialization: 0 で初期化。
• LMSGetValue(): Error Code 401。
• LMSSetValue(): Error Code 405、401。

Definition

音声向けに設計された SCO で、音声テキストを画面に表示するかを示す（音声のみ／テキスト併記／テキスト消し）。

Format

3 値整数：

• −1：テキスト非表示
• 0：変更なし（デフォルト）
• 1：テキスト表示

LMS Behavior

• Initialization: 0 で初期化。
• LMSGetValue(): Error Code 401。
• LMSSetValue(): Error Code 405、401。

Definition

LMS がサポートする cmi.interactions カテゴリ内の全要素を取得するキーワード。

Format

カンマ区切りリスト。例："id,time,type,correct_responses,student_response"。

LMS Behavior

• LMSGetValue(): サポート要素のカンマ区切りリストを返す。Error Code 401。
• LMSSetValue(): キーワードのため設定不可。402、401。

Definition

cmi.interactions リスト内の現在のレコード数を取得するキーワード。

Usage

SCO はこの値から、次に設定するインタラクションレコードのインデックスを判定できる。"3" が返れば 0〜2 が使用済み、次の利用可能インデックスは 3。

LMS Behavior

• Initialization: SCO 起動時に 0 で初期化。
• LMSGetValue(): 整数を返す。Error Code 401。
• LMSSetValue(): キーワードのため設定不可。402、401。

Definition

インタラクションの一意識別子。

Format

内部スペースのない英数字文字列。

LMS Behavior

• Initialization: SCO が制御。
• LMSGetValue(): 書き込み専用。404、401。
• LMSSetValue(): 例：LMSSetValue("cmi.interactions.0.id", "I_001")。Error Code 205、401。

Definition

あるインタラクションに紐づく objective id リストの現在のレコード数を取得するキーワード。

LMS Behavior

• Initialization: SCO 起動時に 0 で初期化。
• LMSGetValue(): 整数を返す。Error Code 401。
• LMSSetValue(): キーワードのため設定不可。402、401。

Definition

インタラクションが紐づく objective を識別するための、開発者が定義した識別子。

Format

内部スペースのない英数字文字列。

LMS Behavior

• Initialization: SCO が制御。
• LMSGetValue(): 書き込み専用。404、401。
• LMSSetValue(): 例：LMSSetValue("cmi.interactions.0.objectives.0.id", "A1333")。Error Code 205、401。

Definition

学習者インタラクションが完了した時刻の識別。

Format

24 時間制の時刻：HH:MM:SS.S。時・分はちょうど 2 桁、秒は 2 桁＋オプションで小数点と 1〜2 桁。

LMS Behavior

• LMSGetValue(): 書き込み専用。404、401。
• LMSSetValue(): 例：LMSSetValue("cmi.interactions.0.time", "12:33:35.5")。Error Code 205、401。

Definition

記録されるインタラクションのカテゴリ。インタラクションのタイプによって、応答の解釈方法が決まる。

Format

定義済み語彙のいずれか：

• "true-false"：応答が 2 種類のみの設問
• "choice"：限られた事前定義の応答から学習者が選ぶ設問。各応答に番号や文字を割り当てる。1 つ以上が正解になり得る
• "fill-in"：単純な数語の回答が必要な設問。応答は事前定義されず、学習者が作成する
• "matching"：1 つまたは 2 つの集合の項目を組み合わせる設問
• "performance"：選択式と似ているが、書かれた応答を選ぶ代わりにタスクや動作を実行する
• "sequencing"：リストのメンバーを論理的順序に並べる設問
• "likert"：連続体上の選択肢を提示する設問。意見・態度に基づく
• "numeric"：1 つの数値で答える設問。正解は数値範囲内の単一値となる場合もある

LMS Behavior

• LMSGetValue(): 書き込み専用。404、401。
• LMSSetValue(): 例：LMSSetValue("cmi.interactions.0.type", "choice")。Error Code 205、401。

Definition

あるインタラクションの正答リストの現在のレコード数を取得するキーワード。

LMS Behavior

• Initialization: SCO 起動時に 0 で初期化。
• LMSGetValue(): 整数を返す。Error Code 401。
• LMSSetValue(): キーワードのため設定不可。402、401。

Definition

インタラクションに対するあり得る応答のうち、正答とみなされるものを記述する。複数の正答があり得るし、より正解に近い応答もあり得る。

Format

cmi.interactions.n.type によりフォーマットが異なる：

• true-false：単一文字／数字。0,1,t,f が有効。0 は false。完全な単語（例："true"）の場合、最初の 1 文字のみ意味を持つ。
• choice：カンマ区切りで 1 つ以上の文字。整数 (0–9) または英字 (a–z) を使用。各応答は 1 文字に制限。可能性が 26 を超える場合は performance 型を使用。
• fill-in：英数字文字列。最初の印字可能文字以降のスペースは有意。
• numeric：単一の数値。小数点はあってもなくてもよい。
• likert：likert に正答はない。空白でよい。
• matching：ピリオドで区切られた識別子のペア。各マッチング候補はソースとターゲットからなる。
• performance：255 文字以下の英数字フィールド。
• sequencing：任意の順序で識別された要素群。最終的な配置位置で正誤を判定する。

LMS Behavior

• LMSGetValue(): 書き込み専用。404、401。
• LMSSetValue(): 例（matching の場合）：LMSSetValue("cmi.interactions.0.correct_responses.0.pattern", "1.c,2.b,3.a,4.d")。Error Code 205、401。

Definition

インタラクションの相対的重要度を識別する係数。たとえば 1 つ目に重み 15、2 つ目に重み 25 を付ければ、重み付け合計スコアは 2 つ目により強く影響される。すべて同じ重要度なら同じ重みを付ける。重み 0 は重み付け最終スコアにカウントしないことを示す。

Format

単一の浮動小数点数。小数点はオプション。

LMS Behavior

• LMSGetValue(): 書き込み専用。404、401。
• LMSSetValue(): 例：LMSSetValue("cmi.interactions.0.weighting", "0.66")。Error Code 205、401。

Definition

学習者の実際の応答。correct_responses.n.pattern と比較できる。

Format

correct_responses.n.pattern と同じ形式（cmi.interactions.n.type に応じる）。

LMS Behavior

• LMSGetValue(): 書き込み専用。404、401。
• LMSSetValue(): 例：LMSSetValue("cmi.interactions.0.student_response", "f")。Error Code 205、401。

Definition

システムが応答をどう判定したか。

Format

定義済み語彙のいずれか：

• "correct"
• "wrong"
• "unanticipated"
• "neutral"
• "x.x"（CMIDecimal）

LMS Behavior

• LMSGetValue(): 書き込み専用。404、401。
• LMSSetValue(): 例：LMSSetValue("cmi.interactions.0.result", "correct")。Error Code 205、401。

Definition

刺激の提示から測定可能な応答の完了までの時間。

Format

HHHH:MM:SS.SS。時は最小 2・最大 4 桁、分は 2 桁、秒は 2 桁＋オプション小数点 1〜2 桁。

LMS Behavior

• LMSGetValue(): 書き込み専用。404、401。
• LMSSetValue(): 例：LMSSetValue("cmi.interactions.0.latency", "00:20:00")。Error Code 205、401。