Getting Started with Interaction SDK

• Set Up Unity for XR development to create a project with the necessary dependencies
• Set up your device to configure and test your project on a headset

1. Ensure you are logged into the same Unity account in both Unity Hub and the Unity website.
2. Navigate to the Meta XR Interaction SDK on the Unity Asset Store.
3. Select Add to My Assets.
4. From the Unity Editor, select Window > Package Manager to view your installed packages.
5. Navigate to My Assets in the Package Manager, select Meta XR Interaction SDK, and click Install.
6. Confirm that you see the Meta XR Interaction SDK folder in the Packages directory.

1. From the Package Manager, select Meta XR Interaction SDK and then select the Samples tab.
2. Click Import next to each sample you want to import.
   

1. Navigate to Meta > Tools > Project Setup Tool.
2. In the checklist under the Android icon tab of the Project Setup Tool, select Fix All.
3. If you still see Recommended Items in the list, select Apply All.
   

1. Delete the default Main Camera if it exists since since Interaction SDK uses its own camera rig.
2. Right click on the Hierarchy and select the Interaction SDK > Add OVR Interaction Rig Quick Action.
   
3. If you have an OVRCameraRig in the scene, it will appear referenced in the wizard, click Fix All if there is no camera rig so the wizard creates one.
   
4. If you don’t need smooth locomotion in your scene, disable the Smooth Locomotion option or your camera might fall infinitely when starting the scene if there is no ground collider present.
5. In Unity its not possible to save modifications to a rig prefab in a package folder directly, but Unity 2022+ can create a copy of the prefab for you to overwrite as needed. Select Generate as Editable Copy and set the Prefab Path to store a intermediary copy of the rig prefab so you can store as many overrides as needed.
6. If you want to further customize the rig, adjust the settings in the wizard. For details on the available options, please see the OVR Interaction Rig Quick Action documentation.
7. Click Create to add the OVR Interaction Rig to the scene.
   
8. In the Hierarchy, select the OVRCameraRig.
9. On the Inspector tab, go to OVR Manager > Quest Features, and then on the General tab, in the Hand Tracking Support list, select Controllers and Hands, Hands Only or Controllers only depending on your needs. The Hands Only option lets you use hands as the input modality without any controllers.

1. In the Project panel, navigate to the Packages > com.meta.xr.sdk.interaction > Runtime > Sample > Objects > UISet > Prefabs > Backplate folder and add a backplate for the UI by dragging the EmptyUIBackplateWithCanvas prefab to the Hierachy panel.
   
   The backplate prefab contains a Canvas, a background for the UI, some basic layout components, and ray and poke interactable components to enable direct touch and raycast interactions with the UI.
   
2. In the Hierarchy, select the CanvasRoot. In the Inspector, under Rect Transform, you can use the Width and Height properties to set the size of the Canvas. In this example, we have use the following settings to scale it to a reasonable size for a few components:
   • Rect Transform > Width: 500
   • Rect Transform > Height: 250
3. In the Hierarchy, select the UIBackplate. In the Inspector, under Rect Transform, set the set the Width and Height properties to match the canvas width and height set in the previous step. In this example, we have use the following settings to match the canvas size:
   • Rect Transform > Width: 500
   • Rect Transform > Height: 250
4. Add some UI elements to the panel to interact with by dragging and dropping prefabs from the Packages > com.meta.xr.sdk.interaction > Runtime > Sample > Objects > UISet > Prefabs folder. For example, in the Buttons > UnityUIButtonBased folder, drag the PrimaryButton_IconAndLabel_UnityUIButton prefab to the UIBackplate object in the Hierarchy. The button element appears on the UI. Add as many elements as you desire to create your UI.
   

1. Right-click on the Canvas object for your UI and select Interaction SDK > Add Grab Interaction. The Grab wizard appears.
   
2. In the Grab wizard, select Fix All to fix any errors. This will add missing components or fields if they’re required.
   
3. If you want to further customize the interaction, adjust the interaction’s settings in the wizard. For details on the available options, please see the Grab Quick Action documentation.
4. Select Create. The wizard automatically adds the required components for the interaction to the GameObject. It also adds components to the camera rig if those components weren’t already there.
   

1. Open the Link desktop application on your computer.
2. Put on your headset, and, when prompted, enable Link.
3. On your development machine, in Unity Editor, select the Play button.
4. In your headset, you can interact with the UI directly or at a distance using ray-casting. The UI can be moved around by grabbing it.

1. Make sure your headset is connected to your development machine.
2. In Unity Editor, select File > Build Settings. Add your scene to the Scenes In Build list by dragging it from the Project panel or clicking Add Open Scenes.
3. Click Build and Run to generate an .apk and run it on your headset. In the File Explorer that opens, select a location to save the .apk to and give it a name. The build process may take a few minutes.
4. In your headset, you can interact with the UI directly or at a distance using ray-casting. The UI can be moved around by grabbing it.

• To learn about the key concepts in Interaction SDK, see the Architecture Overview.
• For alternative setup methods, see Getting Started with Interaction SDK and Unity XR.