1. Help Center
  2. Tutorials
  3. Workshop Training Tutorials

Workshop Tutorial 4 - Cue the Trainee

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


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: 

Quick Links

Step 1: Create a new script

Step 2: Instruct the trainee to put on the hard hat

Step 3: Add a script launcher to the director script

Step 4: Use a condition to control when the notification appears

Step 5: Create an audio cue

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

In the Headset

Key Takeaways

Step 1: Create a new script 

  • Click on the script icon in the upper right-hand corner of the screen and add a new script called "Equip Hard Hat".

  • Click on the new script to edit it.

Step 2: Instruct the trainee to put on the hard hat

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

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

Equip hard hat 2

  • From the Resources area, drag a "Notification" resource into the frame:

2020-12-07_21-10-57 notification resource

  • 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.":

2020-12-07_21-16-33 notification box

  • 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

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

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

2020-12-07_21-28-26 Director Script

  • Create a new frame by clicking on the  "+" on the Main Frame and 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. 
  • Collapse the catalog menu.
launch (1)

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 and click on the "Launch Equip Hard Hat" frame.  Notice in the frame editor, there is a section for conditions:

Condition frame

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


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

2021-01-14_10-11-43 (1)

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

  • "Object Event" = "Video Content" (the title of the screen message, as the script object).
  • Event = "close".

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 the "Video Content" script: 

video content tab-1

  • 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":



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.

2021-01-14_10-27-41 (1)

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


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

2021-01-14_10-34-57 (1)


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 trainee 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.

  • Open the media catalog drawer in the right-side panel.
  • Click on "Create or Import a New Catalog".
  • Enter the Catalog name as "Workshop Voice Overs" and click "Create".


  • Click on 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. 

Add media to catalog

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.

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

Check mark

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:

2021-01-14_11-17-52 (1)

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.


Next Up:  Workshop Tutorial 5 - User Action: Equip