Make Attachable / Using Attachable Receivers

Overview

This article describes how you can implement Motive’s premade Attachable components in order to make two objects interact with one another in a VR scene. One object will be able to be grabbed and then subsequently placed on the receiver object. This tutorial will also include information on how to use this functionality in combination with Storyflow.

Important: Any object that will be used as part of a training procedure authored in Storyflow must be a Motive Scene Object.

Setup - Unity SDK

1. Open your Unity project and in the scene Hierarchy window find “Hammer” (World > Example Assets > Props > Workbench > Hammer)

2. Right-click on the Hammer then select (Motive > Make Attachable)

3. In the Hammer Inspector window scroll down until you find the VR Attachable component

   1. Scroll to the bottom of the component and expand the Attaches To dropdown list

   2. Increase the Size to 1

   3. Element 0 will appear, and from there you need to expand it and under Type write “Test”

4. In the scene Hierarchy window find “Stud” (World > Example Assets > Props > Workbench > Stud > Stud)

5. Right-click on the Hammer then select (Motive > Make Attach Receiver)

6. In the Stud Inspector window scroll down until you find the VR Attachable Receiver component

   1. Scroll to the bottom of the component and expand the Receivers dropdown list

   2. Increase the Size to 1

   3. Element 0 will appear, and from there you need to expand it and under Type write “Test”

   4. Change Max Attachments to 1

   5. A bit higher in the component toggle Attach to Surface to on

7. Save the scene

Setup - Storyflow

1. Open Storyflow and select the Catalogs tab

2. If you do not have a “named Object” catalog already, select (Create > Select Type > Named Object > (Type a name) > Create)

3. Open your “Named Object “ catalog then select (+ > Named Object > (Type in “Stud”) > Save)

   1. Do this twice but for the second object write “Hammer”

4. Save the catalog

5. Open the Scenarios tab and select (+ Add a New Script > (Type a name) >
   Checkmark > (Newly Created Script))

6. 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 screen

   1. Select (Object + > (Your Named Object catalog) > Stud > Save

      1. Do this twice but for the second object select Hammer

7. Select the + sign attached to the “Main Frame” on the left side of the screen

8. Select the newly created frame and in the same grey area mentioned before put the
   “Place” resource there

   1. Place can be typed into the Resource search bar for easy access

9. Select the drop-down menu under World Objects and select Hammer

10. Select the drop-down menu under Targets and select Stud

11. Select the drop-down menu under Event and select Complete then select the + icon right of the drop-down menu

12. In the newly created frame and in the same grey area mentioned before put the
    “Notification” resource there

13. Under Message type “Great work”

14. Select Save on the top left of the screen

15. 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, grab the hammer from the backside of the workbench and place it onto the wooden stud on top of the workbench!

(If you can’t reach the Hammer remember you can teleport by pressing forward on your remote joysticks)