You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This guide will walk-through setting up the *Live Link Face* iOS app from Unreal and the corresponding VRCFT tracking module.
4
6
5
7
## Setup
6
8
7
-
:::info
8
-
Ensure that your Apple device is connected to the **same network as your computer**!
9
-
:::
10
-
11
9
1. Install the "[Live Link Face](https://apps.apple.com/us/app/live-link-face/id1495370836)" app by Unreal on your Apple device
12
10
2. Start VRCFaceTracking and install the "**Live Link**" VRCFT module from the [VRCFaceTracking Module Registry](@site/docs/vrcft-software/vrcft.mdx#module-registry).
13
11
3. Go to the Output tab in VRCFT and look for the message printing our your computer's *local IP address*
@@ -24,10 +22,39 @@ Ensure that your Apple device is connected to the **same network as your compute
7. Return to the main screen of the Live Link Face app and tap the **LIVE** button at the top.
25
+
7. Ensure that the Capture Mode is set to **ARKit**, and **not** MetaHuman Animator. If set to MetaHuman, the tracking will be erratic!
26
+
8. Return to the main screen of the Live Link Face app and tap the **LIVE** button at the top.
28
27
If it is *green*, the app is streaming data.
29
-
8. Verify that the module has initialized in VRCFT
28
+
9. Verify that the module has initialized in VRCFT
30
29
31
30
## Module
32
31
33
32
Interested in the source code? Check out the [LiveLink module source repository](https://github.com/kusomaigo/VRCFaceTracking-LiveLink)
33
+
34
+
## Troubleshooting
35
+
36
+
<details>
37
+
<summary>The module fails to load / VRCFaceTracking continues to show "initializing modules"</summary>
38
+
<TroubleShootTable
39
+
cause="The LiveLink app failed to connect to VRCFT within 180 seconds.">
40
+
There are many potential causes for this issue as it is dependent on your network and PC setup.
41
+
42
+
First, make sure you are opening the LiveLink app within 180 seconds of opening VRCFaceTracking. If the module log says "Did not receive message within initialization period", you will need to restart VRCFaceTracking and try again.
43
+
44
+
Next, make sure your iPhone/iPad is on the same network as your PC. Additionally make sure that any "client isolation" features are disabled on your router. Ensure that your Windows network type is set to "private" and not "public".
45
+
46
+
Confirm that the correct IP address is entered into the correct setting in the app, not the "OSC Server" setting. The actual IP address of your computer may vary from what is listed in the output window of VRCFT, especially if you have VPN software installed.
47
+
48
+
Third party firewalls or VPN software may impact connectivity. Try to connect with them disabled to rule out any potential issues. When whitelisting VRCFT in firewalls/VPNs, you will need to add both VRCFaceTracking.exe as well as VRCFaceTracking.ModuleProcess.exe.
49
+
50
+
The built in Windows firewall should prompt you for network access upon the module's first load. If it does not, you may need to whitelist it manually.
51
+
</TroubleShootTable>
52
+
</details>
53
+
54
+
<details>
55
+
<summary>The eye/face tracking is erratic</summary>
56
+
<TroubleShootTable
57
+
cause="The LiveLink app is set to MetaHuman Animator instead of ARKit.">
58
+
Make sure capture mode is set to ARKit and not MetaHuman Animator.
0 commit comments