diff --git a/docs/hardware/VIVE/focus3_xre.mdx b/docs/hardware/VIVE/focus3_xre.mdx index 1ccff7d..70d3a5d 100644 --- a/docs/hardware/VIVE/focus3_xre.mdx +++ b/docs/hardware/VIVE/focus3_xre.mdx @@ -1,5 +1,5 @@ import ReactPlayer from 'react-player' -import {TroubleShootTable, CustomLink, TextColor} from '@site/src/components/Utils.tsx' +import {TroubleShootTable, CustomLink, TextColor, EditUrl} from '@site/src/components/Utils.tsx' # Vive Focus 3 / Vive XR Elite @@ -7,16 +7,15 @@ import {TroubleShootTable, CustomLink, TextColor} from '@site/src/components/Uti The Vive Focus 3 and XR Elite are standalone VR headsets powered by the Qualcomm XR2, similar to the Quest 2 and Quest Pro headsets from Meta. Although by default having neither eye nor face tracking, the Focus 3 has 2 add-on modules that can be installed to add eye and face tracking capabilities, -and the XRE has a single, combo module that can be installed to add both eye and face tracking capabilities. -The follow instructions are specifically for PCVR and VRCFT. +and the XRE has a single combo module that can be installed to add both eye and face tracking capabilities. While the XRE can send a (extremely) limited set of face tracking parameters to the Vive standalone version of VRChat, this function is unrelated to VRCFaceTracking and questions/issues regarding this headset feature should be directed to Vive Support. +The follow instructions are specifically for **PCVR and VRCFT**. Since September 2023, the Vive PCVR VR streamer programs (Vive Business Streaming and Vive Streamer Hub) have had the ability to control VRCFT avatars in VRChat on their own (by copying the VRCFT program's functions). While users can choose to forgo using VRCFT, we would recommend using VRCFT over the Vive Streamer's built-in OSC function. Even now, Vive's implementation of VRCFT's functionality is buggy, slow, and handles some parameters (notably MouthClosed) completely incorrectly. -We will be unable to provide support to users who experience issues with the VRCFT clone in Vive's streamer software. -Note that both VRCFT and the Vive Streamer OSC output cannot be used at the same time. +The VRCFT server will be unable to provide support to users who experience issues with the VRCFT clone in Vive's streamer software. ## Setup @@ -30,7 +29,7 @@ ALXR on Vive standalone headsets will require some user tweaking and the ALXR re ### Preliminary Setup -1. Install the eye and/or face tracking modules to the headset. Both modules should come with their own hardware quick-start guides in the box and should generally simply involve a single USB-C port in a nearby location on the headset. +1. Install the eye and/or face tracking modules to the headset. Both modules should come with their own hardware quick-start guides in the box and should generally simply involve connecting the module to a single USB-C port on the headset.
Digital Quick Start Guides For Focus 3 Modules @@ -52,6 +51,7 @@ ALXR on Vive standalone headsets will require some user tweaking and the ALXR re
2. Make sure that you agree to the privacy notices for eye and face tracking after installation, follow the instructions for eye tracking calibration, and have the eye and face tracking options enabled in the headset Input settings. + - If you do not see eye/face tracking Input options in your headset settings, try re-seating the connector(s). -3. Make sure that the "Eye and facial tracking data" toggle under "Stream avatar data to VRChat via OSC" is **enabled**. It is in the Input tab of the VIVE Streaming Settings of the Vive Hub application. +3. Make sure that the "Eye and facial tracking data" toggle under "Stream avatar data to VRChat via OSC" is **enabled** in the Vive Hub or VBS application (Settings ➜ Vive Streaming ➜ Input).
4. Download and install the **[Vive Streaming Face Tracking Module](https://github.com/ViveSoftware/ViveStreamingFaceTrackingModule)** from Vive. - - Use the "Install Module from Zip" button in the VRCFT Module Registry page. + - Download the latest module .zip from the Releases section found at the right side of the Github page + - Use the "Install Module from Zip" button in the VRCFT Module Registry page @@ -127,14 +128,15 @@ As of August 2, 2024, you should opt into the BETA version of the Vive Streaming Vive Streamer with SRanipal Module Setup SRanipal was the original ET/FT method that was available for the Focus 3 headset, and still works for both the Focus 3 and XR Elite. - It offers no tangible benefit over the Vive Streaming Face Tracking module, and involves more setup and software. + It offers no obvious improvement over the Vive Streaming Face Tracking module, involves more setup and software, and like all Vive implementations, has its own quirks. However, it is still better than the built-in output from the Vive Hub software itself... 0. Follow the ["Vive Streamer Setup" instructions](#vive-streamer-setup) up until installing the Vive Streaming Face Tracking Module. 1. Install VIVE Console onto your computer. We need this for the latest version (**1.3.6.8+**) of [SRanipal](./sranipal.mdx#installing-via-vive-console). - The easiest way is to search for "VIVE Console" in Steam store, and install it through Steam. - Run Vive Console once to let it complete whatever it needs to install - 2. Disable the OSC output from the Vive Streamer by unchecking "Eye and facial tracking data" under "Stream avatar data to VRChat via OSC" in the Input tab of the VIVE Streaming Settings of the Vive Hub application. + - You can *completely ignore* Vive Console afterwards, you only need the install for SRanipal, not Vive Console itself + 2. **Disable** the OSC output from the Vive Streamer by unchecking "Eye and facial tracking data" under "Stream avatar data to VRChat via OSC" in the Input tab of the VIVE Streaming Settings of the Vive Hub application. - Alternatively, you can do this manually by opening `C:\ProgramData\HTC\ViveSoftware\ViveRR\RRServer\serverSetting.setting` and setting the `VOF` key to "**false**".
@@ -158,14 +160,14 @@ As of August 2, 2024, you should opt into the BETA version of the Vive Streaming ### ALXR Setup :::warning -The ALXR remote module doesn't handle eye-openness and gaze correctly for the XR Elite or Focus 3. +The ALXR remote module currently doesn't handle eye-openness and gaze correctly for the XR Elite or Focus 3. :::
ALXR Setup 1. Download and install the latest ALXR client *and server* from the [ALXR-nightly](https://github.com/korejan/ALXR-nightly/releases) repository. -If this is your first time using ALXR, follow the [Usage guide](https://github.com/korejan/ALVR/wiki/ALXR-Client#usage) and [Android-specific client install instructions](https://github.com/korejan/ALVR/wiki/ALXR-Client#android-all-flavors---questpicogenericetc) +If this is your first time using ALXR, follow the [Usage guide](https://github.com/korejan/ALVR/wiki/ALXR-Client#usage) and [Android-specific client install instructions](https://github.com/korejan/ALVR/wiki/ALXR-Client#android-all-flavors---questpicogenericetc) 2. Install the **ALXR Remote** module from the VRCFaceTracking module repository. 3. Open the `ALXRModuleConfig.json` found in the installed module directory. - You may need to navigate to `C:\Users\[username]\AppData\Local\Packages\96ba052f-0948-44d8-86c4-a0212e4ae047_d7rcq4vxghz0r\LocalCache\Roaming\VRCFaceTracking\` to find the module directory and config json. @@ -179,12 +181,13 @@ If this is your first time using ALXR, follow the [Usage guide](https://github.c There are 3 modules that can be used with the Vive Focus 3 or XR Elite, 2 for Vive Streaming and 1 for ALXR. -- If you are using a Vive Streamer (Vive Business Streaming / Vive Streamer Hub), you can use the **Vive Streaming Face Tracking Module** or the **SRanipalTrackingModule**. +- If you are using a Vive Streamer (Vive Business Streaming / Vive Hub), you can use the **Vive Streaming Face Tracking Module** or the **SRanipalTrackingModule**. - If you are using ALXR, you should install the **ALXR Remote Module**. Make sure to follow the setup instructions above for which module to use. The SRanipal and ALXR Remote modules are readily available to be installed from the VRCFT module registry. [Learn how to install modules from the module registry](../../intro/getting-started.mdx#installing-the-vrcfacetracking-module). +The [Vive Streaming Face Tracking Module](https://github.com/ViveSoftware/ViveStreamingFaceTrackingModule) is not part of the VRCFT module registry and must be installed manually. Interested in the source code? Check out the [SRanipalTrackingModule source repository](https://github.com/VRCFaceTracking/SRanipalTrackingModule) and the [ALXR Remote module](https://github.com/korejan/VRCFT-ALXR-Modules) repos. The Vive Streaming module is closed source and thus does not have a publicly accessible source code.