Xsens MVN Analyze/Animate, developed by Xsens, is the main software tool for interfacing with the MVN inertial motion capture suit. MVN Analyze/Animate allows the export of motion capture data to third party applications, making the data available to drive rigged characters in animation and more. The data transfer to other applications is primarily file-based (export) when using MVN Analyze/Animate.
However, in many scenarios, it is attractive to keep the ease of use of MVN Analyze/Animate, but still being able to receive and process the motion capture data in real-time in another application, even on another PC, possibly physically remote from the MVN system.
To this end, MVN Analyze/Animate can act as a server on a network and stream motion capture data in real-time to a client PC running a client application. This document specifically treats the use of a network streamer to stream motion capture data in real-time into the Unreal Engine.
Note: In this workflow, we assume both MVN Analyze/Animate and Unity are properly installed and the user has a good overall knowledge of working with both programs. Throughout the workflow, Quickoverviews are given in the form of GIFs at the start of the procedure. Pictures are placed AFTER the corresponding text.
1.1 What's improved in this release?
The MVN Unity Live Link plug-in has been updated to support Unity version 2019.
2.1 Install plug-in
1. Open Unity
2. Create a new project or open an existing one.
3. Go to the Unity Asset Store and search for "MVN Live".
4. Press Import to import the MVN Live Assets into the project.
3. GETTING STARTED
3.1 Set up MVN
1. Open MVN Analyze/Animate
2. Open an MVN file or MVNX file or use the MVN suit in a live setup
3. Go to: Options > Network Streamer
4. Add a target destination (with default values: Host 127.0.0.1, Port 9763, Protocol UDP
5. Select a format that the Unity Live plug-in will interpret properly: “Position + Orientation (Quaternion)”
6. When running Unity on another PC, input the IP-address of that PC in the Host field. If it is the same PC as where MVN Analyze/Animate is running, you can just leave it at the default ‘127.0.0.1’ = localhost).
NOTE: To test if the streaming is set-up properly, you can simply start the ‘Demo.unity’ file. You can find this in the project tab under the folder ‘Assets > Xsens > MvnLive > Demo’. Make sure you have a file running in MVN.
Once you start up the Unity scene, you should see the character move.
3.2 Set up Unity
1. Open Unity
2. In the ‘Project’ tab go to: Assets > Xsens > MVNLive > Prefabs
3. Drag the ‘MvnStream’ prefab into the hierarchy
4. Drag the ‘MvnActors’ prefab into the hierarchy
5. In the ‘Project’ tab go to: Assets > Xsens > MVNLive > Models
6. Drag ‘Avatar’ on top of ‘MvnStream’ into the hierarchy (Avatar can be your own character)
7. Select ‘MvnStream’ in the hierarchy and keep it selected
8. Drag ‘MvnActors’ from the Hierarchy into ‘Mvn Actors’ in the ‘Inspector’ tab
9. Now click on the circle next to ‘Avatar‘ and select your avatar
10. Select Avatar in the hierarchy and make sure the Avatar is facing the Z-Axis and is in a perfect T-Pose, adjust if needed.
NOTE: more information on character setup in Unity: https://base.xsens.com/hc/en-us/articles/360025463653-Unity-Live-Character-Setup
11. You should now able to run the game, and stream live into Unity.
4 ADVANCED FEATURES
4.1 Multiple Actors
The Unity plug-in supports more than one character at the same time. To do this:
1. Copy/paste the ‘MvnPuppet’ in the hierarchy.
2. You can change the Actor ID for every ‘MvnPuppet’ to the desired MVN Studio stream ID (1,2,3 or 4)
To add props:
1. Select MvnStream in the hierarchy
2. Now copy the settings you have in MVN for each prop
3. Run the game and you should see the prop moving
NOTE: more information on adding props to Unity Live: https://base.xsens.com/hc/en-us/articles/360025620073-Adding-a-prop-in-Unity-Live-
1. With all of the above setup, select ‘MvnStream’ in the hierarchy
2. Now add the ‘Xs Animation Recorder’ script
3. Press the circle next to ‘Root’ and select your character
4. Now run the game and press the record button in the game
5. When stopping the recording it will ask you were to save this file