設定參數函式

  • setActorByMbox(name,mbox);
  • setActorByMboxSha1sum(name,mbox_sha1sum);
  • setActorByOpenid(name,openid);
  • setActorByAccount(name,homePage,accountName);
  • setVerb(id,display);
  • setDisplay(language1,value1,...,languageN,valueN);
  • setObject(id,definition);
  • setDefinition(name,description,type,extensions,interactionType,correctResponsesPattern,choices);
  • setName(language1,value1,...,languageN,valueN);
  • setDescription(language1,value1,...,languageN,valueN);
  • setExtensions(extension1,...,extensionN);
  • setCorrectResponsesPattern(pattern1,...,patternN);
  • setChoices(id1,description1,...,idN,descriptionN);
  • setResult(duration,extensions,response,score,success);
  • setScore(min,raw,max);
  • setContext(instructor,language,contextActivities,platform,extensions, team, statementID);
  • setInstructorByMbox(name,mbox);
  • setInstructorByMboxSha1sum(name,mbox_sha1sum);
  • setInstructorByOpenid(name,openid);
  • setInstructorByAccount(name,homePage,accountName);
  • setContextActivities(parent,group,category);
  • setParent(id1,definition1,...,idN,definitionN);
  • setCategory(id1,...,idN);
  • setAuthorityByMbox(name,mbox);
  • setAuthorityByMboxSha1sum(name,mbox_sha1sum);
  • setAuthorityByOpenid(name,openid);
  • setAuthorityByAccount(name,homePage,accountName);
  • setTimestamp();

函式說明

setActorByMbox()

  • 作用:使用 mbox 設定主詞
  • 參數:
名稱 型態 說明
name String 腳色全名
mbox mailto IRI 腳色之電子郵件
Example
var actor = visca.setActorByMbox("Crystal","mailto:crystal@visca.com");

setActorByMboxSha1sum()

  • 作用:使用 mbox_sha1sum 設定主詞
  • 參數:
名稱 型態 說明
name String 腳色全名
mbox_sha1sum mailto IRI 將 mailto IRI 進行 SHA1 hash
Example
var actor = visca.setActorByMboxSha1sum("Crystal","mailto:crystal@visca.com");
{
    "objectType": "Agent",
    "name": "Crystal",
    "mbox_sha1sum": "0e2b882ae30d010c80e93d2cbd134076d8e1fad3"
}

setActorByOpenid()

  • 作用:使用 openid 設定主詞
  • 參數:
名稱 型態 說明
name String 腳色全名
openid URI 一個唯一的 openID
Example
var actor = visca.setActorByOpenid("Crystal","http://crystal.openid.example.org/");

setActorByAccount()

  • 作用:使用 account 設定主詞
  • 參數:
名稱 型態 說明
name String 腳色全名
homePage IRL 此帳戶之服務首頁
accountName String 帳戶的 ID
Example
var actor = visca.setActorByAccount("Crystal","https://auth.ischool.com.tw/","f9e2t55c-7451-4d0b-ac3r-7201q1a6dfgf");

setVerb()

  • 作用:設定動詞
  • 參數:
名稱 型態 說明
id URL 使用的動作
display Object 使用動作的多語言之表示
Example
var id = "https://w3id.org/xapi/acrossx/verbs/watched";
var display = visca.setDisplay("zh-TW","觀看");
var verb = visca.setVerb(id,display);

setDisplay()

  • 作用:設定多語言之表示
  • 參數:
名稱 型態 說明
language String 語言代碼
value String 對應語言之表示
Example
var display = visca.setDisplay("zh-TW","跳過");
var display = visca.setDisplay("zh-TW","跳過","en-US","skipped");

setObject()

  • 作用:設定對象
  • 參數:
名稱 型態 說明
id URL 連結
definition Object 元數據
Example
var id = "https://www.youtube.com/watch?v=sQcwRGTW5mw";
var name = visca.setName("zh-TW","Future Learning");
var description = visca.setDescription("zh-TW","【親子天下】《翻轉教育:未來教育 Future Learning》");
var type = "https://w3id.org/xapi/acrossx/activities/video";
var extensions = visca.setExtension("duration","PT12M47S");
var definition = visca.setDefinition(name,description,type,extensions,null,null,null);
var object = visca.setObject(id,definition);

setDefinition()

  • 作用:設定元數據 (Metadata)
  • 參數:
