In this tutorial, you will learn how to use Interaction SDK locomotion interactions to teleport to a location on any collidable object within a specific layer, or set of layers, using your hands or controllers. This allows you to add a collection of colliders to a layer and have them all be used as teleport targets using a single interaction. This guide assumes you have a scene set up with a camera rig configured for interactions and objects added to a layer to be used as targets for teleporting. If you do not have a camera rig set up, you can add one by following the instructions in the Create Comprehensive Rig guide.

Scene with Objects added to a Physics Layer

Add a Physics Layer Teleport Target

To teleport, you need to add a teleport interactable. To enable teleporting to a collection of colliders within the scene using a single interaction, you can use a Physics Layer as the target, which enables the user to teleport to any collidable surface on any object within that layer.

Select the objects you want to be able to teleport to and set the Layer property to the layer you want to use in the teleport interaction. In this example, a new layer named Teleport was created to assign to the objects that should act as targets for teleporting.

Add a new empty GameObject and name it TeleportInfo. This will be the container for the Teleport Interactable for the Physics Layer teleport interaction.

Right-click on the TeleportInfo object and select Interaction SDK > Add Teleport Interaction. The Teleport wizard appears.

In the Teleport wizard, set the Interaction Type to Physics Layer. This will enable you to set a Physics Layer as the target for teleportation.

Select the Physics Layer, or layers, you want to be able to teleport to in the Layer Mask. In this example, the Teleport layer was selected.

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 Teleport Quick Action documentation.

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.

The automatically added GameObjects for a teleport interaction.

Test your Interaction

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.

Tap your thumb against the side of the index or press the joystick forward on your controllers. A ray is emitted from your hands or controllers. Aim it at one or more of the objects in the Physics Layer and either tap your thumb again (if using hands) or release the joystick (if using controllers), to teleport to that location.

Test your Interaction

Build your project into an .apk to test your project.

Make sure your headset is connected to your development machine.

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.

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.