manualshive.com logo in svg

HTC VIVE Wrist Tracker, Developer Manuallines

Share
Download
HTC VIVE Wrist Tracker Developer Manuallines Download Page 9

 

 

VIVE Wrist Tracker 

 

HTC Corporation

 

Developer Guidelines 

v1.1 

2022/3/24 

 

6 

       

HTC Confidential and Proprietary

 

 

The  following  illustration  shows  the  FOV  of VIVE Wrist  Tracker  when  attached to  a  VR 
gaming peripheral, in this case an imitation firearm. If the mounting base extends beyond 
the recommended placement area, the tracker’s FOV will be blocked by the body of the 
accessory. 
 

 

 

Figure: Mounting base extends beyond recommended placement area 

 
For optimal tracking performance, we recommend attaching the tracker to the accessory 
so that the Power button faces the headset.    

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Summary of Contents for VIVE Wrist Tracker

Page 1: ...HTC VIVE Wrist Tracker Developer Guidelines Ver 1 1 ...

Page 2: ...itial version 1 1 2022 03 30 Content update 2019 HTC Corporation All Rights Reserved HTC the HTC logo VIVE the VIVE logo and all other HTC product and services names are the trademarks or registered trademarks of HTC Corporation and its affiliates in the U S and other countries ...

Page 3: ...RF 3 Power 4 Optics 4 Mounting 8 Mechanical specifications 12 Dimensions and weight 13 Mounting base assembly 15 Software 17 Accessory integration 17 System requirements 19 Data formats 19 Unity integration 22 Setting up Unity for content creation 23 Configuring the VIVE Input Utility VIU 27 FAQs 32 ...

Page 4: ...acker can also be attached to a peripheral accessory for object tracking When used for object tracking VIVE Wrist Tracker transmits tracking data just as it does when used to assist hand tracking In addition the accessory can also be connected to VIVE Wrist tracker through its USB interface to obtain additional data from the accessory which can then transmit the additional data to VIVE Focus 3 alo...

Page 5: ...st Tracker is paired wirelessly with VIVE Focus 3 to transmit tracking data Figure Use case 2 Use case 3 VIVE Wrist Tracker is attached to an accessory for object tracking In addition in this scenario the accessory is also connected to VIVE Wrist Tracker via USB allowing the accessory to send additional data to VIVE Wrist Tracker which can then transmit the additional data to VIVE Focus 3 along wi...

Page 6: ... is compatible with VIVE Focus 3 Interface 1 USB Type C port USB 2 0 Full Speed client 2 Buttons Power button Powers the tracker on and off App button Defined by developer Radio frequency RF To ensure the stability of the wireless connection between VIVE Wrist Tracker and VIVE Focus 3 the OTA performance of the tracker must not degrade by more than 3 dB an accessory is attached Please adhere to th...

Page 7: ... hours Optics VIVE Wrist Tracker has an asymmetrical shape Therefore its FOV is also asymmetrical In addition VIVE Focus 3 uses inside out tracking so the FOV of the tracker depends on the position of the headset relative to the orientation of the tracker The following figures illustrate the FOV of VIVE Wrist Tracker in relation to VIVE Focus 3 when the headset is about 50 cm away from the tracker...

Page 8: ...l and Proprietary Figure Tracker FOV relative to headset position along the transverse plane The headset must stay within the FOV of the tracker during operation In addition make sure there aren t any objects between the tracker and the headset as this will interfere with object detection ...

Page 9: ...d to a VR gaming peripheral in this case an imitation firearm If the mounting base extends beyond the recommended placement area the tracker s FOV will be blocked by the body of the accessory Figure Mounting base extends beyond recommended placement area For optimal tracking performance we recommend attaching the tracker to the accessory so that the Power button faces the headset ...

Page 10: ...rietary To maintain optimal tracking performance make sure the gray area illustrated in the following figure remains exposed during operation Do not attach objects to it or cover it with any materials Figure Exposed area gray and contact area of VIVE Wrist Tracker when attached to an accessory blue ...

