verbs

the hypexapi setdefault() function allows you to specify custom xapi verbs to be used in your hype documents this is useful for creating custom statements that can be used to track specific events or user interactions in your hype document to use this function, you first need to create an object containing your custom verb definitions each verb definition should include an id and display property the id property should contain the unique id of the verb, while the display property should include an object with a language code (such as "en us") and the verb's display name in that language once you have created your custom verb object, you can then pass it to the hypexapi setdefault() function this will set your custom verbs as the default verbs to be used in your hype document here is an example of how to use the hypexapi setdefault() function hypexapi setdefault("verbs", { "started" { "id" "http //adlnet gov/expapi/verbs/started", "display" { "en us" "started" } }, "finished" { "id" "http //adlnet gov/expapi/verbs/finished", "display" { "en us" "finished" } } }); in this example, we have defined two custom verbs "started" and "finished" these verbs can now be used in our hype document to track when a user starts and finishes an interaction you can also specify a function for the verb definition this function will be evaluated when the verb is used in an xapi statement this can be useful for creating dynamic statements that change based on the user's interaction with the document once you have created your custom verb object, you can then pass it to the hypexapi setdefault() function this will set your custom verbs as the default verbs to be used in your hype document here is an example of how to use the hypexapi setdefault() function with a function arrow notation hypexapi setdefault("verbs", { "dynamic" () => ({ "id" "http //adlnet gov/expapi/verbs/dynamic", "display" { "en us" () => hypedocument customdata dynamicvalue } }) }); function notation hypexapi setdefault("verbs", { "dynamic" function(){ return { "id" "http //adlnet gov/expapi/verbs/dynamic", "display" { "en us" function(){ return hypedocument customdata dynamicvalue } } } } }); in this example, we have defined a custom verb called "dynamic" this verb is a function that will be evaluated when it is used in an xapi statement the function will return a statement with an id and display property that is determined by the value of the customdata dynamicvalue property in the hype document this allows us to create xapi statements that are dynamically generated based on the user's interaction with the document