Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

https://vimeo.com/1002592033

View the SteamVR open early access roadmap here

Required Materials

Software

The below software is required for this guide, except those marked as optional:

Installers for the StretchSense SteamVR App can be downloaded from the My Account → Software Downloads section of the StretchSense website.

Description

Version

/wiki/spaces/P/pages/494338050
3.2.0-LITE
Steam Desktop Client
latest
SteamVR
2.7.4
StretchSense Driver Add-On for SteamVR (Included with StretchSense SteamVR App installer)
latest
StretchSense SteamVR App
0.7.0

Hardware

This guide supports the following hardware options:

Gloves

Image

StretchSense Studio Gloves, Pro Studio for Xsens, Pro Studio.
image-20240213-002626.png

XR Trackers (choose one)

Image

2x Vive Tracker 3.0
image-20240213-234159.png

2x Tundra Tracker (includes 2x SteamVR dongles).
We recommend using a Super Wireless Dongle – Tundra Labs with Tundra trackers as this only requires a single USB port.
image-20240213-234339.png

Tracker Mount

Image

2x StretchSense Studio Optical/Universal Mounts
(if using Tundra or VIVE Tracker 3.0)
Screenshot 2024-02-15 142757.png

VR Headsets (choose one)

Image

Vive Pro
image-20240213-003510.png
Vive Pro 2
image-20240213-003534.png
Valve Index (headset only)
image-20240213-003224.png
Other SteamVR & Valve Base Station 2.0 compatible VR headset.
image-20240213-003845.png

Other Required Hardware

Image

3-4x Valve Index Base Station 2.0
(A minimum of 3 base stations are required for optimal tracking performance)
image-20240213-003347.png

This guide assumes you have already setup your VR headset and you have two SteamVR compatible trackers such as VIVE trackers or tundra trackers and are using the Optical/Universal mount that was shipped with your Studio Gloves.

1. SteamVR Tracker Setup

  1. Follow these instructions to assign the trackers role in SteamVR so they can be detected by the StretchSense Driver.

    Screenshot 2024-08-19 150122.png

    In the Steam VR settings select Manage Trackers (see below)

    Screenshot 2024-05-23 140815.png

    For the Left and Right trackers set the Tracker Role set to HELD IN HAND, then set the Hand value to match the glove you have attached the tracker to. Click Close and also close SteamVR Settings.

    Screenshot 2024-06-15 115550.png

  2. Leave SteamVR running in the background.

2. StretchSense Driver Add-On for SteamVR

  1. Go to SteamVR Settings → Startup / Shutdown → Manage SteamVR Add-Ons

  2. Toggle Open Gloves OFF (if installed)

  3. Run the StretchSense SteamVR App installer.

  4. Go to SteamVR Settings → Startup / Shutdown → Manage SteamVR Add-Ons

  5. Check stretchsense is toggled ON.

  6. Restart SteamVR

3. Calibrating StretchSense Controller Emulation App

Configuring Hand Engine

  1. Install Hand Engine v3.2.0-Lite

  2. Open Hand Engine and go to Edit → Settings → Open SDK

  3. Make sure Enabled is switched ON (should be ON by default) and that the following settings are toggled ON:

    1. Streaming Ports: 9400

    2. performer/glove/status: ON

    3. animation/rotation: ON

    4. animation/slider/all: ON

    5. animation/capacitances/all: ON

      Screenshot 2024-08-19 150350.png

  4. Ensure Windows Firewall has not blocked the outgoing connections on port 9400. This is used to communicate with the StretchSense Driver for SteamVR.

Configuring StretchSense SteamVR App

  1. Ensure SteamVR is running.

  2. Launch the StretchSense SteamVR App.

  3. A message should appear, saying that the connection is successful. If it doesn’t, try restarting your PC, then follow steps 1-3.

Calibrating Glove Data

Prior to training or loading a model you must calibrate the glove. This step is currently required each time you start the StretchSense SteamVR App, even if you have already calibrated the glove in Hand Engine. These normalize the range of motion that your hand can perform and sets a baseline for any trained button models.

Always calibrate and train with the trackers mounted to your gloves. This ensures the calibration accurately reflects the additional weight and pull from the mount and trackers.

  1. Click the left hand Calibrate button.

    Screenshot 2024-08-26 163209.png

  2. Move your hand to make the following gestures before the timer runs out. You may need to practice this a few times.

Example Side

Example Front

Gesture

Description

Image (66).jpegImage (67).jpeg

Paddle

Start with this pose. Keep fingers together and straight.

