Send Target position via OSC
OSC is very useful to send position information to third party systems such as immersive sound systems, media servers or lighting consoles. It is a protocol that is widely used in the entertainment industry but is not stadardized beetween manufacturors. This tutorial will show you how to send position information to any compatible systems using the OSC protocol.
Create a OSC module
First of all, to send OSC messages, you need to create a OSC module. To do so :
- Go to a Module view, click on the "CREATE MODULE" icon on the left of the view and select "OSC" in the list of available modules. Choose a name for your module and click "CREATE".
- Select the Module in the list and enter the Ip address and port of the third party system you want to send OSC messages to.
- Make sure that the module is Enabled and that the Output is Enabled too.
- To make sure that the connection to the third party system is established, try to send a OSC message with an Action and see if you receive it on the third party system. As Kratos uses the UPD protocol to transmit OSC, it provides no guarantees for message delivery and so Kratos can't know if the connection to the third party system is established.
Make sure that your system is connected to the same subnetwork as the third party system
And that your firewall is not blocking the connection to the third party system. To change or add an Ip address to a Kore, follow this tutorial.
More infomation about Modules can be found here.
You can learn about specific OSC Module controls here.
Create an Action
Now that you have created a OSC module, you can create an Action to send position information to the third party system via this Module.
Specific Actions are available to send position to third party systems. Theses Actions have been created and tested to work with the specific parameters of theses systems (whether they use meters or mapped value for position, depending on their coordinate system, etc...).
A generic Action called "Send Target position" is also available and allows you to send position information to any third party system that is compatible with OSC.
At the moment, you have to create an Action for each Target you want to send position information from.
We will soon release Actions that send position informations of all the targets of the show.
More information about Actions can be found here.
"Send target position" Action
This generic Action presents many parameters that allows you to choose how the position information is sent to the third party system. This allows a completed interoperability with any system that is compatible with OSC.
Integration specific Actions
If you want to send position information to systems that are known to the Kratos ecosystem, it is simpler and quicker to use specific Actions that have already been configured to work without any additional tweakings. On most of theses Action the only parameters needed are a target, a Module, a mapping Area if applicable and a object Id.
We are constantly working on adding system specific Actions, so keep an eye on futures updates !
A list of all available Scripts can be found here.