Object Interaction Resource - Turn Towards

Overview of Turn Towards, an Object Interaction Resource

For information on what Object Interactions are, click here.

The Turn Towards object interaction emits an event once the user turns towards the specified object(s). The author can specify an offset and a tolerance for determining when the turn is valid.

An example of how the Turn Towards object interaction could be used is when the user must turn towards another character in the scene. Once the user is facing the character, the author can then make the character speak to the user. Another way to use the Turn Towards object interaction is to set the offset to 180. This results in the event being emitted when the user turns away from the specified object.


Required Fields:

Field Name Description
World Objects The object you want the learner to turn towards.

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.
Offset Offset is the number of degrees between 0 and 360 that you are away from the center point of the object you are turning towards. This number can be positive or negative. If you set this to 0 to you need to face the target dead-on, if you set it to 180 you need to turn your back to it to trigger it.

Tolerance is the range that will trigger the "complete" or close" so if you set offset to 0, but add a tolerance of 30 degrees, you can be anywhere from 0 to + or - 30 degrees from zero to complete.  If you set tolerance to 0 you would need to hit the angle exactly. 

Setting a small amount of tolerance is a good authoring idea.  

Duration The duration of time for the turn.  
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 want the learner to turn towards the safety hat and then get a message to put on the hat.

  • Add the World Object as a Scene Object to a frame.
  • Add the Turn Towards Resource to a frame.
    • Choose the World Object from the dropdown:

Screen Shot 2021-03-31 at 1.54.03 PM

  • I've also added a Screen Message to appear once the Turn To Resource has closed:
Screen Shot 2021-03-31 at 1.54.46 PM

In the headset, this is what the learner will see: