View source for Face and Eye Tracking (Troubleshooting)/en



<languages/>

<!--T:1-->Resonite Supports face and Eye tracking with the following hardware currently:
* Vive Pro Eye - Eye Tracking
* Vive Facial Tracker - Face Tracking
** This doesn't require a Vive Headset. Users have had success with a variety of headsets and Tape.

<!--T:2-->
If you're having issues with either of these systems please take a look and follow the general advice below.

== Hardware == <!--T:3-->
* Make sure everything is plugged in. If you're unsure unplug and then re-plug all cables. A green or blue light should be present on all items.
* Check all cables are intact and do not look frayed, damaged or kinked.

<!--T:4-->
For non Vive Pro Eye headsets, you may need a USB-C to USB Adapter. These look like this:

<!--T:5-->
[[File:USBC_USBAdapter.jpg|250px|A USB-C to USB Adapter]]

=== Face Tracker Mounting === <!--T:23-->

<!--T:24-->
For non-vive headsets, users have been sharing all sorts of mounting options. A short list of these is supplied below for reference.

<!--T:25-->
* '''Tape''' - Lots of tape and the Tracker sticks quite well. Any tape works.
* '''Double Sided Velcro Tape''' - This provides a removable mounting option. Make sure it is heavy duty so it can support the weight of the tracker and the movement of your head.
* 3D Printing
** '''[https://www.thingiverse.com/thing:4798891 Simple Mount]''' - A simple mount that can be stuck to the bottom of the headset with tape.
** '''[https://www.thingiverse.com/thing:4806854 Friction Mount]''' - A mount that uses friction/clips between the mount and the Valve Index Frunk. This can fail if you are moving your head around too vigorously.
** '''[https://www.thingiverse.com/thing:4807214 Magnetic Mount]''' - Uses the existing Valve Index Frunk Cover's Magnets to stick to the headset. This one will require magnets with the following dimensions: 1/8" dia. x 1/8" thick. Stuck to the print.

== Software == <!--T:6-->
=== Installing the Software ===

<!-- To update, HTC discontinued silently the software and is hard to get now -->
Both Facial tracking and Eye tracking require the same software from HTC. You can download the software from the [https://www.vive.com/setup/facial-tracker HTC Website]. Once downloaded please find it within your Start Menu and run it. Once installed and ran it should place an icon in your system tray(the icons to the right side of your taskbar) which look like this:

<!--T:7-->
[[File:SRAnipal_Icon.png|100px|SRAnipal's System Tray Icon]]

<!--T:8-->
If this icon appears, tracking will usually be functional.

=== Tracking Status === <!--T:9-->
The icon(a robot), also communicates the status of the tracking:
* The Eyes of the robot show the status of Eye Tracking
* The mouth of the robot shows the status of Face Tracking

<!--T:10-->
The color of the eyes or mouth tell you what is happening:
* Black means the tracking is inactive
* Orange means the tracking is idle/standby
* Green means the tracking is active

=== About Window === <!--T:11-->
If you right-click the robot icon, you will see a small menu, selecting about will bring up a window. This window will provide addtional information such as:
* The Software Version
* The Eye Tracker Version
* The Face Tracker Version

<!--T:12-->
If N/A is displayed in the Eye Camera or Lip camera portion it means that the software cannot detect your device. see [[#Hardware| Hardware]] for some troubleshooting steps.

<!--T:13-->
The current version of the software is: '''1.3.2.0'''. However it is recommended to use 1.3.1.1

=== Eye Tacking Calibration === <!--T:14-->
The Vive Pro Eye, needs occasional Calibration to detect your eyes as best as it can. See [https://www.vive.com/us/support/vive-pro-eye/category_howto/calibrating-eye-tracking.html HTC Vive Pro Eye Calibration] for how to do this.

=== Additional Software / Hardware Help === <!--T:15-->
As the Vive Headsets and Facial Trackers are made by HTC, they have their own help sections and support systems. Please see their resources for additional assistance:
* [https://www.vive.com/us/support/facial-tracker/category_howto/tracker.html Facial Tracker HTC Help]
* [https://www.vive.com/us/support/vive-pro-eye/ Vive Pro Eye HTC Help]
* [https://www.vive.com/us/support/vive-pro-eye/category_howto/calibrating-eye-tracking.html HTC Vive Pro Eye Calibration]

== Resonite == <!--T:16-->

<!--T:17-->
Once the software and hardware is setup, you should be able to just run Resonite and everything should work out ok. After Resonite starts and is running in your starting world.

<!--T:18-->
If you have Eye Tracking, the Robot Eyes should be green.
If you have Facial Tracking, the Robot Mouth should be green.

<!--T:19-->
Now, try equipping a Face/Eye Tracking Compatible avatar. You can find the Face Bot in Resonite Essentials -> Avatars -> Face and Eye Tracking Ready. It has full capabilities. Equip it and move your eyes and face around to see.

=== Issues with Resonite === <!--T:20-->
If your tracking is not working in Resonite. Try:
* Ensuring the Robot Icon is in your System Tray
* Restarting Resonite
* Restarting your Computer
* Adding <code>-ForceSRAnipal</code> to your [[Command_Line_Arguments#How_to_use_command_line_arguments| Command Line Arguments]]

<!--T:21-->
If things are still not working. Please [[Frequently Asked Questions#Regular_Log_Files|grab some logs]] and ask in #questions-help forum within the Resonite Discord.

=== Shape Keys and Setup === <!--T:22-->
Once your avatar is working please see the guide on setting up your avatar. TODO: THIS NEEDS TO BE WRITTEN.

<!--T:26-->
[[Category:Troubleshooting]]

{{stub}}