(自订) 测验学习服务

  • 学生回答测验问题

    customizedAnsweredQuizQuestions(actor, verb, object, result, context, authority, timestamp);

  • 学生开始一个测验

    customizedAttemptedQuiz(actor, verb, object, result, context, authority, timestamp);

  • 学生完成一个测验

    customizedCompletedQuiz(actor, verb, object, result, context, authority, timestamp);

  • 学生选了答案的选项

    customizedChoseCorrectOption(actor, verb, object, result, context, authority, timestamp);

  • 学生阅读答题后的补充资讯或提示

    customizedReadQuizHints(actor, verb, object, result, context, authority, timestamp);

函式说明

customizedAnsweredQuizQuestions()

  • 作用:学生回答测验问题
  • 参数:表A
名称 属性 说明 必要性
actor Agent Object 主词。此语句的拥有者,物件格式请参考表1 必要
verb Object 动词。学生或学习小组之动作,物件格式请参考表2 必要
object Object 对象。可以为活动、动作者或者为另一个语句物件。预设为活动物件,物件格式请参考表3 必要
result Object 此语句之结果。可依照对应的动词取得对应结果。物件格式请参考表6 必要
context Object 描绘此语句之情境,物件格式请参考表4 必要
authority Object 语句拥有者,物件格式请参考表5 选填
timestamp ISO 8601 String 时间戳记 选填
Example
var actor = visca.setActorByMbox("Crystal","mailto:crystal@visca.com");
var verbDisplay = visca.setDisplay("zh-TW","回答");
var verb = visca.setVerb("http://adlnet.gov/expapi/verbs/answered",verbDisplay);
var objectID = "http://visca.com/question/id/3";
var defName = visca.setName("zh-TW","3");
var defDescription = visca.setDescription("zh-TW","哪一个人最帅?");
var defType = "http://adlnet.gov/expapi/activities/cmi.interaction";
var alignment = visca.setExtension("alignment",["社4-4-2-4","语1-1-1-2"]);
var bloomsLevel = visca.setExtension("blooms-level","Applying");
var defExtensions = visca.setExtensions(alignment,bloomsLevel);
var defInteractionType = "choice";
var defCorrectResponsesPattern = visca.setCorrectResponsesPattern("king");
var choiceKing = visca.setDescription("zh-TW","金城武");
var choiceMing = visca.setDescription("zh-TW","明金城");
var defChoices = visca.setChoices("king",choiceKing,"ming",choiceMing);
var objectDef = visca.setDefinition(defName,defDescription,defType,defExtensions,defInteractionType,defCorrectResponsesPattern,defChoices);
var object = visca.setObject(objectID,objectDef);
var reDuration = "PT20S";
var reScore = visca.setScore(0,10,10);
var reSuccess = true;
var reResponse = "king";
var result = visca.setResult(reDuration,null,reResponse,reScore,reSuccess);
var instructor = visca.setInstructorByMbox("Teacher","mailto:teacher@visca.com");
var platform = "http://visca.com/platform/assessing";
var language = "zh-TW";
var parentID = "http://visca.com/assessment/id/final-exam";
var pName = visca.setName("zh-TW","期末考");
var pType = "http://adlnet.gov/expapi/activities/assessment";
var parentDef = visca.setDefinition(pName,null,pType,null,null,null,null);
var parent = visca.setParent(parentID,parentDef);
var category = visca.setCategory("https://w3id.org/xapi/acrossx/profile/assessment");
var contextActivities = visca.setContextActivities(parent,null,category);
var contextExtensions = visca.setExtension("browser-info");
var context = visca.setContext(instructor,language,contextActivities,platform,contextExtensions);
var authority = visca.setAuthorityByMbox("Crystal","mailto:crystal@visca.com");
var timestamp = visca.setTimestamp();

visca.customizedAnsweredQuizQuestions(actor,verb,object,result,context,authority,timestamp);

