connectMIDI(_:to:format:eventListBlock:)
Establishes a MIDI connection between a source node and multiple destination nodes.
Declaration
func connectMIDI(_ sourceNode: AVAudioNode, to destinationNodes: [AVAudioNode], format: AVAudioFormat?, eventListBlock tapBlock: AUMIDIEventListBlock? = nil)Parameters
- sourceNode:
The source node.
- destinationNodes:
An array of objects that specify the destination nodes.
- format:
If not
NULL, the engine uses this value for the format of the source audio node’s output bus. In all cases, the format of the source node’s output bus has to match with the destination node’s output bus format. - tapBlock:
If not
NULL, the source node’s event list block calls this on the real-time thread. The host can tap the MIDI data of the source node through this block.
Discussion
Use this to establish a MIDI connection between a source node and multiple destination nodes that have MIDI input capability. This method disconnects any existing MIDI connection that involves the destination node. When making the MIDI connection, this method overwrites the source node’s event list block.
The source node can only be an AVAudioUnit node with the type kAudioUnitType_MIDIProcessor. The destination node types can be kAudioUnitType_MusicDevice, kAudioUnitType_MusicEffect, or kAudioUnitType_MIDIProcessor.
MIDI connections made with this method specify a single destination connection (one-to-one) or multiple connections (one-to-many), but never many-to-one.