E-Learning/SCORM插件参考 - Soft8Soft
Description: 此插件的拼图用于实现基于SCORM的电子学习应用。

# E-Learning/SCORM插件

此官方插件基于SCORM标准1.2版，包含了一些可用于实现基于SCORM的电子学习应用的拼图。

关于创建SCORM课程的更多信息，请查看本手册中 对应的章节 。

## 内容

- 拼图参考
  - lms initialize
  - lms finish
  - lms set value
  - lms get value
  - lms commit
  - lms get last error
  - lms get error string
  - lms get diagnostic
  - data model elements
  - pack add item
  - pack get item ID

#

## 拼图参考

#

### lms initialize

启动与LMS的通信会话。

#

### lms finish

结束与LMS的通信会话。您可以在完成通信后的任何时候执行此拼图，但最好将其包含在“beforeunload”事件处理程序中。

#

### lms set value

为给定的LMS 元素 设置一个值。

#

### lms get value

从LMS 元素检索值。

#

### lms commit

向LMS报告它应该同步的 lms set value 拼图收到的数据。执行提交并不是被严格要求的，但它可以提高某些LMS中的UI的响应能力。例如，Moddle LMS在提交时会更新分数和课程状态。

#

### lms get last error

返回上次与LMS通信产生的错误代码（编码为字符串）。“0”值表示没有发生错误。

#

### lms get error string

返回描述指定错误代码的短字符串。

#

### lms get diagnostic

返回有关上次发生的错误的详细信息。

#

### data model elements

SCORM数据包中可以分配和检索的数据模型元素的列表。

在SCORM术语中，"element(元素)"只是一个可以被发送到LMS或从LMS获取的参数。它与“HTML”元素无关。

元素 | 读/写 | 描述
--- | --- | ---
cmi.core.lesson_status | 读/写 | 标示学习者是否已完成并满足SCO的要求。“passed(通过)”，“completed(完成”)，“failed(失败)”，“incomplete(不完整)”，“browsed(浏览过)”，“not attempted(未尝试)”之一。
cmi.core.student_id | 只读 | 标识已启动课程的学生。
cmi.core.student_name | 只读 | LMS为学生提供的姓名。
cmi.core.lesson_location | 读/写 | 学习者在当前课程中的位置。
cmi.core.credit | 只读 | 指示学生在此课程表现中将获得的学分。"credit(有学分)"或"no-credit(无学分)"。
cmi.core.entry | 只读 | 判断学习者是否之前已访问过课程。"ab-initio(从头开始)", "resume(恢复)" 或 ""。
cmi.core.score_children | 只读 | 支持的数据模型元素列表。
cmi.core.score.raw | 读/写 | 反应学习者表现的数字，相对于由最小值和最大值限定范围的分数。
cmi.core.score.max | 读/写 | 原始分数范围中的最大值。
cmi.core.score.min | 读/写 | 原始分数范围中的最小值。
cmi.core.total_time | 只读 | 当前学习者尝试中累积的所有学习时间的总和。
cmi.core.lesson_mode | 只读 | 标识可能向学习者呈现课程的三种可能模式之一。“browse(浏览)”，“normal(正常)”，“review(评估)”之一。
cmi.core.exit | 仅写入 | 指示学习者离开课程的方式或原因。“time-out(超时)”，“suspend(暂停)”，“logout(登出)”，“”之一。
cmi.core.session_time | 仅写入 | 学习者在本课程当前学习者会话中花费的时间。
cmi.core._children | 只读 | 支持的数据模型元素列表。

为简单起见，此拼图只包括“core(核心)”元素。如果您需要将其他（包括非标准）元素传递给lms set value / lms get value，请使用文本拼图：

#

### pack add item

将项添加到生成的 SCORM 包的清单中。

此拼图可用于创建多页课程，这些课程可以根据所选项目运行不同的内容。

要检索当前项目的ID，请使用 pack get item ID(从包获取项目ID) 拼图。

#

### pack get item ID

从 SCORM 包中检索当前加载的项目的 ID。

如果 Verge3D 应用程序的 .html 文件是使用 iframe 嵌入的，则应启用 "in parent doc(在父文档中)" 复选框。

## 在使用拼图时遇到困难？

欢迎您随时在 论坛上提问！您还可以加入中文用户社区QQ群(171678760)，在线寻求帮助。