Develop

Haptics Troubleshooting

Getting support

For any issues, bugs, or feature suggestions, contact haptics-feedback@meta.com. When reporting issues, attach relevant screenshots or logs but avoid including personal information. If you are looking for an older version of Meta XR Haptics SDK, see the instructions on getting it from Meta’s NPM registry.

Gathering logs

How to get logs from the editor The Haptics SDK for UE logs messages to the Output Log window. Reference these logs to get more information when you experience issues. You can filter the logs on your Output Log window to only see the ones from the Haptics SDK. Go to Filters > Categories > LogHapticsSDK and toggle the ShowAll checkbox to hide all other categories.

Gathering logs from Windows executable

The logs from a packaged executable are stored inside the folder containing the generated .exe. You can find the logs in: <YourProjectName>\Saved\Logs\<YourProjectName>.log.

Gathering logs from the headset

Once your headset is connected to your computer by USB cable, you may be prompted to enable Link or allow file access. If prompted, allow file access on the headset. You may need to put on the headset and accept the Allow access to data prompt. Once accepted, the internal storage of the headset will show up in File Explorer, next to the C: drive.
Note: If you see an Enable Quest Link prompt instead, dismiss it and check for a file access notification. You can also enable file transfer by going to Settings > System > Developer on the headset and enabling USB Connection Dialog.
You can find the logs in: Android/data/com.Your.Project.Name/files/<YourProjectName>/<YourProjectName>/<YourProjectName>/Saved/Logs and open <YourProjectName>.log.

Haptics not being triggered in Quest when playing through PCVR

If your OpenXR runtime is not correctly configured, you may not be able to activate haptics on your Quest device. Select an OpenXR runtime to run your built project. If using a Quest device, ensure you are playing through the Meta Horizon Link app and that your OpenXR Runtime provider is set to Meta Horizon Link. Not doing so could lead to unexpected behaviors.
OpenXR runtime configuration dialog for selecting the correct runtime provider.
For non-Quest devices using other runtimes, such as SteamVR, you will need to enable that runtime as your OpenXR runtime.