customizedAttemptedQuiz()

  • 作用:学生开始一个测验
  • 参数:表A
Example
var actor = visca.setActorByMbox("Crystal","mailto:crystal@visca.com");
var verbDisplay = visca.setDisplay("zh-TW","开始尝试");
var verb = visca.setVerb("http://adlnet.gov/expapi/verbs/attempted",verbDisplay);
var objectID = "http://visca.com/assessment/id/final-exam";
var defName = visca.setName("zh-TW","期末考");
var defDescription = visca.setDescription("zh-TW","期末考的描述");
var defType = "http://adlnet.gov/expapi/activities/assessment";
var alignment = visca.setExtension("alignment",["社4-4-2-4","语1-1-1-2"]);
var timeLimit = visca.setExtension("time-limit","PT2H30M");
var totalItems = visca.setExtension("total-items",10);
var totalScore = visca.setExtension("total-score",100);
var passScore = visca.setExtension("pass-score",60);
var defExtensions = visca.setExtensions(alignment,timeLimit,totalItems,totalScore,passScore);
var objectDef = visca.setDefinition(defName,defDescription,defType,defExtensions,null,null,null);
var object = visca.setObject(objectID,objectDef);
var reExtensions = visca.setExtension("starting-point", "2015-09-21T05:45:30Z");
var result = visca.setResult(null,reExtensions,null,null,null);
var instructor = visca.setInstructorByMbox("Teacher","mailto:teacher@visca.com");
var platform = "http://visca.com/platform/assessing";
var language = "zh-TW";
var category = visca.setCategory("https://w3id.org/xapi/acrossx/profile/assessment");
var contextActivities = visca.setContextActivities(null,null,category);
var contextExtensions = visca.setExtension("browser-info");
var context = visca.setContext(instructor,language,contextActivities,platform,contextExtensions);
var authority = visca.setAuthorityByMbox("Crystal","mailto:crystal@visca.com");
var timestamp = visca.setTimestamp();

visca.customizedAttemptedQuiz(actor,verb,object,result,context,authority,timestamp);

customizedCompletedQuiz()

  • 作用:学生完成一个测验
  • 参数:表A
Example
var actor = visca.setActorByMbox("Crystal","mailto:crystal@visca.com");
var verbDisplay = visca.setDisplay("zh-TW","完成");
var verb = visca.setVerb("http://adlnet.gov/expapi/verbs/completed",verbDisplay);
var objectID = "http://visca.com/assessment/id/final-exam";
var defName = visca.setName("zh-TW","期末考");
var defDescription = visca.setDescription("zh-TW","期末考的描述");
var defType = "http://adlnet.gov/expapi/activities/assessment";
var alignment = visca.setExtension("alignment",["社4-4-2-4","语1-1-1-2"]);
var timeLimit = visca.setExtension("time-limit","PT2H30M");
var totalItems = visca.setExtension("total-items",10);
var totalScore = visca.setExtension("total-score",100);
var passScore = visca.setExtension("pass-score",60);
var defExtensions = visca.setExtensions(alignment,timeLimit,totalItems,totalScore,passScore);
var objectDef = visca.setDefinition(defName,defDescription,defType,defExtensions,null,null,null);
var object = visca.setObject(objectID,objectDef);
var reDuration = "PT1H";
var reScore = visca.setScore(20,90,90);
var reSuccess = true;
var reExtensions = visca.setExtension("ending-point","2015-09-21T06:45:30Z");
var result = visca.setResult(reDuration,reExtensions,null,reScore,reSuccess);
var instructor = visca.setInstructorByMbox("Teacher","mailto:teacher@visca.com");
var platform = "http://visca.com/platform/assessing";
var language = "zh-TW";
var category = visca.setCategory("https://w3id.org/xapi/acrossx/profile/assessment");
var contextActivities = visca.setContextActivities(null,null,category);
var contextExtensions = visca.setExtension("browser-info");
var context = visca.setContext(instructor,language,contextActivities,platform,contextExtensions);
var authority = visca.setAuthorityByMbox("Crystal","mailto:crystal@visca.com");
var timestamp = visca.setTimestamp();

