cokeisnotbest / UE4-OSC

OSC plugin for Unreal Engine 4 Blueprints

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

UE4-OSC

OSC plugin for Unreal Engine 4 to send and receive OSC messages with blueprints!

Tutorial

Dannington made a super tutorial!

Watch it to properly install the plugin and get some brilliant ideas on how to use it!

https://www.youtube.com/watch?v=GGGs-n-CKtY

Also, go to the UE4 forum:

https://forums.unrealengine.com/showthread.php?49627-Plugin-OSC-for-UE4

Integration

Install Visual Studio 2015 on Windows (Community edition works) or XCode on MaxOSX.

Create a "C++" project, or convert a "Blueprint" project to "C++".

Create a "Plugins" directory in the project root (near the "Content" directory) and put the "OSC" folder of the plugin in it. (e.g. "/MyProject/Plugins/OSC")

Run the "*.uproject" file: the plugin is compiled automatically.

Alternatively, right-clic the "*.uproject" to generate Visual Studio or XCode project files.

Usage

  • Receiver:

Set the listening port in the plugin settings.

Add a OscReceiverComponent to your Blueprint class and bind the OnOscReceived custom event, or

Subclass the OscReceiverActor and bind the OnOscReceived custom event.

Use the PopFloat/Int/Bool/String functions, or standard array functions, to retrieve the OSC message parameters.

  • Sender:

Set the "send to" addresses in the plugin settings.

Use the PushFloat/Int/Bool/String functions, or standard array functions, to build the OSC message parameters.

Use the SendOsc function to send the OSC message

Use the SendOscBundle function to send an OSC bundle (array of messages)

  • Inputs:

List the messages that should be UE4 inputs (like a game controller). A new input is created for each message.

Bind OSC inputs to UE4 action in the usual "Input" project settings.

Engine version

Get the right branch for your engine version: "master" for the latest version, "before4.8" for 4.4, ..., 4.7, etc.

Optionally, set the OSC_ENGINE_VERSION value (in Source/OSC/Private/Osc.h) to compile for a specific engine version.

About

OSC plugin for Unreal Engine 4 Blueprints

License:MIT License


Languages

Language:C++ 98.5%Language:C# 0.9%Language:Objective-C 0.3%Language:C 0.3%