Image (70).jpegImage (71).jpeg

Reach

Splay your fingers outwards to spread them evenly. Reach as far as is comfortable.

Image (68).jpegImage (69).jpeg

Reach + Thumb Curl

Splay your fingers, similar to the Reace pose. Pull your thumb in towards the center of your palm, keeping it close to the palm surface.

Image (73).jpegImage (72).jpeg

Fist

Curl your fingers in to make a fist, keeping them tight against your palm, but don’t squeeze too hard. Curl your thumb over the middle of your index finger.

  1. Repeat for the right hand.

  2. When calibration is complete for both hands, the training and button testing columns will be visible:

    Screenshot 2024-08-26 164524.png

Mounting the Trackers

Use the universal mount and position the trackers to mirror one another as pictured. Other 3D printed mounts that put the trackers in a similar position and orientation will also work.

Additional tracker mounts will be selectable in the near future.

Tundra Tracker Mounting

  1. For Tundra, mount on a diagonal with the tracker USB ports pointing towards the USB port on the glove.

Left Hand

Right Hand

Image (28).jpegImage (27).jpeg
  1. In the StretchSense SteamVR App, select Tundra from the tracker list, then restart SteamVR when prompted to automatically update the tracker offsets in the StretchSense Driver Add-On for SteamVR.

    Screenshot 2024-08-19 155932.png

VIVE Tracker 3.0 Mounting

  1. For HTC Vive Tracker 3.0, mount with the status led pointing away from the fingers.

image-20240726-014046.png
  1. In the StretchSense SteamVR App, select Vive from the tracker list, then restart SteamVR when prompted to automatically update the tracker offsets in the StretchSense Driver Add-On for SteamVR.

    Screenshot 2024-08-19 155948.png

Training a Controller Model in StretchSense SteamVR App

For stability, we recommend training a left-hand model for locomotion / joystick controls and training the right-hand model for shooting/object interaction or toggling/activating running/jumping to allow your virtual character to move and perform actions at the same time.

Always calibrate and train with the trackers mounted to your gloves. This ensures the calibration accurately reflects the additional weight and pull from the mount and trackers.

Training a New Model

After training a few gestures, we recommend saving incremental numbered versions of your model, in case you make a mistake and need to roll back. Good points to save a model are:

  • After initial idle binding.

  • After binding the Grip and LT/RT buttons.

  • After binding the Menu button.

  • After binding the A and B buttons.

  • After binding the 4 Up/Down/Left/Right directional buttons, prior to binding UpLeft/UpRight/DownLeft/DownRight.

  1. Calibrate the Left-Hand Controller and Right-Hand Controllers as described in calibrating glove data.

  2. On a freshly calibrated left hand controller model, for each button on the list click Capture and perform the gestures listed under Training a Right-Hand Controller Model for Interaction.

    Screenshot 2024-08-26 164149.png

Tuning a Previously Trained Model

Models trained between different versions of the StretchSense SteamVR App may fail to load, so you may have to train these again from scratch.

  1. Perform glove calibration for both hands.

  2. Click “Load Model” and select a left-hand model using the file browser.

  3. Click Recapture next to the button to capture an updated gesture. This will add more training data to the original capture to improve the button’s gesture detection and the original training data will be retained.

    Screenshot 2024-08-26 164215.png

  4. Repeat for the right-hand.

You can refine and improve a trained model over a few SteamVR sessions by taking the Studio Gloves off, recalibrating in the StretchSense SteamVR App, then loading the model and checking for flickering between detected buttons. Make any adjustments by capturing gestures or the idle pose to refine the “sweet spot” for each button. Eventually you’ll get a robust model that works consistently for your hand.

Training a Left-Hand Controller Model for Locomotion & Joystick Controls

We recommend configuring your in-game controls to perform forwards/backwards movement on the left hand up/down stick direction and have the left/right movement of stick control strafing. You will have greater precision by using your entire body to turn in game while using StretchSense gloves. We recommend training only 4 directions first, then training the additional directions to bring the total to 8 when you are comfortable with using the gloves. If also training other buttons on this hand these may impact how accurate the directional buttons can be.

Pose

Name

Description

d-idle.png

Idle

Make the horns gesture, then move your thumb straight up. This represents the centered position of joystick.

d-up.png

Up

Make the horns gesture 🤘 with your thumb forward, parallel to your index finger. This is the most important gesture to have reliable as this is used for the forward direction in smooth locomotion or teleportation in SteamVR Home. Since you will make this gesture a lot, it should be comfortable to perform.

d-left.png

Left