visca.customizedCompletedQuiz(actor,verb,object,result,context,authority,timestamp);

customizedChoseCorrectOption()

  • 作用:学生选了答案的选项
  • 参数:表A
Example
var actor = visca.setActorByMbox("Crystal","mailto:crystal@visca.com");
var verbDisplay = visca.setDisplay("zh-TW","互动");
var verb = visca.setVerb("http://adlnet.gov/expapi/verbs/interacted",verbDisplay);
var objectID = "http://visca.com/question/id/3";
var defName = visca.setName("zh-TW","3");
var defDescription = visca.setDescription("zh-TW","哪一个人最帅?");
var defType = "http://adlnet.gov/expapi/activities/cmi.interaction";
var alignment = visca.setExtension("alignment",["社4-4-2-4","语1-1-1-2"]);
var bloomsLevel = visca.setExtension("blooms-level","Applying");
var defExtensions = visca.setExtensions(alignment,bloomsLevel);
var defInteractionType = "choice";
var defCorrectResponsesPattern = visca.setCorrectResponsesPattern("king");
var choiceKing = visca.setDescription("zh-TW","金城武");
var choiceMing = visca.setDescription("zh-TW","明金城");
var defChoices = visca.setChoices("king",choiceKing,"ming",choiceMing);
var objectDef = visca.setDefinition(defName,defDescription,defType,defExtensions,defInteractionType,defCorrectResponsesPattern,defChoices);
var object = visca.setObject(objectID,objectDef);
var reResponse = "king";
var result = visca.setResult(null,null,reResponse,null,null);
var instructor = visca.setInstructorByMbox("Teacher","mailto:teacher@visca.com");
var platform = "http://visca.com/platform/assessing";
var language = "zh-TW";
var parentID = "http://visca.com/assessment/id/final-exam";
var pName = visca.setName("zh-TW","期末考");
var pType = "http://adlnet.gov/expapi/activities/assessment";
var parentDef = visca.setDefinition(pName,null,pType,null,null,null,null);
var parent = visca.setParent(parentID,parentDef);
var category = visca.setCategory("https://w3id.org/xapi/acrossx/profile/assessment");
var contextActivities = visca.setContextActivities(parent,null,category);
var contextExtensions = visca.setExtension("browser-info");
var context = visca.setContext(instructor,language,contextActivities,platform,contextExtensions);
var authority = visca.setAuthorityByMbox("Crystal","mailto:crystal@visca.com");
var timestamp = visca.setTimestamp();

visca.customizedChoseCorrectOption(actor,verb,object,result,context,authority,timestamp);

customizedReadQuizHints()

  • 作用:学生阅读答题后的补充资讯或提示
  • 参数:表A
