(自訂) 影片學習服務

  • 學生被老師指定觀看影片

    customizedWasAssignedVideo(actor, verb, object, context, authority, timestamp);

  • 學生觀看影片片段

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

  • 學生跳過影片片段

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

  • 學生在影片播放的某個時間點做筆記

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

  • 學生回答嵌入在影片中的題目

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

  • 學生閱讀嵌入在影片中的題目的補充資訊或提示

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

函式說明

customizedWasAssignedVideo()

  • 作用:學生被老師指定觀看影片
  • 參數:

表A

名稱 屬性 說明 必要性
actor Agent Object 主詞。此語句的擁有者,物件格式請參考表1 必要
verb Object 動詞。學生或學習小組之動作,物件格式請參考表2 必要
object Object 對象。可以為活動、動作者或者為另一個語句物件。預設為活動物件,物件格式請參考表3 必要
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("https://w3id.org/xapi/acrossx/verbs/was-assigned",verbDisplay); 
var defName = visca.setName("zh-TW","Future Learning","en-US","Future Learning");
var defDescription = visca.setDescription("zh-TW","【親子天下】《翻轉教育:未來教育 Future Learning》");
var defType = "https://w3id.org/xapi/acrossx/activities/video";
var duration = visca.setExtension("duration","PT12M47S");
var defExtensions = visca.setExtensions(duration);
var objectDef = visca.setDefinition(defName,defDescription,defType,defExtensions,null,null,null);
var objectID = "https://www.youtube.com/watch?v=sQcwRGTW5mw";
var object = visca.setObject(objectID,objectDef);
var instructor = visca.setInstructorByMbox("Teacher","mailto:teacher@visca.com");
var category = visca.setCategory("https://w3id.org/xapi/acrossx/profile/video");
var parentID = "http://visca.com/video/2";
var pName = visca.setName("zh-TW","補充影片");
var pType = "https://w3id.org/xapi/acrossx/activities/video";
var parentDef = visca.setDefinition(pName,null,pType,null,null,null,null);                               
var parent = visca.setParent(parentID,parentDef);
var contextActivities = visca.setContextActivities(parent,null,category);
var contextExtensions = visca.setExtension("browser-info");
var context = visca.setContext(instructor,null,contextActivities,null,contextExtensions);
var authority = visca.setAuthorityByMbox("Teacher","mailto:teacher@visca.com");
var timestamp = visca.setTimestamp();

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

customizedWatchedVideoClips()

  • 作用:學生觀看影片片段
  • 參數:

表B

名稱 屬性 說明 必要性
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("https://w3id.org/xapi/acrossx/verbs/watched",verbDisplay);
var defName = visca.setName("zh-TW","Future Learning","en-US","Future Learning");
var defDescription = visca.setDescription("zh-TW","【親子天下】《翻轉教育:未來教育 Future Learning》");
var defType = "https://w3id.org/xapi/acrossx/activities/video";
var alignment = visca.setExtension("alignment",["社4-4-2-4","語1-1-2-2"]);
var duration = visca.setExtension("duration","PT12M47S");
var defExtensions = visca.setExtensions(alignment,duration);
var objectDef = visca.setDefinition(defName,defDescription,defType,defExtensions,null,null,null);
var objectID = "https://www.youtube.com/watch?v=sQcwRGTW5mw";
var object = visca.setObject(objectID,objectDef);
var reDuration = "PT3M30S";
var start = visca.setExtension("starting-point","PT50S");
var end = visca.setExtension("ending-point","PT4M20S");
var reExtensions = visca.setExtensions(start,end);
var result = visca.setResult(reDuration,reExtensions,null,null,null);
var instructor = visca.setInstructorByMbox("Teacher","mailto:teacher@visca.com");
var category = visca.setCategory("https://w3id.org/xapi/acrossx/profile/video");
var contextActivities = visca.setContextActivities(null,null,category);
var contextExtensions = visca.setExtension("browser-info");
var context = visca.setContext(instructor,null,contextActivities,null,contextExtensions);
var authority = visca.setAuthorityByMbox("Crystal","mailto:crystal@visca.com");
var timestamp = visca.setTimestamp();

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

customizedSkippedVideoClips()

  • 作用:學生跳過影片片段
  • 參數:表B