Make the horns gesture 🤘 with your thumb pulled towards the left side of your hand, away from your palm.

d-right.png

Right

Make the horns gesture 🤘 with your thumb pulled towards the right side of your hand, towards your palm.

d-down.png

Down

Make the horns gesture 🤘 with your thumb curled in, with your knuckle arching up and the tip pressing towards middle of your middle finger. This direction is not used often as it is a fatiguing pose for the thumb.

interact-idle.png

Idle

Create an additional idle pose. Make a relaxed pose as pictured and move your fingers between being fully extended to a slightly relaxed curled pose. This represents no buttons being pressed.

Training a Right-Hand Controller Model for Interaction

For object interaction using controller buttons, only a subset of gestures is required. In this guide we have left out the A and B buttons and are just focusing on emulating the grip button for holding objects and trigger buttons for interacting with UI.

  1. Train the below interaction gestures:

Pose

Name

Description

interact-idle.png

Idle

Make a relaxed pose and move your fingers between being fully extended to a slightly relaxed curled pose. This represents no buttons being pressed.

grab.png

Grip

Make a finger gun pose with your thumb pointing upwards and your middle, ring and little fingers curled.

Don’t squeeze too hard to avoid overdriving the glove sensors.

trigger.png

RT

Point gesture with thumb pointing upwards. Fully curl in your index finger, as if you were pulling a real trigger.

Avoid squeezing your index finger too hard as it will make it harder to repeat the gesture.

Currently when using the StretchSense SteamVR App, activating RT will cause the grip button to deactivate. To work around this, you will need to adjust the SteamVR controller bindings to change the grip button to be a Toggle Button. To use this, grab the object once to pin it to your hand, then use RT to activate the held object.

menu.png

Menu

Touch your little finger to your thumb, with your thumb resting on the middle part of your little finger. Keep your other fingers extended. This gesture activates the SteamVR Dashboard. Train it so it can be pressed accurately. You may need to go back and train the idle pose again to stop it accidentally triggering.

primary-a.png

A Button / Primary Button

Touch your middle finger to your thumb, with your thumb resting on the middle part of your middle finger. Keep your other fingers extended.

secondary-b.png

B Button / Secondary Button

Touch your ring finger to your thumb, with your thumb resting on the middle part of your ring finger. Keep your other fingers extended.

  1. Repeat the Idle pose to compensate for any outlying data introduced with the other buttons. You may need to repeat these gestures until all gestures can be performed without the button activation state flickering on/off or between buttons or idle.

Exporting a Model

Once you have trained a model for a hand:

  1. Click Export Model

  2. For each hand you will be prompted to select a location on disk to save the current model for that hand as a DAT file.

  3. Give the model a descriptive name (e.g Left Hand D-Pad Trigger) to help remember what buttons the model is trained on when loading it next time.

Save numbered or descriptive versions of these if you need to roll back to a previous model.

You can save and load models optimized for different SteamVR games and SteamVR controller binding profiles. Keep these organized in different folders under C:\Users\USERNAME\AppData\LocalLow\StretchSense\SteamVR App

5. Running SteamVR Games

  1. Start SteamVR and wait for the SteamVR status window to appear. The two StretchSense logos will appear when the StretchSense Driver Add-On has loaded:

    Screenshot 2024-08-19 144730.png

  2. Open the Companion App.

  3. Perform the calibration for both hands.

    Screenshot 2024-08-26 163209.png

  4. Click Load Model to load a compatible model from disk for your game and the correct settings will be automatically applied.

  5. Check the buttons on screen highlight white when making the appropriate gesture.

    Screenshot 2024-08-26 164028.png

  6. Turn on your Tundra or Vive Trackers.

  7. Check the gloves are detected in the SteamVR status window, indicated by two filled StretchSense logos.

    Screenshot 2024-08-19 144758.png

  8. Start your SteamVR compatible game.

  9. Check your in-game hands track correctly.

If you need to restart SteamVR during your play session, click the Reset Connections button in the SteamVR App. Re-connections to Hand Engine are automatic if you need to restart Hand Engine for any reason (make sure to select the gloves in Hand Engine again when you restart).

Screenshot 2024-08-26 164028.png

Validate SteamVR is receiving emulated controller button presses by going to SteamVR → Settings → Controllers → Test Controller

Screenshot 2024-06-24 103347.png

Changelog

Version

Publish Date (YYYY/MM/DD)

Add onboarding video and link to roadmap.

v1.0.1

2024/09/17

Initial version.

v1.0.0

2024/08/26

  • No labels