Example
var actor = visca.setActorByMbox("Crystal","mailto:crystal@visca.com");
var verbDisplay = visca.setDisplay("zh-TW","阅读");
var verb = visca.setVerb("https://w3id.org/xapi/adb/verbs/read",verbDisplay);
var objectID = "http://visca.com/question/id/3";
var defName = visca.setName("zh-TW","3");
var defDescription = visca.setDescription("zh-TW","哪一个人最帅?");
var defType = "http://adlnet.gov/expapi/activities/cmi.interaction";
var alignment = visca.setExtension("alignment",["社4-4-2-4","语1-1-1-2"]);
var bloomsLevel = visca.setExtension("blooms-level","Applying");
var supplementalInfo = visca.setExtension("supplemental-info","your hint!");
var defExtensions = visca.setExtensions(alignment,bloomsLevel,supplementalInfo);
var defInteractionType = "choice";
var defCorrectResponsesPattern = visca.setCorrectResponsesPattern("king");
var choiceKing = visca.setDescription("zh-TW","金城武");
var choiceMing = visca.setDescription("zh-TW","明金城");
var defChoices = visca.setChoices("king",choiceKing,"ming",choiceMing);
var objectDef = visca.setDefinition(defName,defDescription,defType,defExtensions,defInteractionType,defCorrectResponsesPattern,defChoices);
var object = visca.setObject(objectID,objectDef);
var reDuration = "PT1M10S";
var result = visca.setResult(reDuration,null,null,null,null);
var instructor = visca.setInstructorByMbox("Teacher","mailto:teacher@visca.com");
var platform = "http://visca.com/platform/assessing";
var language = "zh-TW";
var parentID = "http://visca.com/assessment/id/final-exam";
var pName = visca.setName("zh-TW","期末考");
var pType = "http://adlnet.gov/expapi/activities/assessment";
var parentDef = visca.setDefinition(pName,null,pType,null,null,null,null);
var parent = visca.setParent(parentID,parentDef);
var category = visca.setCategory("https://w3id.org/xapi/acrossx/profile/assessment");
var contextActivities = visca.setContextActivities(parent,null,category);
var contextExtensions = visca.setExtension("browser-info");
var context = visca.setContext(instructor,language,contextActivities,platform,contextExtensions);
var authority = visca.setAuthorityByMbox("Crystal","mailto:crystal@visca.com");
var timestamp = visca.setTimestamp();

visca.customizedReadQuizHints(actor,verb,object,result,context,authority,timestamp);

表1

  • 物件名称:actor
  • 组成元素:
名称 属性 说明 必要性 objectType String "Agent" 必要 name String 脚色之全名 必要 mbox mailto IRI 脚色的电子邮件,格式为 "mailto: 电子邮件" 必要

表2

  • 物件名称:verb
  • 组成元素:
名称 属性 说明 必要性
id URL 使用的动作 必要
display Object 使用动作的多语言之表示,物件格式请参考表2-1 建议

表2-1

  • 物件名称:display
  • 组成元素:
名称 属性 说明 必要性
zh-TW String 繁体中文的动作名称 建议

表3

  • 物件名称:object
  • 组成元素:
名称 属性 说明 必要性
objectType String "Activity" 必要
id URL 影片的连结 必要
definition Object 元数据 (Metadata),物件格式请参考表3-1 必要

表3-1

  • 物件名称:definition
  • 组成元素:
名称 属性 说明 必要性
name Object 该活动之名称,物件格式请参考表3-1-1 建议
description Object 此活动之描述,物件格式请参考表3-1-2 除了开始测验是选填外,其他皆建议
type URL 活动类型 必要
extensions Object 根据需要使用其他属物件,物件格式请参考表3-1-3 必要:完成测验、阅读提示
建议:回答测验问题、开始测验、选了答案的选项

表3-1-1

  • 物件名称:name
  • 组成元素:
名称 属性 说明 必要性
zh-TW String 该活动之繁体中文名称 建议

表3-1-2

  • 物件名称:description
  • 组成元素:
名称 属性 说明 必要性
zh-TW String 此活动之繁体中文描述 除了开始测验是选填外,其他皆建议

表3-1-3

  • 物件名称:extensions
  • 组成元素:

(object.definition.extensions)

名称 属性 说明 必要性
https://w3id.org/xapi/acrossx/extensions/alignment Array of String 对齐的课纲、能力、知识节点或其他指标 建议
https://w3id.org/xapi/acrossx/extensions/blooms-level String Blooms Level:
  • Remembering
  • Understanding
  • Applying
  • Analyzing
  • Evaluating
  • Creating