Example
var actor = visca.setActorByMbox("Crystal","mailto:crystal@visca.com");
var verbDisplay = visca.setDisplay("zh-TW","跳過");
var verb = visca.setVerb("https://w3id.org/xapi/acrossx/verbs/skipped",verbDisplay);
var defName = visca.setName("zh-TW","Future Learning","en-US","Future Learning");
var defDescription = visca.setDescription("zh-TW","【親子天下】《翻轉教育:未來教育 Future Learning》");
var defType = "https://w3id.org/xapi/acrossx/activities/video";
var alignment = visca.setExtension("alignment",["社4-4-2-4","語1-1-2-2"]);
var duration = visca.setExtension("duration","PT12M47S");
var defExtensions = visca.setExtensions(alignment,duration);
var objectID = "https://www.youtube.com/watch?v=sQcwRGTW5mw";
var objectDef = visca.setDefinition(defName,defDescription,defType,defExtensions,null,null,null);
var object = visca.setObject(objectID,objectDef);
var instructor = visca.setInstructorByMbox("Teacher","mailto:teacher@visca.com");
var start = visca.setExtension("starting-point","PT0S");
var end = visca.setExtension("ending-point","PT12M15S");
var reExtensions = visca.setExtensions(start,end);
var result = visca.setResult(reDuration,reExtensions,null,null,null);
var category = visca.setCategory("https://w3id.org/xapi/acrossx/profile/video");
var contextActivities = visca.setContextActivities(null,null,category);
var context = visca.setContext(instructor,null,contextActivities,null,null);
var authority = visca.setAuthorityByMbox("Crystal","mailto:crystal@visca.com");
var timestamp = visca.setTimestamp();

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

customizedTookVideoNotes()

  • 作用:學生在影片播放的某個時間點做筆記
  • 參數:表B
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/noted",verbDisplay);
var defName = visca.setName("zh-TW","Future Learning","en-US","Future Learning");
var defDescription = visca.setDescription("zh-TW","【親子天下】《翻轉教育:未來教育 Future Learning》");
var defType = "https://w3id.org/xapi/acrossx/activities/video";
var alignment = visca.setExtension("alignment",["社4-4-2-4","語1-1-2-2"]);
var duration = visca.setExtension("duration","PT12M47S");
var defExtensions = visca.setExtensions(alignment,duration);
var objectID = "https://www.youtube.com/watch?v=sQcwRGTW5mw";
var objectDef = visca.setDefinition(defName,defDescription,defType,defExtensions,null,null,null);
var object = visca.setObject(objectID,objectDef);
var instructor = visca.setInstructorByMbox("Teacher","mailto:teacher@visca.com");
var reDuration = "PT30S";
var time = visca.setExtension("time","PT4M50S");
var reResponse = "教育很重要";
var reExtensions = visca.setExtensions(time);
var result = visca.setResult(reDuration,reExtensions,reResponse,null,null);
var category = visca.setCategory("https://w3id.org/xapi/acrossx/profile/video");
var contextActivities = visca.setContextActivities(null,null,category);
var context = visca.setContext(instructor,null,contextActivities,null,null);
var authority = visca.setAuthorityByMbox("Crystal","mailto:crystal@visca.com");
var timestamp = visca.setTimestamp();

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

customizedAnsweredVideoQuestions()

  • 作用:學生回答嵌入在影片中的題目
  • 參數:表B
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/1";
var defName = visca.setName("zh-TW","1");
var defDescription = visca.setDescription("zh-TW","1,_,3,_,5");
var defType = "http://adlnet.gov/expapi/activities/cmi.interaction";
var defInteractionType = "fill-in";
var defCorrectResponsesPattern = visca.setCorrectResponsesPattern("2[,]4");
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,null,defInteractionType,defCorrectResponsesPattern,defChoices);
var object = visca.setObject(objectID,objectDef);
var reDuration = "PT15S";
var start = visca.setExtension("starting-point","2016-02-28T01:00:00Z");
var end = visca.setExtension("ending-point","2016-02-28T01:00:15Z");
var reExtensions = visca.setExtensions(start,end);
var reResponse = "2[,]6";
var reScore = visca.setScore(0,78,100);
var reSuccess = false;
var result = visca.setResult(reDuration,reExtensions,reResponse,reScore,reSuccess);
var instructor = visca.setInstructorByMbox("Teacher","mailto:teacher@visca.com");
var category = visca.setCategory("https://w3id.org/xapi/acrossx/profile/video");
var parentID = "http://visca.com/video/2";
var pName = visca.setName("zh-TW","補充影片");
var pType = "https://w3id.org/xapi/acrossx/activities/video";
var parentDef = visca.setDefinition(pName,null,pType,null,null,null,null);                                 
var parent = visca.setParent(parentID,parentDef);
var contextActivities = visca.setContextActivities(parent,null,category);
var contextExtensions = visca.setExtension("browser-info");
var context = visca.setContext(instructor,null,contextActivities,null,contextExtensions);
var authority = visca.setAuthorityByMbox("Crystal","mailto:crystal@visca.com");
var timestamp = visca.setTimestamp();

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

