title: Getting Started with Interaction SDK
description: Explains how to install and set up the Interaction SDK, a library of components for adding controllers and hand interactions to VR apps.
tags:
- unity
- all_in_one_vr
- quest
last_updated: 2025-03-20
This tutorial explains how to install and set up the Meta XR Interaction SDK for an Unity project using the
OpenXR Plugin.
Note
Interaction SDK users can ignore the Set up Hand Tracking tutorial. It's obsolete if you're using the SDK.To download and import the Meta XR Interaction SDK:
Select Add to My Assets to add the package to your Unity account’s assets.
Select Open in Unity to open the Package Manager window in the Unity Editor.
Enter Unity credentials if prompted.
In the Package Manager window, in the upper-right side of the window, select Install to install the SDK.
Note: When you install the Meta XR Interaction SDK in a project, Unity will also import and install the required dependencies.
Install the OpenXR provider plugin
For projects built on Unity 6+ that use Meta XR SDKs v74+, install the Unity OpenXR Plugin.
To install the OpenXR provider plugin:
- Open any 3D project in the Unity Editor (2022.3.15f1 or higher; Unity 6+ is recommended).
- From the top menu of the Unity Editor, navigate to Edit > Project Settings to open the Project Settings window.
- Select XR Plug-in Management in the Project Settings window.
- If XR Plugin Management is not installed, select Install XR Plugin Management.
- In the Windows, Mac, Linux settings tab, select OpenXR.
- In the Android settings tab, select OpenXR.
- Close the Project Settings window.
- From the top menu of the Unity Editor, navigate to Windows > Package Manager to open the Unity Package Manager window.
- At the top left of the window, select Packages: and change the selection to Packages: In Project.
- In the list of packages in the left menu, verify that there is a check mark beside the Unity OpenXR Plugin, indicating that the package is installed.
If you chose the standalone packages, the packages you need to install are:
- Meta XR Interaction SDK Essentials
- Meta XR Interaction SDK
If you chose the All-In-One SDK, the package you need to install is:
- Meta XR All-in-One SDK
If you chose Unity XR, the packages you need to install are:
- Meta XR Interaction SDK Essentials
- [Unity XR Hands](https://docs.unity3d.com/Packages/com.unity.xr.hands@1.4/manual/index.html) v1.4 or newer
Each package's folder appears in the **Project** window under **Packages** once it's installed.
- Samples are available in both Interaction SDK packages.
- For the Meta Interaction SDK OVR Samples, in the Package Manager select the Meta XR Interaction SDK package and then on the right side of the window, select the Samples tab.\
- If you have Unity XR setup, For the Meta Interaction SDK Unity XR Samples, in the Package Manager select the Meta XR Interaction SDK Essentials package and then on the right side of the window, select the Samples tab.
Click the three Import buttons to import the sample scenes into your project.
The Unity Project Setup Tool optimizes Android project settings for Meta Quest Unity apps, including texture and graphics settings. The tool applies the required settings for creating Meta Quest XR apps, including setting the minimum API version and using ARM64.
Navigate to Meta > Tools > Project Setup Tool.
In the checklist under the Android icon tab of the Project Setup Tool, select Fix All.
If you still see Recommended Items in the list, select Apply All.
In Interaction SDK, the rig is a predefined collection of GameObjects that enable you to see your virtual environment and initiate actions, like a grab, a teleport, or a poke. The rig is contained in a prefab called
OVRInteractionComprehensive, it requires a working camera-rig, and will add support for hands,
controller driven hands, and controllers to your scene.
Instead of manually adding these prefabs to the scene, using Interaction SDK “Quick Actions” is recommended since it will find or add any missing dependencies such as the camera-rig. You can read a more advanced guide about how to use this rig in
Use Cameraless Rig Prefab.
In your Unity scene, delete the default Main Camera and Global Volume GameObjects from the Hierarchy, since the SDK uses its own camera rig.
The Hierarchy should now be empty except for the Directional Light GameObject.
- Right click on the Hierarchy and select the Interaction SDK > Add OVR Interaction Rig Quick Action.
- If you have an OVRCameraRig in the scene, it will appear referenced in the wizard, click Fix if there is no camera rig so the wizard creates one.
- In the Hierarchy, select the OVRCameraRig.
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.
Prepare to launch your scene by going to File > Build Settings and clicking the Add Open Scenes button.
Your scene is now ready to build.
Select File > Build And Run, or if you have a Link connected, click Play.
The scene loads. The world is completely empty, but if you raise your hands or controllers, they should appear in front of you.
(Optional) Set up controller driven hands In the Hierarchy, select OVRCameraRigInteraction > OVRCameraRig.
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 or Hands Only option. The Hands Only option lets you use hands as the input modality without any controllers.
Use
Link to test your project.
- Open the Link desktop application on your computer.
- Put on your headset, and, when prompted, enable Link.
- On your development machine, in Unity Editor, select the Play button.
- In your headset, you can interact with the 3D object in your app.
Add some GameObjects and make them interactable with
Quick Actions.