名稱 型態 說明
name Object 活動名稱
description Object 活動描述
type URL 活動類型
extensions Object 活動的額外資訊
interactionType String 問題類型
correctResponsesPattern Array of Strings 正確答案
choices Array of Objects 選項
Example
var name = visca.setName("zh-TW","1");
var description = visca.setDescription("zh-TW","哪一個人最帥?");
var type = "http://adlnet.gov/expapi/activities/cmi.interaction";
var interactionType = "choice";
var correctResponsesPattern = visca.setCorrectResponsesPattern("king");
var id1 = "king";
var king = visca.setDescription("zh-TW","金城武");
var id2 = "ming";
var ming = visca.setDescription("zh-TW","明金城");
var choices = visca.setChoices(id1,king,id2,ming);
var definition = visca.setDefinition(name,description,type,extensions,interactionType,correctResponsesPattern,choices);

setName()

  • 作用:設定名稱
  • 參數:
名稱 型態 說明
language String 語言代碼
value String 對應語言之名稱
Example
var name = visca.setName("zh-TW","《老人與海》");

setDescription()

  • 作用:設定描述
  • 參數:
名稱 型態 說明
language String 語言代碼
value String 對應語言之描述
Example
var description = visca.setDescription("zh-TW","作者是海明威");

setExtension()

  • 作用:設定額外資訊
  • 參數:
名稱 型態 說明
key String 額外資訊的類別
value String/Activity Object/URL/Integer/ISO 8601 String/Array of String 額外資訊內容
Example
var bloomsLevel = visca.setExtension("blooms-level","Applying");
var page = visca.setExtension("page",8);
var browserInfo = visca.setExtension("browser-info");

setExtensions()

  • 作用:設定多項額外資訊
  • 參數:
名稱 型態 說明
extension Object setExtension 單項設定的額外資訊 JSON 物件
Example
var alignment = visca.setExtension("alignment",["社4-4-2-4","語1-1-2-2"]);
var duration = visca.setExtension("duration","PT12M47S");
var extensions = visca.setExtensions(alignment,duration);

setCorrectResponsesPattern()

  • 作用:設定正確答案
  • 參數:
名稱 型態 說明
pattern String 正確答案
Example
var correctResponsesPattern = visca.setCorrectResponsesPattern("king");

setChoices()

  • 作用:設定選項
  • 參數:
名稱 型態 說明
id String 選項id
description Object 選項內容描述
Example
var id1 = "king";
var king = visca.setDescription("zh-TW","金城武");
var id2 = "ming";
var ming = visca.setDescription("zh-TW","明金城");
var choices = visca.setChoices(id1,king,id2,ming);

setResult()

  • 作用:設定結果
  • 參數:
名稱 型態 說明
duration ISO 8601 String 活動花費時間
extensions Object 額外資訊
response String 回答內容/筆記內容
score Object 分數
success Boolean 答對與否
Example
var duration = "PT20S";
var extensions = null;
var response = "king";
var score = visca.setScore(0,10,10);
var success = true;
var result = visca.setResult(duration,extensions,response,score,success);

setScore()

  • 作用:設定分數
  • 參數:
名稱 型態 說明
min Decimal number less than max 最低分
raw Decimal number between min and max 得分
max Decimal number greater than min 最高分
Example
var score = visca.setScore(0,10,10);

setContext()

  • 作用:設定情境
  • 參數:
名稱 型態 說明
instructor Agent Object 如果教學者不是動作者時,請填寫教學者
language String 此情境中使用之語言
contextActivities Object 學習活動情境之各類型資訊
platform String 使用平台
extensions Object 額外資訊
team Agent Object
statementID String
Example
var instructor = visca.setInstructorByMbox("Crystal","mailto:crystal@visca.com");
var language = "zh-TW";
var contextActivities = visca.setContextActivities();
var platform = "Example virtual meeting software";
var context = visca.setContext(instructor, language, contextActivities, platform, null, null, null);

setInstructorByMbox()

  • 作用:使用 mbox 設定教學者
  • 參數:
名稱 型態 說明
name String 全名
mbox mailto IRI 電子郵件
Example
var instructor = visca.setInstructorByMbox("Crystal","mailto:crystal@visca.com");

setInstructorByMboxSha1sum()

  • 作用:使用 mbox_sha1sum 設定教學者
  • 參數:
