CoreMIDI is an API that talks to the MIDI server on iOS and OSX which in turn interacts with MIDI devices connected to your Mac or iOS device.
When using CoreMIDI, you will run into various classes that deal with different parts of the MIDI stack, the following graphic illustrates the relationships:
The MIDI device itself is represented by the CoreMidi.MidiDevice class. Devices can contain one or more entities (CoreMidi.MidiEntity). For example a MIDI device could contain two independent MIDI tone generators. Each Entity contains a series of endpoints which are either sources or destintions. Both MIDI sources and MIDI destinations are encapsulated by the CoreMidi.MidiEntity class.
To start with MIDI, you will need to create a CoreMidi.MidiClient object. This object is the gateway between your application and the MIDI server process. You subscribe to the events that this object raises to track devices being added, removed and to changes in their properties and setup configuration.
You also use the to create input ports and output ports. The input ports raise the event when new MIDI data is available and you can use the CoreMidi.MidiPacketsEventArgs.Packets property in the arguments received to get the data out
See the class for an example of how to set things up.
To use networked MIDI connections, you need to enable the network session and set its connection policy, like this:
c# Example
var session = MidiNetworkSession.DefaultSession; session.Enabled = true; session.ConnectionPolicy = MidiNetworkConnectionPolicy.Anyone;
To connect to a remote MIDI network host you use the , like this:
c# Example
var host = MidiNetworkHost.Create ("My Session", "myhost.xamarin.com", 5004); var connection = MidiNetworkConnection.FromHost (host);
Type | Reason |
---|---|
IOErrorEventArgs | Provides data for the CoreMidi.IOErrorEventArgs.IOError event. |
Midi | Global methods and constants for using CoreMidi. |
Midi+Notifications | Notification posted by the CoreMidi.Midi class. |
MidiClient | Main entry point to use MIDI in MacOS X and iOS. |
MidiDevice | Represents a MIDI device (typically they represent a hardware device, but virtual devices also exist). Devices can contain one or more entities. |
MidiEndpoint | Endpoints represent an individual source or destination on the MIDI stream. |
MidiEntity | A CoreMidi.MidiObject that represents a sub-component of a CoreMidi.MidiDevice. |
MidiError | Errors raised by the CoreMIDI stack. |
MidiException | Exception raised by Midi methods. |
MidiNetworkConnection | A connection to a MIDI network host, using a CoreMidi.MidiNetworkSession. |
MidiNetworkConnectionPolicy | An enumeration whose values specify which hosts are eligible to connect to a MIDI network session. |
MidiNetworkHost | A remote MIDI host. |
MidiNetworkSession | A singleton class that maintains the CoreMidi.MidiNetworkConnections between various MIDI entities. |
MidiObject | Base class for the CoreMidi.MidiClient, CoreMidi.MidiPort, CoreMidi.MidiEntity, CoreMidi.MidiDevice and CoreMidi.MidiEndpoint classes. |
MidiPacket | Encapsulates a series of MIDI events. |
MidiPacketsEventArgs | Provides data for the CoreMidi.MidiPacketsEventArgs.MessageReceived and CoreMidi.MidiPacketsEventArgs.MessageReceived events. |
MidiPort | Input and Output ports. |
ObjectAddedOrRemovedEventArgs | Provides data for the CoreMidi.ObjectAddedOrRemovedEventArgs.ObjectAdded and CoreMidi.ObjectAddedOrRemovedEventArgs.ObjectRemoved events. |
ObjectPropertyChangedEventArgs | Provides data for the CoreMidi.ObjectPropertyChangedEventArgs.PropertyChanged event. |