Page 11: ...he tracker should be easy to attach and detach with two hands that is with one hand holding the tracker and the other holding the accessory c The user should not be at risk of physical harm while attaching or detaching the tracker d Attaching or detaching the tracker should not cause the user any discomfort e To prevent unintended damage to the tracker the tracker should not come into contact with...

Page 12: ...cessories such as imitation gaming weapons and safety equipment The imitation gaming firearms depicted are equipped with a Picatinny rail which can be used as a mounting interface VIVE Tracker can be mounted to a Picatinny rail using a rail mount type mounting base CAD drawings of the VIVE Tracker rail mount are available to developers Contact us for more information Imitation firearms mounting in...

Page 13: ...VIVE Wrist Tracker HTC Corporation Developer Guidelines v1 1 2022 3 24 10 HTC Confidential and Proprietary The following two figures show the schematics for the accessory mounting rail Picatinny rail ...

Page 14: ...g weapons The mounting interface should be as close as possible to the grip area of an edged gaming weapon The length of the gaming weapon should be defined in the VR program Fire extinguisher When VIVE Wrist Tracker is attached directly to a grip the tracker s FOV must be free from your hands and other objects during operation ...

Page 15: ...oper Guidelines v1 1 2022 3 24 12 HTC Confidential and Proprietary Mechanical specifications The following specifications may be useful for determining the compatibility of VIVE Wrist Tracker with various accessories Figure VIVE Wrist Tracker ...

Page 16: ...rporation Developer Guidelines v1 1 2022 3 24 13 HTC Confidential and Proprietary Dimensions and weight Figure Front side and back views of VIVE Wrist Tracker The tracker measures 86 9 mm L 45 0 mm W 58 8mm H and weighs 48 1 g ...

Page 17: ... Power button For powering the tracker on and off 3 App button Defined by content 4 Mounting mechanism 4 1 Metal pin for fastening accessories 4 2 Friction pad for preventing slippage between the tracker and an accessory 5 USB C port For connecting the tracker to an accessory 5 USB C port 3 App button 1 LED indicators 4 1 Metal pin 4 1 Metal pin 2 Power button 4 2 Friction pad ...

Page 18: ... to attach a mounting base to VIVE Wrist Tracker CAD files for the mounting base are available to developers Contact us for more information Figure Mounting base assembly Make sure to install the mounting base on VIVE Wrist Tracker before attaching the tracker to the mounting interface on the accessory Mounting base Metal pin screw Metal pin screw Metal pin Metal pin ...

Page 19: ...VIVE Wrist Tracker HTC Corporation Developer Guidelines v1 1 2022 3 24 16 HTC Confidential and Proprietary Metal pin dimensions The following schematic shows the dimensions of the metal pins Unit mm ...

Page 20: ...ils on the types of software applications that can be used for development see the Accessory integration and Unity integration Accessory integration This section provides information on position transformation between an accessory and VIVE Wrist Tracker Content developers can determine the correct rotation and translation result of the content developed for the accessory in a game engine such as U...

Page 21: ...s Dx Distance between the center of the accessory and tracker along the x axis Dy Distance between the center of the accessory and tracker along the y axis Dz Distance between the center of the accessory and tracker along the z axis Content developers can use these parameters to transform the tracker pose into an accessory pose with the following equations Assuming the tracker rotation matrix is R...

Page 22: ...ies must be able to send data to VIVE Wrist Tracker via the HID protocol As an HID device the hardware accessory will send the data to the tracker through a USB HID Feature Report the tracker will use to interpret the data The data transfer interval should be longer than 10 ms To learn more about USB HID specifications visit https www usb org hid In addition the VID PID USB combination for VIVE Wr...

Page 23: ...1 1 2022 3 24 20 HTC Confidential and Proprietary Code samples The following code samplescan be used to send the setFeature command to VIVE Wrist Tracker However your system must be able to reference the correct API in order to send the USB setFeature command ...

