Meta Developers

Remember how to access learning material such as in-app tutorials, video tutorials, and example projects to guide you through the basics of haptic design.
Understand how to create your first project and access example projects.

Haptic design

Designing haptics is a relatively new field for most creators, application, and game developers. To help you get started, we’ve curated diverse learning resources introducing you to the editor and the world of haptic design. On the Haptics Studio Desktop home screen, click the Learning tab to navigate to the Learning section.

In-app tutorials

Our in-app tutorials are designed to guide you through the fundamental concepts of haptic design in an interactive way. To get the most out of our tutorials, make sure your headset is connected and ready to go. By doing this, the tutorial can seamlessly sync with your headset, allowing you to test and experience the haptics in real-time. Simply put on your headset, trigger one of the clips, and verify that everything is working as expected. If you encounter any issues, refer to the troubleshooting guide. As you proceed through the tutorials, your progress will be tracked, allowing you to pick up where you left off at any time. The panel on the left displays the content and guides you step by step through the different concepts. Each topic has Next and Back buttons to continue forward or go backward.

The tutorials cover the following topics:

Amplitude modulation: how changing the amplitude of a haptic clip can vary its intensity on the skin.
Frequency modulation: how changing the frequency of a vibration can alter the vibration feedback from a soft rumble to a sharp buzz.
Emphasis Points: how using sharp emphasis parameters can create short succinct clicks.
Creative analysis: how you can use the built-in parameters of our audio analysis to quickly make significant changes to the haptic experience.

Learning resources

For a more visual approach, our tutorials on YouTube cover topics such as the haptic design workflow and advanced editing techniques. Explore our GitHub repository for example projects that demonstrate best practices and creative applications of haptic design. Additionally, explore our haptic design guidelines and best practices to further enhance your skills and knowledge.

Set up Meta Haptics Studio

Windows

Download Meta Haptics Studio for Windows from the Meta Quest Downloads page.
Unzip the file.
Run Meta Haptics Studio.exe. Studio will run after the installation is complete.
When Meta Haptics Studio runs for the first time, Windows Defender will ask for permissions to allow the application to access the network. Check all of the boxes to allow communication with your VR headset over the local area network.

Mac

Download Meta Haptics Studio for Mac from the Meta Quest downloads page.
Unzip the file.
Open Meta Haptics Studio.dmg.
Drag and drop Meta Haptics Studio.app to the Applications folder.
Open the Meta Haptics Studio application from the Applications folder.

Next, either create your first haptic clip, start the tutorial, or browse our haptic library.

Set up VR Companion App

In order to audition haptics on your Quest device, you need to install the VR Companion app onto your headset.

Note: Your data is only sent directly between the Haptics Studio Desktop and VR application via Wi-Fi. It is never shared or uploaded to the cloud.

Finish the installation of Haptics Studio Desktop on your Mac or PC and open the app.
Click the headset icon on the top right, this will open the connection panel.
Click Open Meta Store
Install the VR Companion app.
Launch the app on your headset.
To connect the VR App and Desktop Application, make sure both your computer and headset are connected to the same network. For best results, you should disable your VPN connections and firewalls temporarily as they can interfere with the auto discovery.
On your headset, in the connection assistant on the left hand side you should find your computer by name. Select it and click Connect. You will be prompted for a 4 digit code.
On your Desktop, the Connection Panel should now display the 4 digit code.
Enter this code in the VR Companion app. If you want the pairing state to persist, please make sure the Remember Device switch is turned on before you select the Connect button.

Tip: If your headset is connected via USB and in Developer Mode, you can switch HMD Sleep Mode on or off using the toggle button. This will prevent your HMD from falling asleep and disrupting your workflow.

The connection should now be established. You can check the connection status at the headset icon on the top right of Haptics Studio Desktop.

Creating your first project

Starting with an example project

To get you started quickly, you can find example projects containing curated haptic clips based on Oculus Audio Pack content. You can access these example projects on the Home Screen in the project section. The haptic clips are free to use and licensed under Creative Commons, providing a great resource for you to learn how to achieve different types of effects.

Starting a new project

