Learn to author visual and audio cues that guide the learner.
Training Notes
In this article, we will start to use Conditions and therefore the concept of Frame Processing. We will also discuss the Notification Resource and Object Event Condition. Please review these articles before starting:
Step 1: Create a new script
Click on the Script icon
Add a new script called Equip Hard Hat
Click on the new script to edit it
Step 2: Instruct the learner to put on the hard hat
In this step, we will create a text instruction to guide the learner on what to do first.
Make sure that the active script is Equip Hard Hat
Drag and drop a Notification Resource into the frame:
In the message area type: Safety First! Go to the workbench by clicking on the green arrow above it, and put on the hard hat. :
Name this frame Notification.
Save. If you reset and try the scenario in the headset right now, you won't see your notification - we'll fix that in the next step.
Step 3: Add a script launcher to the director script
Now we need to attach the "Equip Hard Hat" script to the Director Script.
Open the Director script (by clicking on the tab or choosing it from the Script icon):
Click + to create a new frame on the Main Frame
Name the new frame Equip Hard Hat
Click on the Script icon
Click on the Script catalog
Drag the Equip Hard Hat script to the Resource area
Collapse the catalog menu
STOP: Save and Test.
Training Notes
When you test - you'll notice that your notification comes up at the same time as your screen message. It would be better if the notification appears after you have read the screen message. We can control this using conditions.
Step 4: Use a condition to control when the notification appears
Make sure that Director Script is the active script
Click on the Equip Hard Hat frame
Notice in the frame editor, there is a section for conditions:
Switch from the resources pane to the Conditions pane in the frame tools section:
Find the Object Event condition
Drag and drop the condition into the top condition frame. This allows you to say "when the resource I choose fires a specific event, open this frame".
In this case, we want the notification to show after the video message.
"Script Object" = "Video Content" (the title of the screen message, as the script object)
Event = "close"
Save
This now says: "When the video finishes playing, open and run this frame to show the notification":
As a final step, we need to create an "End Script" resource in the video content script to indicate that the video has closed.
Open the Video Content script
Scroll to the bottom of the Screen Media resource and click the "+" on the bottom right corner:
A menu will appear. Scroll down and choose "close":
Note:
If you click the blue "+" button and you don't see the menu, your computer window is likely too small.
To resolve this, widen the window on your computer screen. This is typically the result of viewing two windows side by side on your monitor, or if you've significantly increased the size of the window contents.
This will open a child frame under the video frame on the far left side.
Within the new child frame, drag an End Script resource in:
STOP: Save, Reset in the headset, and Test. This time you should see that the notification appears after the video plays.
Training Notes
It is good practice to always complete a script with an "End Script" resource, in case you want to add the script closing as an object event condition later. It will save you from having to go back and add "End Script" resources, as we did above.
Step 5: Create an audio cue
Now, let's add an audio file to the frame so that the learner gets a written notification as well as an audio prompt.
You can create placeholder voice files within Storyflow. This feature allows you to test the audio content and complete your scripts without having to record voice-overs. First, let's create a new media catalog for the voice-over files.
Click on the Media Shortcut
Click on Create or Import a New Catalog
Enter the Catalog name as Workshop Voice Overs
Click Create:
Open the Workshop Voice Over media catalog
Click New Item
Choose Media. This will take you to the Media Library, where you can create a text to speech audio file.
Note: If you wanted to use a file stored on your computer instead, you would click "Upload Item" instead of "New Item".
In the media library follow these steps:
Click on the text to speech button in the top right corner.
Select the accent and voice you would like to use.
Add your text "Safety First! Your first task is to put on your hard hat. Go to the workbench by clicking on the green arrow above it. Once you're there, pick up the hard hat and put it on, by bringing it towards your head. "
Hit the "preview" button to see what it sounds like.
Name file.
Save.
Your file will then appear in the "Workshop Voiceovers" catalog.
Add Title
Click on the checkmark to Save
Step 6: Add the Audio Cue to the "Equip Hard Hat" Script
Check that "Equip Hard Hat" is the active script.
Open the "Notification" frame.
Now we want to drop in the Text to Speech audio we just made.
Click on the catalog icon.
Click on "Workshop Voice Overs".
Drag your audio file to the frame.
Collapse the catalog menu:
STOP: Save, Reset in the headset, and Test. An audio cue should now show up at the same time as the notification.
Note: You won't be able to put on the hard hat yet. We'll cover that in the next Tutorial.
In the Headset
This is what your scenario will look like so far:
Training Notes
Key Takeaways from Tutorial 4
Conditions help you control the order of items in the scene.
It is a best practice to always complete a script with an End Script resource. This way you can quickly add object event conditions at a later time.
The Text to Speech tool in the Media Library is a great tool to create on-the-fly audio, even if it's simply a placeholder for future recordings that you will upload.