Video Learning Service

• Instructor O assigned Actor K to watch Video V. wasAssignedVideo(actor, objectID, duration, instructor, authority);

• Actor K watched Video V. watchedVideoClips(actor, objectID, duration, instructor, start, end);

• Actor K skipped Video V. skippedVideoClips(actor, objectID, duration, instructor, start, end);

• Actor K took a note on timeline position T. tookVideoNotes(actor, objectID, duration, instructor, reDuration, reResponse,time);

• Actor K answered quiz item X embedded in Video V (position T). answeredVideoQuestions(actor, objectID, interactionType, instructor, reDuration, reResponse, reSuccess, parentID, time);

• Actor K read feedback/hint when answering quiz item X embedded in Video V (position T). readVideoHints(actor, objectID, interactionType, instructor, hint, parentID);

Supported versions: 1.x.x or later.

Functions

wasAssignedVideo()

• Description: Instructor O assigned Actor K to watch Video V.
• Parameters:

Name	Type	Description
actor	Agent Object	The person who was assigned to watch the video.
objectID	URL	The link to the video.
duration	ISO 8601 String	The length of the video.
instructor	Agent Object	Teacher
authority	Agent Object	Teacher

Example

var actor = visca.setActorByMbox("Crystal","[email protected]");
var objectID = "https://www.youtube.com/watch?v=sQcwRGTW5mw";
var duration = "PT12M47S";
var instructor = visca.setInstructorByMbox("Teacher","[email protected]");
var authority = visca.setAuthorityByMbox("Teacher","[email protected]");

visca.wasAssignedVideo(actor, objectID, duration, instructor, authority);

watchedVideoClips()

• Description: Actor K watched Video V.
• Parameters:

Name	Type	Description
actor	Agent Object	The person who watched the video clips.
objectID	URL	The link to the video.
duration	ISO 8601 String	The length of the video.
instructor	Agent Object	Teacher
start	ISO 8601 String	The time that the actor start watching video.
end	ISO 8601 String	The time that the actor end watching video.

Example

var actor = visca.setActorByMbox("Crystal","[email protected]");
var objectID = "https://www.youtube.com/watch?v=sQcwRGTW5mw";
var duration = "PT12M47S";
var instructor = visca.setInstructorByMbox("Teacher","[email protected]");
var start = "PT5S";
var end = "PT2M37S";

visca.watchedVideoClips(actor, objectID, duration, instructor, start, end);

skippedVideoClips()

• Description: Actor K skipped Video V.
• Parameters:

Name	Type	Description
actor	Agent Object	The person who skipped the video clips.
objectID	URL	The link to the video.
duration	ISO 8601 String	The length of the video
instructor	Agent Object	Teacher
start	ISO 8601 String	The time that the actor start watching video.
end	ISO 8601 String	The time that the actor end watching video.

Example

var actor = visca.setActorByMbox("Crystal","[email protected]");
var objectID = "https://www.youtube.com/watch?v=sQcwRGTW5mw";
var duration = "PT12M47S";
var instructor = visca.setInstructorByMbox("Teacher","[email protected]");
var start = "PT0S";
var end = "PT5S";

visca.skippedVideoClips(actor, objectID, duration, instructor, start, end);

tookVideoNotes()

• Description: Actor K took a note on timeline position T.
• Parameters:

Name	Type	Description
actor	Agent Object	The people who took notes.
objectID	URL	The link to the video.
duration	ISO 8601 String	The length of the video.
instructor	Agent Object	Teacher
reDuration	ISO 8601 String	The time that actor spend on taking notes.
reResponse	String	The content of notes.
time	ISO 8601 String	The time that actor took notes.

Example

var actor = visca.setActorByMbox("Crystal","[email protected]");
var objectID = "https://www.youtube.com/watch?v=sQcwRGTW5mw";
var duration = "PT12M47S";
var instructor = visca.setInstructorByMbox("Teacher","[email protected]");
var reDuration = "PT30S";
var reResponse = "Education is important.";
var time = "PT2M20S";

visca.tookVideoNotes(actor, objectID, duration, instructor, reDuration, reResponse, time);

answeredVideoQuesions()

• Description: Actor K answered quiz item X embedded in Video V (position T).
• Parameters:

Name	Type	Description
actor	Agent Object	The person who answered the question.
objectID	URL	The link to the question.
interactionType	String	The type of the question. Refer to Interaction Activities
instructor	Agent Object	Teacher
reDuration	ISO 8601 String	The amount of time actor spend answering a question.
reResponse	String	The content that actor answered.
reSuccess	Boolean	It's the correct answer or not.
parentID	URL	The link to the video of parent activity.
time	ISO 8601 String	The time that the question appeared.

Example

var actor = visca.setActorByMbox("Crystal","[email protected]");
var objectID = "http://visca.com/question/id/1";
var interactionType = "fill-in";
var instructor = visca.setInstructorByMbox("Teacher","[email protected]");var reDuration = "PT20S";
var reResponse = "2[,]6";
var reSuccess = false;
var parentID = "https://www.youtube.com/watch?v=sQcwRGTW5mw";
var time = "PT1M";

visca.answeredVideoQuestions(actor, objectID, interactionType, instructor, reDuration, reResponse, reSuccess, parentID, time);

readVideoHints()

• Description: Actor K read feedback/hint when answering quiz item X embedded in Video V (position T).
• Parameters:

Name	Type	Description
actor	Agent Object	The person who read the supplemental information or hint of the question.
objectID	URL	The link to question.
interactionType	String	The type of the question. Refer to Interaction Activities
instructor	Agent Object	Teacher
hint	String/Activity Object/URL	Hint or feedback revealed.
parentID	URL	The link to the video of parent activity.

Example

var actor = visca.setActorByMbox("Crystal","[email protected]");
var objectID = "http://visca.com/question/id/2";
var interactionType = "choice";
var instructor = visca.setInstructorByMbox("Teacher","[email protected]");
var hint = "Your hint!";
var parentID = "https://www.youtube.com/watch?v=sQcwRGTW5mw";

visca.readVideoHints(actor, objectID, interactionType, instructor, hint, parentID);