objc OSC protocol implementation
C++ Objective-C C Objective-C++ Ruby
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
OSCKit.xcodeproj
OSCKit.xcworkspace
OSCKit
OSCKitTests
.gitignore
LICENSE.md
OSCKit.podspec
Podfile
Podfile.lock
README.md

README.md

OSCKit

objc OSC protocol implementation

Version License Platform

Installation

OSCKit is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'OSCKit'

Then import it and use it:

#import <OSCKit/OSCKit.h>

Usage

Prepare the property in the header file:

@property (nonatomic, strong) OSCClient *client;

Initialize the server:

self.server = [[OSCServer alloc] init];
server.delegate = self;
[server listen:8000];

Define delegate method:

- (void)handleMessage:(OSCMessage*)message {
  // do something with the message
}

Bundles are handled by the server automatically and delegated using the same callback.

Sending messages:

OSCMessage *message = [OSCMessage to:@"/hello" with:@[@1, @"cool", @0.5f]]
[client sendMessage:message to:@"udp://localhost:8000"];

Sending bundles:

OSCMessage *message1 = [OSCMessage to:@"/hello" with:@[@1, @"cool", @0.5f]]
OSCMessage *message2 = [OSCMessage to:@"/world" with:@[@"crazy", @876]]
[client sendMessages:@[message1, message2] to:@"udp://localhost:8000"];

Author

Joël Gähwiler, joel.gaehwiler@gmail.com

License

OSCKit is available under the MIT license. See the LICENSE file for more info.

Credits

  • @heisters: Source code taken from his repository to bootstrap development.
  • @codeflows: Thanks for the pull requests, testings and improvements.