h5p-php-library/js/h5p-x-api-event.js

199 lines
4.5 KiB
JavaScript
Raw Normal View History

var H5P = H5P || {};
2015-02-16 15:30:49 +01:00
/**
* Constructor for xAPI events
2015-02-20 10:26:33 +01:00
*
2015-02-16 15:30:49 +01:00
* @class
*/
H5P.XAPIEvent = function() {
2015-02-11 15:56:35 +01:00
H5P.Event.call(this, 'xAPI', {'statement': {}});
};
H5P.XAPIEvent.prototype = Object.create(H5P.Event.prototype);
H5P.XAPIEvent.prototype.constructor = H5P.XAPIEvent;
2015-02-16 15:30:49 +01:00
/**
* Helperfunction to set scored result statements
2015-02-20 10:26:33 +01:00
*
2015-02-16 15:30:49 +01:00
* @param {int} score
* @param {int} maxScore
*/
H5P.XAPIEvent.prototype.setScoredResult = function(score, maxScore) {
2015-02-11 15:56:35 +01:00
this.data.statement.result = {
'score': {
'min': 0,
'max': maxScore,
'raw': score
}
};
};
2015-02-16 15:30:49 +01:00
/**
* Helperfunction to set a verb.
2015-02-20 10:26:33 +01:00
*
2015-02-16 15:30:49 +01:00
* @param {string} verb
* Verb in short form, one of the verbs defined at
* http://adlnet.gov/expapi/verbs/
*/
H5P.XAPIEvent.prototype.setVerb = function(verb) {
if (H5P.jQuery.inArray(verb, H5P.XAPIEvent.allowedXAPIVerbs) !== -1) {
2015-02-11 15:56:35 +01:00
this.data.statement.verb = {
'id': 'http://adlnet.gov/expapi/verbs/' + verb,
'display': {
'en-US': verb
}
};
}
else {
2015-02-20 10:26:33 +01:00
H5P.error('illegal verb');
}
};
2015-02-16 15:30:49 +01:00
/**
* Helperfunction to get the statements verb id
2015-02-20 10:26:33 +01:00
*
2015-02-16 15:30:49 +01:00
* @param {boolean} full
* if true the full verb id prefixed by http://adlnet.gov/expapi/verbs/ will be returned
* @returns {string} - Verb or null if no verb with an id has been defined
*/
2015-02-12 15:46:25 +01:00
H5P.XAPIEvent.prototype.getVerb = function(full) {
2015-02-11 20:06:40 +01:00
var statement = this.data.statement;
if ('verb' in statement) {
2015-02-12 15:46:25 +01:00
if (full === true) {
return statement.verb;
}
2015-02-11 20:06:40 +01:00
return statement.verb.id.slice(31);
}
else {
return null;
}
2015-02-20 10:26:33 +01:00
};
2015-02-11 20:06:40 +01:00
2015-02-16 15:30:49 +01:00
/**
* Helperfunction to set the object part of the statement.
2015-02-20 10:26:33 +01:00
*
2015-02-16 15:30:49 +01:00
* The id is found automatically (the url to the content)
2015-02-20 10:26:33 +01:00
*
2015-02-16 15:30:49 +01:00
* @param {object} instance - the H5P instance
*/
H5P.XAPIEvent.prototype.setObject = function(instance) {
if (instance.contentId) {
this.data.statement.object = {
2015-02-27 14:53:38 +01:00
'id': H5PIntegration.contents['cid-' + instance.contentId].url,
'objectType': 'Activity',
'extensions': {
'http://h5p.org/x-api/h5p-local-content-id': instance.contentId
}
};
}
else {
// Not triggered by an H5P content type...
this.data.statement.object = {
'objectType': 'Activity'
};
}
};
2015-02-16 15:30:49 +01:00
/**
* Helper function to set the actor, email and name will be added automatically
*/
H5P.XAPIEvent.prototype.setActor = function() {
2015-03-02 15:49:27 +01:00
if (H5PIntegration.user !== undefined) {
this.data.statement.actor = {
'name': H5PIntegration.user.name,
'mbox': 'mailto:' + H5PIntegration.user.mail,
'objectType': 'Agent'
};
}
else {
var uuid;
if (localStorage.H5PUserUUID) {
uuid = localStorage.H5PUserUUID;
}
else {
uuid = 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(char) {
var random = Math.random()*16|0, newChar = char === 'x' ? random : (random&0x3|0x8);
return newChar.toString(16);
});
localStorage.H5PUserUUID = uuid;
}
this.data.statement.actor = {
'account': {
'name': uuid,
'homePage': window.location.origin + H5PIntegration.basePath
},
'objectType': 'Agent'
};
}
};
2015-02-16 15:30:49 +01:00
/**
* Get the max value of the result - score part of the statement
2015-02-20 10:26:33 +01:00
*
2015-02-16 15:30:49 +01:00
* @returns {int} the max score, or null if not defined
*/
2015-02-05 10:46:55 +01:00
H5P.XAPIEvent.prototype.getMaxScore = function() {
return this.getVerifiedStatementValue(['result', 'score', 'max']);
};
2015-02-16 15:30:49 +01:00
/**
* Get the raw value of the result - score part of the statement
2015-02-20 10:26:33 +01:00
*
2015-02-16 15:30:49 +01:00
* @returns {int} the max score, or null if not defined
*/
2015-02-05 10:46:55 +01:00
H5P.XAPIEvent.prototype.getScore = function() {
return this.getVerifiedStatementValue(['result', 'score', 'raw']);
};
2015-02-16 15:30:49 +01:00
/**
* Figure out if a property exists in the statement and return it
2015-02-20 10:26:33 +01:00
*
2015-02-16 15:30:49 +01:00
* @param {array} keys
* List describing the property we're looking for. For instance
* ['result', 'score', 'raw'] for result.score.raw
* @returns the value of the property if it is set, null otherwise
*/
2015-02-05 10:46:55 +01:00
H5P.XAPIEvent.prototype.getVerifiedStatementValue = function(keys) {
2015-02-11 15:56:35 +01:00
var val = this.data.statement;
2015-02-16 15:30:49 +01:00
for (var i = 0; i < keys.length; i++) {
2015-02-05 10:46:55 +01:00
if (val[keys[i]] === undefined) {
return null;
}
val = val[keys[i]];
}
return val;
2015-02-16 15:30:49 +01:00
};
2015-02-05 10:46:55 +01:00
2015-02-16 15:30:49 +01:00
/**
* List of verbs defined at http://adlnet.gov/expapi/verbs/
2015-02-20 10:26:33 +01:00
*
2015-02-16 15:30:49 +01:00
* @type Array
*/
2015-02-05 10:46:55 +01:00
H5P.XAPIEvent.allowedXAPIVerbs = [
'answered',
'asked',
'attempted',
'attended',
'commented',
'completed',
'exited',
'experienced',
'failed',
'imported',
'initialized',
'interacted',
'launched',
'mastered',
'passed',
'preferred',
'progressed',
'registered',
'responded',
'resumed',
'scored',
'shared',
'suspended',
'terminated',
'voided'
2015-02-20 10:26:33 +01:00
];