Search Knowledge Base by Keyword
SpatialStories uses its own camera that automatically handles the XR features from Unity and the toolkit’s functionalities. To benefit from the SpatialStories Camera, all you have to do is convert the standard Main Camera into an Interactive Camera:
For most platforms (Oculus Rift, HTC Vive, ARKit, ARCore), right-click on the Camera in the Hierarchy Tab and select SpatialStories -> Convert into Interactive Camera.
For 3DoF mobile development (ex: Oculus Go) you will find a prefab inside the Resources folder. This camera rig simulates a 3DoF controller and has been fully tested with the Gear VR and the Oculus Go.
If you want to have different visuals for the controllers/hands we provide some alternatives under Resources > CustomHands folder.
Camera (IO): Try not to modify its structure.
- Left/Right Hand Active: defines which hand(s) to use in your experience. Note: a 3Dof camera only has the right hand activated for simulation purposes using an Oculus or a Vive.
- Track Position/Orientation: defines if you want to track your hands’ position and/or orientation. Note: The 3DoF camera has its position tracking disabled to simulate and test the Gear VR controller effect using an Oculus or a Vive.
- Haptic Audio Clip Min/Max: defines which audio clip to use for haptic feedbacks on controllers who support this functionality. Important: Haptics are currently not supported for VR.
Head (IO): The Head contains the camera (see inside Visuals), it is an Interactive Object (IO) that represents the user in any experience.You can change the size of the proximity collider of the Head (IO) which will define the proximity zone of your user. It also contains a Player Torso object. The Torso represents the approximate position of the user’s torso below its head.
You can change the distance between the head and the torso in the inspector.
Left Hand (IO): Represents the left hand of the player. Here you have access to the Teleport and Levitation options where you can tweak the settings for the left hand.
Right Hand (IO): Represents the right hand of the player. Here you have access to the Teleport and Levitation options where you can tweak the settings for the right hand.
Once your camera is converted you will have two elements in your scene that are mandatory for the system to work properly:
Camera (IO): Try not to modify its structure. Inside this object you will find the Head (IO).
Head (IO): it is an Interactive Object (IO) that represents the user in any experience, containing the camera inside its visuals. You can change the size of the proximity collider of the Head (IO) which will define the proximity zone of your user.
Warning: The camera position and rotation should always be at 0, 0, 0; otherwise offsets can occur in your experience.
AR Utilities: This object handles the platform on which you are building. It enables the corresponding elements you need in the scene for ARKit or ARCore to work.
THIS IS A MANDATORY OBJECT, DO NOT REMOVE IT FROM YOUR SCENE. IT ALSO WORKS AUTOMATICALLY, DETECTING THE BUILDING TARGET PLATFORM ON YOUR SETTINGS, DO NOT MODIFY IT MANUALLY.