Page 24: ...n of the data being sent out In this version the default value is zero 1 Button TRIGGER 0x01 BUMPER 0x02 MENU 0x04 STEAM 0x08 PAD 0x10 PAD_FINGERDOWN 0x20 Reserved 0x40 Reserved 0x80 2 Pad X value 32768 to 32767 BYTE 2 is LSB 3 4 Pad Y value 32768 to 32767 BYTE 4 is LSB 5 6 Trigger Raw Value 0 to 65535 BYTE 6 is LSB 7 8 Reserved 9 Reserved 10 Reserved 11 Reserved Table VIVE Wrist Tracker accessory...

Page 25: ...ate VIVE Wrist Tracker when developing VR content First you need to pair VIVE Wrist Tracker with VIVE Focus 3 After pairing the input type icon on the VIVE Focus 3 system dashboard will indicate that VIVE Wrist Tracker is connected Figure VIVE Wrist Tracker is added in VIVE Focus 3 We recommended using use Unity 2019 4 3 or later You can download it at https unity3d com get unity download ...

Page 26: ...4 23 HTC Confidential and Proprietary Setting up Unity for content creation Perform the following steps to start creating content for VIVE Wrist Tracker in Unity 1 Configure your Build Settings a Go to File Build Settings and then select Switch Platform b Select Android ...

Page 27: ...der XR Plug in Management click the Android tab c Under Plug in Providers select Wave XR d Under Wave XR Essence click Import Feature Tracker Model e Under Player Other Settings Identification set the API level 3 Add AndroidManifest xml to your configuration a Go to Wave HandTracking and confirm that EnableHandTracking is selected This setting will modify AndroidManifest xml ...

Page 28: ... the following configurations manually uses feature android name wave feature tracker android required true uses feature android name wave feature handtracking android required true 4 Enable scripts for your scene a Go to Assets Wave Essence Tracker Model 4 2 90 preview 2 Demo Bracelet b Make sure Hand Manager Script and Tracker Manager Script are selected for the HandManager object Note If you ne...

Page 29: ...nes v1 1 2022 3 24 26 HTC Confidential and Proprietary 5 Build the Android APK a Go to Edit Project Settings Player set the Product Name and Other Settings Identification Override Default Package Name Package Name b Under File Build Settings click Build ...

Page 30: ...nd Proprietary Configuring the VIVE Input Utility VIU Perform the following steps to configure the VIVE Input Utility VIU plugin for your project 1 Configure VIU settings a Go to Edit Preferences and then click Add Wave XR Plugin Note If the platform is not set to Android click Switch Platform ...

Page 31: ...VIVE Wrist Tracker HTC Corporation Developer Guidelines v1 1 2022 3 24 28 HTC Confidential and Proprietary b Select Wave XR ...

Page 32: ...VIVE Wrist Tracker HTC Corporation Developer Guidelines v1 1 2022 3 24 29 HTC Confidential and Proprietary c Select Update Wave XR Plugin Native ...

Page 33: ...etary Note Make sure both Enable Wave Hand Tracking Support and Enable Wave Tracker Support are selected 2 Configure your scene a Go to File New Scene b Add the ViveCameraRig prefab to your scene and then remove Main Camera ViveCameraRig will be added to Assets HTC UnityPlugin ViveInputUtility Prefabs ...

Page 34: ...r HTC Corporation Developer Guidelines v1 1 2022 3 24 31 HTC Confidential and Proprietary Your hands and the wrist trackers will now be visible in VR Note The default hand and tracker VR models for VIU will appear white ...

Page 35: ...de it s paired on Solid green Tracker is paired Blinking red Battery is low Blinking blue Tracker being paired with the headset Solid blue The tracker is connecting to the headset Solid orange Charging 4 How do I update VIVE Wrist Tracker If a firmware update for VIVE Wrist Tracker is available the Update firmware button will appear on the Controller screen Select the button to start the firmware ...

Page 36: ...e coordinate settings are different VIVE Wrist Tracker will need to be recalibrated 3 Do the VIVE Wrist Tracker hardware buttons correspond to any VIVE Focus 3 controller buttons The Power button corresponds to the VIVE Menu buttons and the App button corresponds to the A X buttons Type No Question Answer Hardware 1 What is included in the VIVE Wrist Tracker CAD files The compressed CAD file packa...

Reviews:

No comments

Brands by name

Popular brands

Load more brands