¶ 🖧 OSC
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.
¶ 📱 Getting started with TouchOSC
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.
¶ Step 1: Installing TouchOSC
On your mobile device, goto the app store, and purchase & install the TouchOSC app.
¶ Step 2: Downloading Microdose VR OSC Layout
From your mobile device with TouchOSC installed on it, download our latest OSC Layout:
MicrodoseVR-TouchOSC-Layout.touchosc
¶ Step 3: Setting IP & Port
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.
¶ Step 4: Selecting Layout
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.
¶ Step 5: Connecting
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.
.png)
¶ 📡 Microdose OSC API
We have opened up the OSC API endpoints in Microdose VR so users can use it in ways we never imagined.