HTC VIVE Wrist Tracker Developer Manuallines
  1. Manuals
  2. Brands
  3. HTC Manuals
  4. Video Gaming Accessories
  5. VIVE Wrist Tracker
  6. Developer manuallines

HTC VIVE Wrist Tracker Developer Manuallines

Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
HTC VIVE Wrist Tracker
Developer Guidelines
Ver. 1.1

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the VIVE Wrist Tracker and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for HTC VIVE Wrist Tracker

Summary of Contents for HTC VIVE Wrist Tracker

  • Page 1 HTC VIVE Wrist Tracker Developer Guidelines Ver. 1.1...
  • Page 2 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: Table Of Contents

    Contents Contents ..........................1 Introduction ..........................1 Use cases ............................1 Hardware requirements ......................3 Interface ............................3 Radio frequency (RF) ........................3 Power ............................. 4 Optics ............................. 4 Mounting ............................8 Mechanical specifications ....................12 Dimensions and weight ......................... 13 Mounting base assembly ......................

  • Page 4: Contents

    There are three use cases for VIVE Wrist Tracker. Use case 1: VIVE Wrist Tracker is attached to the wrist to assist hand tracking in VR. In this scenario, VIVE Wrist Tracker is paired wirelessly with VIVE Focus 3 to transmit tracking data.
  • Page 5 HTC Corporation 2022/3/24 Use case 2: VIVE Wrist Tracker is attached to an accessory for object tracking. As with the first use case, in this scenario, VIVE Wrist Tracker is paired wirelessly with VIVE Focus 3 to transmit tracking data.

  • Page 6: Hardware Requirements

    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.

  • Page 7: Power

    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’s geometric center.
  • Page 8 Developer Guidelines VIVE Wrist Tracker v1.1 HTC Corporation 2022/3/24 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 HTC Corporation 2022/3/24 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.
  • Page 10 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) HTC Confidential and Proprietary...

  • Page 11: Mounting

    HTC Corporation 2022/3/24 Mounting Adhere to the following guidelines to ensure your safety when using VIVE Wrist Tracker with an accessory. The specifications of the accessory’s mounting interface must match those of the mounting base attached to the tracker.
  • Page 12 Example mounting interfaces Attaching VIVE Wrist Tracker to VR peripherals is simple and straightforward. The following CAD drawings show examples of how VIVE Wrist Tracker can be mounted to accessories 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.
  • Page 13 Developer Guidelines VIVE Wrist Tracker v1.1 HTC Corporation 2022/3/24 The following two figures show the schematics for the accessory mounting rail (Picatinny rail). HTC Confidential and Proprietary...
  • Page 14 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: Mechanical Specifications

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

  • Page 16: Dimensions And Weight

    VIVE Wrist Tracker v1.1 HTC Corporation 2022/3/24 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. HTC Confidential and Proprietary...
  • Page 17 Developer Guidelines VIVE Wrist Tracker v1.1 HTC Corporation 2022/3/24 Components 3. App button 4.1 Metal pin 4.2 Friction pad 2. Power button 4.1 Metal pin 5. USB-C port 1. LED indicators Figure: Components LED indicators: Indicate pairing status 2. Power button: For powering the tracker on and off 3.

  • Page 18: Mounting Base Assembly

    Metal pin screw Metal pin Metal pin screw Mounting base 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. HTC Confidential and Proprietary...
  • Page 19 Developer Guidelines VIVE Wrist Tracker v1.1 HTC Corporation 2022/3/24 Metal pin dimensions The following schematic shows the dimensions of the metal pins. (Unit: mm) HTC Confidential and Proprietary...

  • Page 20: Software

    This section describes how software can be used to adapt accessories and develop content for VIVE Wrist Tracker. In addition to transmitting tracking data, the VIVE Wrist Tracker can transmit additional data to VIVE Focus 3 USB from an attached accessory through the tracker’s USB Type-C interface.
  • Page 21 Developer Guidelines VIVE Wrist Tracker v1.1 HTC Corporation 2022/3/24 Figure: Example accessory integration of a toy like gun Pitch: Angle of rotation around the x-axis Yaw: Angle of rotation around the y-axis Roll: Angle of rotation around the z-axis Dx : Distance between the center of the accessory and tracker along the x-axis...

  • Page 22: System Requirements

    HTC Corporation 2022/3/24 System requirements To test hardware accessories or VR content with VIVE Wrist Tracker, you’ll need a VIVE Focus 3 in addition to the hardware and software required for your accessory or content. For more information, visit www.vive.com.
  • Page 23 Developer Guidelines VIVE Wrist Tracker v1.1 HTC Corporation 2022/3/24 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 -32768 to 32767 Pad Y value BYTE 4 is LSB Value: 0 to 65535 Trigger Raw BYTE 6 is LSB Reserved Reserved Reserved Reserved Table: VIVE Wrist Tracker accessory for work with VIVE Business Streaming data format HTC Confidential and Proprietary...

  • Page 25: Unity Integration

    HTC Corporation 2022/3/24 Unity integration This section describes how to use the Unity game engine to integrate 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...

  • Page 26: Setting Up Unity For Content Creation

    HTC Corporation 2022/3/24 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.
  • Page 27 Developer Guidelines VIVE Wrist Tracker v1.1 HTC Corporation 2022/3/24 2. Configure your Project Settings. a. Go to Edit > Project Settings. b. Under 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.
  • Page 28 Developer Guidelines VIVE Wrist Tracker v1.1 HTC Corporation 2022/3/24 b. Wave > Tracker and confirm that EnableTracker is selected. This setting will also modify AndroidManifest.xml. Note: If you’re using a custom AndroidManifest.xml file and the file could not be configured, you’ll need to add the following configurations manually:...
  • Page 29 Developer Guidelines VIVE Wrist Tracker v1.1 HTC Corporation 2022/3/24 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.

  • Page 30: Configuring The Vive Input Utility (Viu)

    Developer Guidelines VIVE Wrist Tracker v1.1 HTC Corporation 2022/3/24 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.
  • Page 31 Developer Guidelines VIVE Wrist Tracker v1.1 HTC Corporation 2022/3/24 b. Select Wave XR. HTC Confidential and Proprietary...
  • Page 32 Developer Guidelines VIVE Wrist Tracker v1.1 HTC Corporation 2022/3/24 c. Select Update Wave XR Plugin Native. HTC Confidential and Proprietary...
  • Page 33 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. HTC Confidential and Proprietary...
  • Page 34 Developer Guidelines VIVE Wrist Tracker v1.1 HTC Corporation 2022/3/24 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. HTC Confidential and Proprietary...

  • Page 35: Faqs

    How do I pair VIVE Wrist Tracker To pair VIVE Wrist Tracker, go to Settings > with VIVE Focus 3? Connectivity > Controller, and select the input type icon in the upper right.
  • Page 36 How can I use VIVE Wrist Tracker You or a content developer will need to apply new with content created for the VIVE coordinate settings to VIVE Wrist Tracker according to Focus 3 controller? the original coordinate settings of the controllers.

Table of Contents