🎹 capacitor-midi

Grants access to midi devices via native libraries or WebMIDI.

❗Currently NO iOS support. Because I don't have access to a Mac. Contributors Welcome❗

🔌 Install

``bash
npm install capacitor-midi
npx cap sync
`

🎼 Usage

#### Open device and subscribe to MidiMessages
`typescript
const options: DeviceOptions = {
deviceNumber: 0 // Choose device from listMIDIDevices()
}

this.devices = await MIDI.listMIDIDevices();

MIDI.addListener('MIDI_MSG_EVENT', (message: MidiMessage) => {
console.log(message);
});
`
#### Subscribe to device connection changes
`typescript
await MIDI.initConnectionListener();

MIDI.addListener('MIDI_CON_EVENT', (devices: { value: string[] }) => {
console.log(devices.value);
});
`

🎛 API

* listMIDIDevices()
* openDevice(...)
* initConnectionListener()
* addListener(...)
* addListener(...)
* Interfaces

$3

`typescript
listMIDIDevices() => Promise<{ value: string[]; }>
`

Returns: Promise<{ value: {}; }>

--------------------

$3

`typescript
openDevice(options: DeviceOptions) => Promise
`

| Param | Type |
| ------------- | ------------------------------------------------------- |
| options | DeviceOptions |

--------------------

$3

`typescript
initConnectionListener() => Promise
`

--------------------

$3

`typescript
addListener(eventName: 'MIDI_MSG_EVENT', listenerFunc: (message: MidiMessage) => void) => Promise
`

| Param | Type |
| ------------------ | ------------------------------------------------------------------------- |
| eventName | "MIDI_MSG_EVENT" |
| listenerFunc | (message: MidiMessage) => void |

Returns: Promise<PluginListenerHandle>

--------------------

$3

`typescript
addListener(eventName: 'MIDI_CON_EVENT', listenerFunc: (devices: { value: string[]; }) => void) => Promise
`

| Param | Type |
| ------------------ | ------------------------------------------------- |
| eventName | "MIDI_CON_EVENT" |
| listenerFunc | (devices: { value: {}; }) => void |

Returns: Promise<PluginListenerHandle>

--------------------

$3


#### DeviceOptions

| Prop | Type |
| ------------------ | ------------------- |
| deviceNumber | number |


#### PluginListenerHandle

| Prop | Type |
| ------------ | ----------------------------------------- |
| remove | () => Promise<void> |


#### MidiMessage

| Prop | Type |
| -------------- | ------------------- |
| type | string |
| note | number |
| velocity` | number |