In depth learning on Scene Configuration can be found in this course in Motive Academy.
Overview
This article describes how you can implement Motive’s premade Sliding Joint component to connect 3D Assets and have them interact as if they were connected on rails. With only a few minor changes made in Unity, this functionality allows for easy and fast interaction that can be used in conjunction with other Motive premade features such as, VR Attachable, VR Attachable Receiver and VR Grabbable. After that, we will cover how we can check object states related to sliding objects in order to trigger events on Storyflow.
Setup - Unity SDK
Open your Unity project and in the scene Hierarchy window select (World > Example Assets > Props > Workbench > Workbench_LOD0 > Bench Top)
Under the Mesh Collider component turn Is Trigger to off
Scroll down to the bottom of the Inspector window and select (Add Component > (Type in “Rigidbody”) > Rigidbody)
In the Rigidbody component toggle Use Gravity to off and toggle Is Kinematic to on
Then in the Hierarchy window select (World > Example Assets > Props > Workbench > Stud > Stud)
In the Rigidbody component toggle Use Gravity to off and toggle Is Kinematic to on. After that set your Collision Detection to Discrete
In the Mesh Collider component toggle Is Trigger to off
Right-click on Stud in the Hierarchy window and select (Motive > Make Grabbable)
Scroll down to the new Mesh Collider component and delete it by selecting the *Three dots* on the top right of the component, then select Remove Component
In the new VR Grabbale component make sure that Allow Distance Grab is toggled off
In the Snap Position and Snap Orientation dropdown menus make sure both values are set to Never
Toggle Track Orientation to off
Set Release Behaviour to Leave In Place
Then change Move Mode to Physics
While you are still in the Stud Inspector window scroll down to the bottom and select (Add Component > (Type in “String State Setter”) > String State Setter)
In the State textbox type “Plank Position”
Back in the Hierarchy window right-click on Stud and select (Motive > Joints > Add Sliding Joint)
In the new Sliding Joint component under Axis change the X value to 0 and set the Y value to 1
Under Secondary Axis set the X value to 1 and the Y value to 0
Next, select the *Target* icon for the Connected Rigidbody area and then select Bench Top
Then, toggle Limit Motion to On
In the Lower Limit text area type “-0.2” and for the Upper Limit type “0.4”
Expand the Upper Stop dropdown menu and under Limit Threshold type “0.2”
Next in the In Limit() area hit the + icon then drag Stud from your Hierarchy window into the box that reads None (Object)
Then, expand the No Function dropdown menu and select (StringStateSetter > SetState (String))
In the *Newly Created Textbox* type “Outside”
Expand the Lower Stop dropdown menu and under Limit Threshold type “0.1”
Next in the In Limit() area hit the + icon then drag Stud from your Hierarchy window into the box that reads None (Object)
Then, expand the No Function dropdown menu and select (StringStateSetter > SetState (String))
In the *Newly Created Textbox* type “Inside”
Save the scene
Setup - Storyflow
Open Storyflow and select the Catalogs tab
Select the *Three Bullet List* icon on the right side of the screen (Reference Image Below)
Next, select New Enum Name and type “Plank Position”
After that, hit the > left of where it reads Plank Position and then select New Enum Item Name then type “Inside”
Do this a second time but type “Outside”
If you do not have a “Named Object” catalog already, select (Create > Select Type > Named Object > (Type a name) > Create)
Open your “Named Object“ catalog then select (+ > Named Anchor > (Type in “Stud”) > Save)
Save the catalog
If you do not have a “Behaviour Model” catalog already, select (Create > Select Type > Behaviour Model > (Type a name) > Create)
Open your “Behaviour Mode“ catalog then select (+ > Behaviour Model > (Type in “Stud Behaviour Model”))
Then select (States + > (Type in “Plank Position”))
Expand the Primitive dropdown menu and change it to Enum
After that, expand the NOT SET dropdown menu and select Plank Position
Save the catalog
Open the Scenarios tab and select (+ Add a New Script > (Type a name) >
Checkmark > (Newly Created Script))Under Resources on the right side of the screen click and drag the “Scene Object” resource into
the grey area in the center of the screenSelect (Object + > (Your Named Object catalog) > Stud)
In the same grey area mentioned before put the “Behaviour Model” resource there
Select (Targets + > Stud)
Then, select (Behaviour Model > (Your Behaviour Model catalog) > Stud Behaviour Model)
Select the + sign attached to the “Main Frame” on the left side of the screen
Select the newly created frame and in the same grey area mentioned before put the
“Set Object State” resource thereSelect (World Objects + > Stud)
Then, select (Behaviour Model > (Your Behaviour Model catalog) > Stud Behaviour Model)
Select (CHOOSE STATE > Plank Position > Compare +)
In the new Value dropdown list select Outside
Next, select the blue + icon on the bottom right of the Set Object State resource, scroll down the list that appears and select Close
In the newly created frame add the “Notification” resource and under Message type “Outside”
Again, select the + sign attached to the “Main Frame” on the left side of the screen
Select the newly created frame and in the same grey area mentioned before put the
“Set Object State” resource thereSelect (World Objects + > Stud)
Then, select (Behaviour Model > (Your Behaviour Model catalog) > Stud Behaviour Model)
Select (CHOOSE STATE > Plank Position > Compare +)
In the new Value dropdown list select Inside
Next, select the blue + icon on the bottom right of the Set Object State resource, scroll down the list that appears and select Close
In the newly created frame add the “Notification” resource and under Message type “Inside”
Select Save on the top left of the screen
Next, select the Project tab on the top of your screen then go (Create > Script + >
[Project name] Scripts > (Your new script) > Title > (Type a new scenario title) >
Save)
You can now open your Unity project select the newly created scenario, once it has loaded you should be able to grasp the Stud from the workbench slide it to the left and read your new Notifications!