Custom Event Resource

For an overview of Resources, click here.

Deep Learning on Resources is found in Motive Academy. Click here to see the course this lesson is in.

 

Overview

The Custom Event Resource emits an Event within a Script. Frames can conditionally play if the Custom Event is specified using the Custom Event Condition. This Resource can be used for branching out a Script. 

The Custom Event Resource is different from the System State or Story Point Resources in that it does not use an Enum. Furthermore, the author can specify the scope in which the Custom Event is called out. For example, the Event can be local to the Script, or global (in the session).

Required Fields

 

Field Name

Description

Field Name

Description

Custom Event

Specifies the name of the Custom Event.

Events

Activate, Close, and Custom Event.

Example

As described above, Events are like flags or markers that allow an author to note when things have happened and then trigger new parts of the Scenario based on those Events. In this Script, I want to create an Event that is triggered by the learner watching an instructional video. Once I have this Event, I can use it throughout the script as a Condition.

Step 1: Create the Event

  1. Open the appropriate Script

  2. Click on the Events tab. It is in a tab beside Resources:

  3. Click +Add New

  4. Name the Event - “Cleaning Procedures Reviewed” (in this example)

  5. Make the Event Global (this means it can be used in any script in this Project)

  6. Click the checkmark to save:

 

Step 2: Add this Event to the script

Now that the Event has been created, we want to add it to the script after the video has been viewed.

  1. In this example, I will click on the Frame where the video is located

  2. At the bottom of the Screen Media Resource, I’ll click on the Event Link Shortcut

  3. Choose the Close Event:

 

Choosing close will open a new child Frame under the Frame with the video.

  1. I’ll Rename the child Frame - “Event”:

 

  1. Drag and drop the Event we just created into the Resources pane of the Assets Spawned Event Frame:

 

Now, when the learner views the video it is marked with an Event.

Step 3: Use Custom Event to trigger new Script or Frame Opening

  1. Open the next Script or Frame to be run in the Scenario. In this example, it’s instructions on what to do next.

  2. Drag and drop the Global Event you created into the Conditions pane of the script - Not the Resources:

 

  1. Save

This now says when the Event is triggered, the Screen Message with instructions can fire.

Related Articles

Resources: An Overview

Replay Frame Resource

Close Frame Resource