Object Interaction Resource - Use

Overview of Use, an Object Interaction Resource

For information on what Object Interactions are, click here.

The Use object interaction emits an event once the user uses an object. The author can specify the number of times the object must be used, as well as the targets the object must be used on before the event is emitted. The Use object interaction is similar to the Use Tool resource, except it does not require the object to be used on a particular target.


Required Fields:

Field Name Description
World Objects The object the learner is to use.

Optional Fields:

Field Name Description
Require All Targets If more than one World Object is designated, this would require all.  Otherwise referred to as Target Object.
Prompts Add an effect or text to draw attention to the item you'd like the learner to.
Prompt Anchor Object Interaction prompts without an anchor will end up on the object you are targeting because they’re meant as annotation or extra information about the object in question. If you want to accompany an Object Interaction with additional information for the learner, you could add a Notification or Screen Message to the frame as well.
Number of Times The number of times the learner is required to use the item.
Targets Where the item needs to be used.
Any Other Target This allows you to detect if the learner has tried to use something other than the correct target. Triggering off of a resource where "any other target" is flagged allows you to author consequences for the "did not do it right" action, if necessary, without having to list all of the "wrong" items individually.
Event Determine an event or Custom Event to fire along with any other events that would normally fire.  This field is generally used to distinguish between different options for branching.
Require All Inputs If more than one Input is designated, this would require all.
Persistent Will stay open and continue listening for Input and will continue to fire scripted events.  If this is chosen, the close event cannot be used as it doesn't close.
Interacted Objects If multiple World Objects are identified, you can add a variable here that contains a record of the World Objects the learner has interacted with and the variable then affects only those in that list.


ActivateOpenClose (if not persistent), Complete and Custom.

Example in the Headset:

In the Workshop, I'd like the learner to spray the spray bottle two times.

  • Add the item (spray bottle) as a Scene Object in a frame.
  • Add the Use Resource to a frame:
    • Choose the item under World Objects.
    • Set the number of times the object must be used (optional):

I've also added a Screen Message to appear after the Spray Bottle has been used:

Screen Shot 2021-03-31 at 12.19.30 PM

This is what the learner will see in the headset: