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 |
---|---|
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
Open the appropriate Script
Click on the Events tab. It is in a tab beside Resources:
Click +Add New
Name the Event - “Cleaning Procedures Reviewed” (in this example)
Make the Event Global (this means it can be used in any script in this Project)
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.
In this example, I will click on the Frame where the video is located
At the bottom of the Screen Media Resource, I’ll click on the Event Link Shortcut
Choose the Close Event:
Choosing close will open a new child Frame under the Frame with the video.
I’ll Rename the child Frame - “Event”:
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
Open the next Script or Frame to be run in the Scenario. In this example, it’s instructions on what to do next.
Drag and drop the Global Event you created into the Conditions pane of the script - Not the Resources:
Save
This now says when the Event is triggered, the Screen Message with instructions can fire.