In Meta Haptics Studio, haptic effects are created by converting your audio files into haptic experiences. Projects in Haptics Studio can contain either a single haptic clip or multiple haptic clips.

Start a New Project: On the home screen of the Haptics Studio Desktop, click ‘New project’.
Import Audio Files: Locate and open existing audio files (.wav, .ogg, .mp3) that you want to use as the basis for your haptic designs. If you don’t have any audio files, you can download the Oculus Audio Pack to use as example content.
Audio Analysis and Haptic Generation: Once an audio file is imported, the Haptics Studio desktop app automatically analyzes the audio and generates haptic effects from it.
Note: If the audio file is multichannel, it will be automatically down-mixed to mono to create a single haptic clip. If you prefer to generate haptics for each channel separately, you should split the channels before importing.
Haptic Envelopes: After the haptic effects are generated, you will see two main curves representing the “Amplitude” and “Frequency” envelopes of the haptic experience. These envelopes can be viewed and switched between using a toggle in the top bar of the interface. To deepen your understanding of amplitude and frequency envelopes and their impact on the haptic experience, you can access the Haptics Tutorial from the home screen of the app.

Connect Your Headset: Ensure your headset is connected to be able to audition your creations, check your connection by clicking on the headset icon top right.
Audition the Haptic Feedback: Launch the Haptics Studio VR app on your headset. You can trigger the haptic feedback by pressing the B/Y buttons on your controller or by using the play button within the app.
Note: To streamline your design process, you can audition your haptic designs directly from the desktop app without needing to constantly put on and take off your headset. Simply select a clip in the app and press the trigger on your controller to test your design in real-time.
Design Haptics: In the Haptics Studio desktop application, you can either adjust the analysis parameters or proceed with manual breakpoint editing. You can feel the changes directly on your controllers.
Export Your Haptic Clip: When you are finished designing your haptics, you can export your clips. The exported .haptic files can be integrated into your projects using the Haptics SDK.

VR Companion App

Connect your HMD

To connect your Quest Device to Meta Haptics Studio Desktop, follow the steps described in the above section Set Up.

Homescreen

From the Home screen, you can: Open the currently open project in Studio Desktop App Open one of your Pinned Projects Explore the Haptic sample library

Navigating a project

Use the thumb stick to navigate the clip list on the left. Use B/Y to play a clip. Navigate back to the Home Screen by clicking the back arrow above the project name.

Pinning and unpinning projects

To add a project to your Pinned Projects list, open a project and click the Pin icon next to the project name. This will store your project on the HMD locally without the need for an active connection to Meta Haptics Studio desktop. To unpin a project, open the project from the pinned projects list and click the pin icon.

Export haptic designs

Select the clip(s): Choose the clip or clips you want to export in the clip list.
Export: Go to File > Export Selected or click the ‘Export’ Button at the bottom of the clip list.
Choose file format:
- For Unity or Unreal Engine integration: Select .haptic.
- For iOS integration: Select .ahap. To ensure that your haptic files are optimized for playback on Apple devices, your clip will be exported as two files: TRANSIENTS.AHAP and CONTINUOUS.AHAP. For more information on how to play these files, please refer to the Apple Developer Documentation.
- For other platforms that accept audio waveforms: Select waveform (.wav).
Save location: Choose a location to save the exported file.
To view exported clip(s) on your disk click ‘View files’.

Once you’ve completed these steps, you can integrate the exported files into your game or application using the Haptics SDK (Unity, Unreal).

Grouping clips

To better navigate your clips in a project, you can create groups. Select the clips you want to group and right-click or use the shortcut.

Organizing file using markers

Markers can be used to label and navigate specific points in your project, making it easier to organize and reference important moments. To create a marker, right-click on the playhead or use the shortcut Shift + M. This will create a new marker at the current position of the playhead. You can add a description or name in the right panel, hide or view a marker by clicking the eye icon or delete a marker by clicking the bin icon. When you select a marker in the right panel the playhead will automatically move to that position.

To share your project, click on the share icon on the top right of the editor. This will package your project with all haptics and audio resources as a shareable .zip file. This ensures that all necessary files are included, making it easy for others to work on the project without issues.

Did you find this page helpful?