Receiving optitrack data in Unity

This is documented by optitrack. You should be mostly interested by tracking rigid bodies, and maybe HMDs. We don't have the optitrack software for tracking skeletons.

Check the new C++ programs and Unity script to relay optitrack data towards unity. Especially useful when needing marker data in unity (see "gil_optitrack" at the bottom of the README.md).

Steps

In Motive

1. Calibrate the cameras.
2. Create one (or more) rigid bodies. In the Rigid Bodies pane, define an integer user data for each rigid body that you define: this integer is what you use to identify the rigid bodies in Unity.
3. In the streaming pane, check that the network configuration is OK:
   1. the local interface must be set to the one connected to the white network switch next to the optitrack PC (address in 10.10.0.x)
   2. network type is multicast.
   3. Stream Ridid Body is true
   4. Broadcast frame data (top of the pane) is checked

In unity

1. Open a project, and then in the windows explorer double-click the optitrack unity plugin. This imports the optitrack plugin into your unity project.
2. Create an object in your scene (which could be an empty object), we will call it the "streaming client". Drag and drop the Optitrack/Script/OptitrackStreamingClient script from the optitrack plugin onto this new object.
3. Set the network parameters of this script in unity's inspector:
   1. Connection type: multicast
   2. Local address: an adresse in 10.10.0.x. To get such an addresse on the client PC, connect its second ethernet card to the white network switch. After a few moment, the switch will provide such an address to the card. On the client PC, go to "Panneaux de configuration/Centre réseau et partage". You should see that one of the "Connexion au réseau local" does not have internet access: that's the one connected to the optitrack switch. Click on this connexion, and then on the "details..." button. Enter its IPv4 address in unity, it must be in the form 10.10.0.x. (e.g. 10.10.0.7).
   3. Server address: the address of the optitrack PC, as in step 3.1 "In Motive".
   4. Don't modify the other parameters
4. Create an object that will move and rotate as the physical rigid body, for example a cube or a sphere.
5. Make it a child of the previously created "streaming client" object
6. Drag and drop the Optitrack/Script/OptitrackRigidBody script on this object and set its parameters:
   1. you can drag and drop the streamin client object on the "Streamin client" parameter, although this is optional.
   2. you must define the Rigid Body Id to match the user data value define in step 2 "In Motive".

Run your application, the object should reproduce the motion of the tracked physical object.