Adding CenarioVR® content into Lectora®
Updated: Feb 11
In this blog, I’ll be showing you how we incorporated a CenarioVR scenario into our award winning FENDI responsive Lectora course.
FENDI project overview
How was it built?
I'll be focusing on how the CenarioVR scenario fits inside Lectora to create a seamless learning experience.
Build your CenarioVR scenario
Publish your CenarioVR scenario as a HTML5 package
Import your CenarioVR package into Lectora
Here's a breakdown of those steps...
1. Build your CenarioVR scenario
When creating your CenarioVR scenario, make use of the 'SCORE' variable. The value of this variable is then carried over to Lectora on completion.
There are 5 hotspots the user must find and click in this CenarioVR scenario. When the learner clicks on a hotspot, +1 is added to the default 'SCORE' variable. This default 'SCORE' variable is then transferred to a Lectora variable when the CenarioVR scenario is marked as complete.
At the end of the scenario, the user will be given their score out of 5. In a moment, I will show you how to display this score in Lectora.
Please note: You do not have to include a score to be able to add your content into Lectora! We included it here to aid the user's learning.
Add the 'Send Completion' action in CenarioVR. This triggers 'OnDone' actions in Lectora.
At the end of the CenarioVR activity/scene, add a 'Send Completion' action. This triggers designated 'OnDone' actions inside Lectora (more on this in a moment). This also carries the 'Score' variable value over from CenarioVR and adds it to a Lectora variable (again, more on this in a moment).
Please note: CenarioVR's default 'Score' variable is only transferred to Lectora if your CenarioVR scenario is set as completed via the 'Send Completion' action.
You can also use the 'Exit Scenario' action to trigger 'OnDone' actions, but as it is exiting the scenario and not marking it as complete, this action does not transfer the default 'Score' variable value from CenarioVR into Lectora.
In this activity, completion is sent when the timer runs out or when the user finds and clicks on all 5 hotspots.
2. Publish your CenarioVR scenario as a HTML5 package
Publish your CenarioVR title as a HTML5 package.
You can choose to have the package 'Scored' or 'Not Scored', along with entering a custom 'Passing Score'.
The 'Passed', 'Failed' and 'Completed' statuses are tracked by Lectora if the 'Send Completion' action is used. 'Passed' and 'Failed' are used if the HTML5 publish is scored; otherwise, 'Completed' is used.
3. Import your CenarioVR package into Lectora
Import the HTML5 zip file into Lectora and resize the CenarioVR object for each responsive view.
This is a super simple process! Select the page where you want to add the CenarioVR scenario. Go to 'Insert' > 'CenarioVR' and select your HTML5 package zip file.
Once uploaded, it will appear on your page in the title explorer as a purple object labelled “CenarioVR Scenario…”
If your course is responsive, resize the CenarioVR object for each responsive view, so that no matter the device, the CenarioVR content will fill the page.
You could stop here, but to help create a seamless experience between Lectora and CenarioVR, I continued with two extra steps.
Add 'OnDone' actions to the CenarioVR object.
I mentioned earlier that the 'Send Completion' action in CenarioVR will trigger 'OnDone' actions in Lectora. Well, here are those actions!
For the 'OnDone' actions to be triggered, they have to be added directly to the CenarioVR object as seen below:
Please note: Only these actions will be triggered by the 'Send Completion' action in CenarioVR.
The purpose of my two 'OnDone' actions are to:
Show a Lectora group which contains the user's score
Set the current page in Lectora to complete (as they have completed the activity)
If you wanted to, you can add IF conditions to these OnDone actions, e.g. Only set the Lectora page to complete IF the user has scored 5 out of 5. Or perhaps show a different ending screen containing constructive feedback depending on the user's score.
Add 'Show Score' actions to display the 'Score' generated in CenarioVR.
On my results screen (the Lectora group that appears once the CenarioVR scenario completes), I want to display the user's 'Score' using a Lectora Text object.
To accomplish this, when the results screen is shown (via 'OnDone' actions), the contents of the Text Box is set to display the score achieved in CenarioVR, e.g. 5 / 5.
Before we add these actions, we must first find and understand 3 variables:
To find these variables, go to Tools > Variables > Reserved.
These variables were automatically created when you imported your CenarioVR package. But what do they do?
'CenarioVR_Scenario_Duration' contains the time in seconds the user takes to complete the CenarioVR scenario.
'CenarioVR_Scenario_Result' contains the result (passed, failed, completed) of your scenario.
And the one we’re after, 'CenarioVR_Scenario_Score’, contains the value from the ‘Score’ variable found in CenarioVR.
Please note: The values of the above variables are only set in Lectora after the CenarioVR scenario is marked as completed.
Using the 'CenarioVR_Scenario_Score’ variable, the actions work like this:
OnShow, Set the contents of 'Text Box' to '0 / 5' IF 'CenarioVR_Scenario_Score' = 0
OnShow, Set the contents of 'Text Box' to '1 / 5' IF 'CenarioVR_Scenario_Score' = 1
OnShow, Set the contents of 'Text Box' to '2 / 5' IF 'CenarioVR_Scenario_Score' = 2
OnShow, Set the contents of 'Text Box' to '3 / 5' IF 'CenarioVR_Scenario_Score' = 3
OnShow, Set the contents of 'Text Box' to '4 / 5' IF 'CenarioVR_Scenario_Score' = 4
OnShow, Set the contents of 'Text Box' to '5 / 5' IF 'CenarioVR_Scenario_Score' = 5
To access the 'CenarioVR_Scenario_Score' variable for the IF condition, use the variable dropdown list in the IF conditions panel.
Tips and tricks
As with anything, we did learn a couple of things which I would like to share with you.
Point 1: The size and resolution of the CenarioVR file
As the users were accessing the content from their mobile devices, we had to make sure the content ran as smoothly as possible.
Using the ‘CenarioVR 360 Video Compression Guidelines’ found on the CenarioVR website, we discovered that we needed to reduce the quality of the 360 footage from 4K to HD. If we had left the 360 video as 4K, the scenario would sometimes struggle to load and cause the video itself to become very choppy.
The client also had restrictions on the size of the package they could upload to their LMS. This meant we had to keep all resource file sizes to a minimum. Fortunately, as we had already reduced the 360 video quality to HD rather than 4K (thus reducing the file size), this problem had already been solved.
Point 2: We had to create a workaround for replaying the scenario in Lectora
The way we have set up this activity in Lectora, it is currently impossible to reset your CenarioVR scenario without leaving or refreshing the page. However, we did create a workaround for this which involves jumping to and from a placeholder page. This works ok, but a dedicated function would be much appreciated.
Point 3: Plan the positioning of objects inside of CenarioVR
As the target device was an iPhone in portrait mode, we had to make sure everything fit on screen. As you can see below, the progress bar and timer fit perfectly on screen and means the user doesn’t miss out on anything.
This dedicated feature to add CenarioVR content into a Lectora course is simply awesome. CenarioVR actually talks to Lectora, giving you variables to play with.
With no coding needed, this simple solution enables your CenarioVR content to be a part of a much bigger learning experience.
My full presentation from the eLearning Brothers user conference can be watched here:
If you have any questions or are interested in Transition developing content for you, please get in touch below. You can also connect with and message me on LinkedIn, Jack Gayler.
In the meantime, check out our interactive video showcase on videointeract.co.uk