tutorial #1
Description
Surreal Touch: VR Gaming Controller for Apple Vision Pro
Surreal Touch, developed by Surreal Interactive, is a VR gaming controller specifically designed for the Apple Vision Pro. This product aims to bridge the gap between the most immersive hardware and the vibrant VR game ecosystem.
We are dedicated to providing seamless support for developers, enabling them to port their exceptional VR games to this new platform effortlessly. With Surreal Touch, you can bring the most engaging and interactive VR experiences to life on the Apple Vision Pro.
Get Started
In this tutorial, we will introduce how to port an Oculus project to a VisionOS application powered by Surreal Touch.
The Oculus Starter Samples provide a full-functionality scene where players can interact with and throw various game objects, showcasing the system's capabilities.
Step-by-Step Adaptation
To ensure a smooth development experience, we provide the Surreal VR SDK (SVR), designed to offer Oculus developers a plug-and-play experience.
To achieve this, we provide an overview of the one-to-one mapping for controller-related operations:
3-Step Adaptation
To ensure a smooth development experience, we provide the Surreal VR SDK (SVR), designed to offer Oculus developers a plug-and-play experience.
To achieve this, we provide an overview of the one-to-one mapping for controller-related operations:
| Oculus VR SDK | Surreal VR SDK | |
|---|---|---|
| Unity Package | Oculus Unity Documentation | Surreal VR SDK GitHub |
| Camera Rig Prefab | OVRCamRig | SVRCamRig |
| Button Mapping | OVRInput.Get(OVRInput.Button.One) | SVRInput.Get(SVRInput.Button.One) |
| Button Down | OVRInput.GetDown(OVRInput.Button.One) | SVRInput.GetDown(SVRInput.Button.One) |
| Button Up | OVRInput.GetUp(OVRInput.RawButton.X) | SVRInput.GetUp(SVRInput.RawButton.X) |
| Thumbstick State | OVRInput.Get(OVRInput.Axis2D.PrimaryThumbstick) | SVRInput.Get(SVRInput.Axis2D.PrimaryThumbstick) |
| Thumbstick Pressed | OVRInput.Get(OVRInput.Button.PrimaryThumbstick) | SVRInput.Get(SVRInput.Button.PrimaryThumbstick) |
| Thumbstick Up | OVRInput.Get(OVRInput.Button.PrimaryThumbstickUp) | SVRInput.Get(SVRInput.Button.PrimaryThumbstickUp) |
| Index Trigger State | OVRInput.Get(OVRInput.Axis1D.SecondaryIndexTrigger) | SVRInput.Get(SVRInput.Axis1D.SecondaryIndexTrigger) |
| Left Index Trigger State | OVRInput.Get(OVRInput.RawAxis1D.LIndexTrigger) | SVRInput.Get(SVRInput.RawAxis1D.LIndexTrigger) |
| Left Index Trigger Pressed | OVRInput.Get(OVRInput.RawButton.LIndexTrigger) | SVRInput.Get(SVRInput.RawButton.LIndexTrigger) |
| Secondary Gamepad Button Touched | OVRInput.Get(OVRInput.Touch.Two) | SVRInput.Get(SVRInput.Touch.Two) |
Then, step-by-step operations are as follows:
-
Install Surreal Touch Unity package
we suggest follow Install a UPM package from a Git URL, to install package onhttps://github.com/surreal-interactive/SDK.git
-
Replace OVRCamRig with SVRCamRig, to create a game object that accurately mirrors the real-world poses of the controllers.
3.Replace Get related functions from OVR's to SVR's. In this example, we demonstrate how to implement grabbing functionality using button combinations.