名稱 型態 說明
name String 全名
mbox_sha1sum mailto IRI 將 mailto IRI 進行 SHA1 hash
Example
var instructor = visca.setInstructorByMboxSha1sum("Crystal","mailto:crystal@visca.com");
{
    "objectType": "Agent",
    "name": "Crystal",
    "mbox_sha1sum": "0e2b882ae30d010c80e93d2cbd134076d8e1fad3"
}

setInstructorByOpenid()

  • 作用:使用 openid 設定教學者
  • 參數:
名稱 型態 說明
name String 全名
openid URI 一個唯一的 openID
Example
var instructor = visca.setInstructorByOpenid("Crystal","http://crystal.openid.example.org/");

setInstructorByAccount()

  • 作用:使用 account 設定教學者
  • 參數:
名稱 型態 說明
name String 全名
homePage IRI 此帳戶之服務首頁
accountName String 帳戶的 ID
Example
var instructor = visca.setInstructorByAccount("Crystal","https://auth.ischool.com.tw/","f9e2t55c-7451-4d0b-ac3r-7201q1a6dfgf");

setContextActivities()

  • 作用:設定學習活動情境之各類型資訊
  • 參數:
名稱 型態 說明
parent Object 所屬的母活動
group
category Object Profile ID Activity
Example
var id = "http://www.visca.com/plan/id/1";
var name = visca.setName("zh-TW","我的學習計畫");
var type = "https://w3id.org/xapi/acrossx/activities/learning-plan";
var definition = visca.setDefinition(name,null,type,null,null,null,null);
var parent = visca.setParent(id,definition);
var category = visca.setCategory("https://w3id.org/xapi/acrossx/profile/video");
var contextActivities = visca.setContextActivities(parent,null,category);

setParent()

  • 作用:設定所屬的母活動
  • 參數:
名稱 型態 說明
id URL 一個唯一的 Activity ID
definition Object 母活動之元數據
Example
var id = "https://www.youtube.com/watch?v=sQcwRGTW5mw";
var name = visca.setName("zh-TW","Future Learning");
var type = "https://w3id.org/xapi/acrossx/activities/video";
var extensions = visca.setExtension("duration","PT12M47S");
var definition = visca.setDefinition(name,null,type,extensions,null,null,null);
var parent = visca.setParent(id,definition);

setCategory()

  • 作用:設定 Profile ID Activity
  • 參數:
名稱 型態 說明
id URL Profile ID Activity
Example
var category = visca.setCategory("https://w3id.org/xapi/acrossx/profile/video");
var category = visca.setCategory("https://w3id.org/xapi/acrossx/profile/practice","https://w3id.org/xapi/acrossx/profile/ebook");

setAuthorityByMbox()

  • 作用:使用 mbox 設定擁有者
  • 參數:
名稱 型態 說明
name String 全名
mbox mailto IRI 電子郵件
Example
var authority = visca.setAuthorityByMbox("Teacher","mailto:teacher@visca.com");

setAuthorityByMboxSha1sum()

  • 作用:使用 mbox_sha1sum 設定擁有者
  • 參數:
名稱 型態 說明
name String 全名
mbox_sha1sum mailto IRI 將 mailto IRI 進行 SHA1 hash
Example
var authority = visca.setAuthorityByMboxSha1sum("Teacher","mailto:teacher@visca.com");
{
    "objectType": "Agent",
    "name": "Teacher",
    "mbox_sha1sum": "e81c473d8eb3d276bd7d696adfe9c8275b3969ae"
}

setAuthorityByOpenid()

  • 作用:使用 openid 設定擁有者
  • 參數:
名稱 型態 說明
name String 全名
openid URI 一個唯一的 openID
Example
var authority = visca.setAuthorityByOpenid("Teacher","http://teacher.openid.example.org/");

setAuthorityByAccount()

  • 作用:使用 account 設定擁有者
  • 參數:
Example
var authority = visca.setAuthorityByAccount("Teacher","http://www.example.com","13936749");
名稱 型態 說明
name String 全名
homePage IRI 此帳戶之服務首頁
accountName String 帳戶的 ID

setTimestamp()

  • 作用:設定時間戳記
  • 參數:無
  • 回傳值:格式為 [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss.sss]Z 的 ISO String
Example
var timestamp = visca.setTimestamp();

results matching ""

    No results matching ""