Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Learn to author visual and audio cues that guide the traineelearner.

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:

Table of Contents
minLevel1
maxLevel7

Guided Walkthrough

...

View video in full screen on Vimeo at this link.

Step 1: Create a new script (1:06 In Video)

  • Click on the script icon in the upper right-hand corner of the screen and add 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 (1:24 in Video)

In this step, we will create a text instruction to guide the trainee learner on what to do first.

  • Make sure that the active script is "Equip Hard Hat".

...

  • From the Resources area, drag a "Notification" resource

  • 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 your script. 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 (2:16 in Video)

Now we need to attach the "Equip Hard Hat" script to the Director Script.

  • Navigate back to Open the Director script (by clicking on the tab ( or choosing it from the Script icon):

...

  • Create Click + to create a new frame by clicking on the  "+" on the Main Frame and name

  • Name the new frame "Launch Equip Hard Hat".

  • Click on the Script icon.

  • Click on the Script catalog.

  • Drag the " Equip Hard Hat " script to the center of your screen. Resource area

  • Collapse the catalog menu.

GIF

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 (3:22 in Video)

  • Make sure that "Director Script" is the active script and click

  • Click on the "Launch Equip Hard Hat" frame

Notice in the frame editor, there is a section for conditions:

...

  • Switch from the resources pane to the conditions Conditions pane in the frame tools section:

...

  • Use the search bar to find an "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". 

GIF
In this case, we want the notification to show after the video message.

  • "Script Object Event" = "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. 

  • Navigate back to Open the "Video Content" script

...

  • Scroll to the bottom of the " Screen Media " resource and click the event link shortcut (the blue "+" icon) on the bottom right corner:

...

  • A menu will appear.  Scroll down and choose "close":

...

...

Note:

If you click the blue "+" event link shortcut 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.GIF

...

...

This will open a subframe child frame under the video frame on the far left side.

...

  • Within the "On Screen Media close" subframenew child frame, drag an "End Script " resource in:

...

...

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 (6:07 in Video)

Now, let's add an audio file to the frame so that the trainee learner gets a written notification as well as an audio prompt.

You can create placeholder voice files within StoryFlowStoryflow. 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.

  • Open the media catalog drawer in the right-side panel.Click on the Media Shortcut

  • Click on "Create or Import a New Catalog".

...

  • Enter the Catalog name as "Workshop Voice Overs " and click "Create".

...

  • Click on the "

  • Click Create:

  • Open the Workshop Voice Over" media catalog you just created.

  • Click "New Item".

  • "Choose Media". This will take you to the Media Library, where you can create a text to speech audio file. 

GIF

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:

...

  1. Click on the text to speech button in the top right corner.

  2. Select the accent and voice you would like to use.

  3. 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. "

  4. Hit the "preview" button to see what it sounds like.

  5. Name file.

  6. Save.

Your file will then appear in the "Workshop Voiceovers" catalog.

  • Add Title

  • Click on the checkmark to save it to this catalog.

...

  • Save

Step 6: Add the Audio Cue to the "Equip Hard Hat" Script

...

(8:20 in Video)

  • Open the 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. Media Shortcut:

  • Click on "Workshop Voice Overs ".Drag your audio file to the frame.Catalog

  • Find the Text to Speech file you just made and drag and drop it into the Resources section of the frame:

  • Collapse the catalog menu:

...

Info

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:Video

...

For full screen, view on Vimeo at this link.

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.

...

Next Up: Workshop Tutorial 5 - User Learner Action: Equip