customizedReadVideoHints()

  • 作用:學生閱讀嵌入在影片中的題目的補充資訊或提示
  • 參數:表A
Example
var actor = visca.setActorByMbox("Crystal","mailto:crystal@visca.com");
var verbDisplay = visca.setDisplay("zh-TW","閱讀");
var verb = visca.setVerb("http://w3id.org/xapi/adb/verbs/read", verbDisplay);
var objectID = "http://visca.com/question/id/1";
var defName = visca.setName("zh-TW","第一題");
var defDescription = visca.setDescription("zh-TW","哪一個人最帥?");
var defType = "http://adlnet.gov/expapi/activities/cmi.interaction";
var defInteractionType = "choice";
var defCorrectResponsesPattern = visca.setCorrectResponsesPattern("king");
var alignment = visca.setExtension("alignment",["社4-4-2-4","語1-1-2-2"]);
var bloomsLevel = visca.setExtension("blooms-level","Applying");
var supplementalInfo = visca.setExtension("supplemental-info","your hint!");
var defExtensions = visca.setExtensions(alignment,bloomsLevel,supplementalInfo);
var objectDef = visca.setDefinition(defName,defDescription,defType,defExtensions,defInteractionType,defCorrectResponsesPattern,null);
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 parentID = "https://www.youtube.com/watch?v=sQcwRGTW5mw";
var pName = visca.setName("zh-TW","Future Learning");
var pType = "https://w3id.org/xapi/acrossx/activities/video";
var pExtensions = visca.setExtension("duration","PT12M47S");
var parentDef = visca.setDefinition(pName,null,pType,pExtensions,null,null,null);
var parent = visca.setParent(parentID,parentDef);
var category = visca.setCategory("https://w3id.org/xapi/acrossx/profile/video","https://w3id.org/xapi/acrossx/profile/practice");
var contextActivities = visca.setContextActivities(parent,null,category);
var contextExtensions = visca.setExtension("browser-info");
var context = visca.setContext(instructor,null,contextActivities,null,contextExtensions);
var authority = visca.setAuthorityByMbox("Crystal","mailto:crystal@visca.com");
var timestamp = visca.setTimestamp();

visca.customizedReadVideoHints(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 必要:被指定觀看影片、觀看影片、跳過影片片段、做筆記、閱讀提示
建議:回答問題
interactionType String 問題類型,參考 Interaction Activities 必要:回答問題、閱讀提示
correctResponsesPattern Array of String 正確答案 建議:回答問題、閱讀提示
choices Array of Objects 選項 選填:閱讀提示

表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 對齊的課綱、能力、知識節點或其他指標 建議
http://id.tincanapi.com/extension/duration ISO 8601 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 必要:閱讀提示

(result.extensions)

名稱 屬性 說明 必要性
http://id.tincanapi.com/extension/starting-point ISO 8601 String 開始此活動之時間點 必要:觀看影片、跳過影片片段
建議:回答問題
選填:做筆記
http://id.tincanapi.com/extension/ending-point ISO 8601 String 結束此活動之時間點 必要:觀看影片、跳過影片片段
建議:回答問題
選填:做筆記
http://id.tincanapi.com/extension/time ISO 8601 String 此活動之時間點 必要:做筆記

(context.extensions)

名稱 屬性 說明 必要性
http://id.tincanapi.com/extension/browser-info Navigator Object 使用的瀏覽器資訊 建議
http://id.tincanapi.com/extension/starting-point ISO 8601 String 開始做筆記的時間戳記 選填:做筆
http://id.tincanapi.com/extension/ending-point ISO 8601 String 結束做筆記的時間戳記 選填:做筆記

表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 建議:被指定觀看影片
必要:回答問題、閱讀提示
grouping[0] Activity Object 所屬的班級識別或任何額外的類別標籤,物件格式請參考表4-2-2 建議:被指定觀看影片
category[0] Activity Object 影片的 Profile ID Activity,物件格式請參考表4-2-3 必要
category[1] Activity Object 自我練習的 Profile Activity,物件格式請參考表4-2-3 必要:回答問題、閱讀提示

表4-2-1

  • 物件名稱:parent[0]
  • 組成元素:
名稱 屬性 說明 必要性
objectType String "Activity" 必要
id URL 一個唯一的 Activity ID 必要
definition Object 元數據,物件格式請參考表3-1(只有name,type必要) 必要

表4-2-2

  • 物件名稱:grouping[0]
  • 組成元素:

表4-2-3

  • 物件名稱:category[0]、category[1]
  • 組成元素:
名稱 屬性 說明 必要性
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 ""