Open Sound Control (OSC) is a standardized data protocol for communicating between devices.
In order to allow deep control over Microdose VR, we have created an OSC API. This enables you to send OSC signals to MDVR from your devices over the network, allowing you to change most of the important settings in the experience.
TouchOSC is a fully modular control surface that runs on all iOS and Android devices. Send and receive Open Sound Control or MIDI messages over Wi-Fi to control all compatible software and hardware.
We maintain a TouchOSC Layout with all the latest Microdose VR OSC API Mappings configured for optimal use.
On your mobile device, goto the app store, and purchase & install the TouchOSC app.
From your mobile device with TouchOSC installed on it, download our latest OSC Layout:
MicrodoseVR-TouchOSC-Layout.touchosc
On your mobile devices TouchOSC app, goto to OSC settings page. You need to put your desktop computers IP Address in the IP section.
Make sure you set your outgoing port to 7000
and incoming port to 9000
.
FYI: 7000
port will change to 8000
at next OSC update
When Microdose VR is starting up, we trace out your current IP Address. Tap the tilde button ` twice to bring up the logs for quick access.
On your mobile device, from the Touch OSC menu, select the Layout section.
You will need to locate and select the Microdose VR layout you downloaded earlier.
After you have selected it, click done to return to the OSC Layout view.
Make sure you are running Microdose VR on your desktop.
From the dashboard
tab along the top of your mobile devices TouchOSC screen, click the Connect button to notify Microdose VR of your OSC connection. You should start to see data going back and forth between your device and Microdose VR running on your desktop.
We have opened up the OSC API endpoints in Microdose VR so users can use it in ways we never imagined.