建议:回答测验问题、选了答案的选项、阅读提示
http://w3id.org/xapi/acrossX/extensions/supplemental-info String/Activity Object/URL Hint or feedback revealed 必要:阅读提示
https://w3id.org/xapi/acrossx/extensions/time-limit ISO 8601 String 测验的时间限制 选填:开始测验、结束测验
https://w3id.org/xapi/acrossx/extensions/total-items Integer 题目数量 建议:开始测验
必要:完成测验
https://w3id.org/xapi/acrossx/extensions/total-score Integer 测验总分 |建议:开始测验、完成测验
https://w3id.org/xapi/acrossx/extensions/pass-score Integer 通过分数 建议:开始测验、完成测验

(result.extensions)

名称 属性 说明 必要性
http://id.tincanapi.com/extension/starting-point ISO 8601 String 测验开始时间 必要:开始测验
http://id.tincanapi.com/extension/ending-point ISO 8601 String 测验结束时间 必要:完成测验

(context.extensions)

名称 属性 说明 必要性
http://id.tincanapi.com/extension/browser-info Navigator Object 使用的浏览器资讯 建议

表4

  • 物件名称:context
  • 组成元素:
名称 属性 说明 必要性
instructor Object 如果教学者不是动作者时,请填写教学者,物件格式请参考表4-1 除了选了答案的选项是选填外,其他皆必要
language String 此情境中使用之语言 选填
contextActivities Object 学习活动情境之各类型资讯。有效的类型:parent、grouping、category、other,物件格式请参考表4-2 必要
platform String 此笔活动纪录之使用平台 建议
extensions Object 其他的特殊情境元素,物件格式请参考表3-1-3 建议

表4-1

  • 物件名称:instructor
  • 组成元素:
名称 属性 说明 必要性
objectType String "Agent" 除了选了答案的选项是选填外,其他皆必要
name String 脚色之全名 除了选了答案的选项是选填外,其他皆必要
mbox mailto IRI 脚色的电子邮件,格式为 "mailto: 电子邮件" 除了选了答案的选项是选填外,其他皆必要

表4-2

  • 物件名称:contextActivities
  • 组成元素:
名称 属性 说明 必要性
parent[0] Activity Object 题目所属的测验母活动,物件格式请参考表4-2-1 必要:回答测验问题、选了答案的选项、阅读提示
category[0 Activity Object 测验的 Profile Activity,物件格式请参考表4-2-2 必要

表4-2-1

  • 物件名称:parent[0]
  • 组成元素:
名称 属性 说明 必要性
objectType String "Activity" 必要:回答测验问题、选了答案的选项、阅读提示
id URL 一个唯一的 Activity ID 必要:回答测验问题、选了答案的选项、阅读提示
definition Object 元数据,物件格式请参考表3-1(只有name,type必要) 必要:回答测验问题、选了答案的选项、阅读提示

表4-2-2

  • 物件名称:category[0]
  • 组成元素:
名称 属性 说明 必要性
objectType String "Activity" 必要
id URL 一个唯一的 Activity ID 必要

表5

  • 物件名称:authority
  • 组成元素:
名称 属性 说明 必要性
objectType String "Agent" 选填
name String 语句拥有者之全名 选填
mbox mailto IRI 语句拥有者的电子邮件,格式为 "mailto: 电子邮件" 选填

表6

  • 物件名称:result
  • 组成元素:
名称 属性 说明 必要性
duration ISO 8601 String 表示此活动之持续时间 必要:完成测验、阅读提示
建议:回答测验问题
extensions Object 对应其他欲表达之元素,物件格式请参考表3-1-3 必要:开始测验、完成测验
response String 回答内容 必要:回答测验问题、选了答案的选项
score Object 分数,物件格式请参考表6-1 必要:完成测验
建议:回答测验问题
success Boolean 答对(通过)与否 必要:回答测验问题
建议:完成测验

表6-1

  • 物件名称:score
  • 组成元素:
名称 属性 说明 必要性
min Decimal number less than max 最低分 建议
raw Decimal number between min and max 得分 建议
max Decimal number greater than min 最高分 建议

results matching ""

    No results matching ""