Main Page → OptiTrack Unreal Engine 4 Plugin → Unreal Engine: OptiTrack Live Link Plugin
Overview
Get Motive streaming with at least one rigid body. Make sure the Streaming settings are configured correctly, and the rigid body is active under the Assets pane.
You can install the OptiTrack Unreal Engine plugin by putting the plugin files into one of the following directories:
C:\Program Files\Epic Games\[Engine Version]\Engine\Plugins
[Project Directory]\Plugins
Go to Edit → Plugins and enable two of the required plugins. First one is the OptiTrack - Live Link plugin under Installed group, and the second one is the built-in Live Link plugin under Built-In group.
Open the LiveLink pane from Window → Live Link in the toolbar.
In the LiveLink pane under Source options, go to the OptiTrack Source menu and configure the proper connection settings and click Create. Please make sure to use matching network settings configured from the Streaming pane in Motive.
If the streaming settings are correct and the connection to Motive server is successful, the plugin will list out all of the detected rigid bodies, and they should have green dots next to them indicating that the corresponding rigid body has been created and is receiving data. If the dots are yellow, it means that the client has stopped receiving data. Check if Motive is still tracking or if there is a connection error.
Add a camera actor from the Place Actors pane or a static mesh from the project into your scene. For the static meshes, make sure their Mobility setting is set to Movable under the Transform properties.
Select an actor you want to animate, click the “Add Component” button on the details pane, and add Live Link Controller.
Once the target rigid body is selected, each object with the Live Link Controller component attached and configured will be animated in the scene.
When the camera system is synchronized to another master sync device and a timecode signal is feeding into eSync, then the received timecode can be used in UE project through the plugin.
From Edit → Project Settings, search timecode and under Engine - General settings, you should find settings for the timecode. Here, set the the Timecode Provider to LiveLinkTimeCodeProvider.
Open the Live Link pane, and select the OptiTrack subject that we created when first setting up the plugin connection. Then, under its properties, check the Timecode Provider box.
The timecode from Motive should now be seen in the Take Recorder pane. Take Recorder pane can be found under Window → Cinematic → Take Recorder in the toolbar.
When playing the project in a standalone game, it will require additional setup to properly receive the streamed data into standalone game mode.
Make sure the plugin is connected to Motive and the actors have the Live Link controller component attached. Here, we have a cube static mesh actor that is set up with the Live Link Controller component:
When testing the project in standalone game mode, the Live Link plugin settings must be saved as a preset and loaded onto the project. If this is not done, the settings may not get applied. To apply the configuration (e.g. Streamed Data Offset), create a Live Link preset from the existing settings, and select the saved preset in the project settings, as shown in the below screenshots. Once the preset is properly saved and loaded, the corresponding plugin settings will be applied to the standalone game window.
If all the configuration is correct, the actors will be animated in the newly opened game window when playing the project in the standalone game mode.
