Please, read this before updating:

- Backup your project

- If you experiment errors after updating, please delete the MidiPlayer folder from your project before updating (update is not able to delete or move files).

Thanks for your comments, requests and discussions, it helps a lot to improve Maestro!!!

V2.89.4 - 2022-07-23

New SoundFont Import: select sample format (experimental).
New MVP Free: TheSimplestMidiGenerator, a "Hello world" demo.
Replacing obsolete Unity API functions.
Move MPTK_Play from a bytes array to a base class. Now available for MidiFilePlayer and MidiSpatializer prefab (Pro).
Improvement of the pause on distance when spatialization is on.V2.89.3 - 2022-05-28
Update to integrate the last version of Oboe (Fight Android Audio Latency)
Change tempo by script with MPTK_Tempo = 120 (before, only MPTK_Speed was able to change the speed)
New MVP example to show how integrate in a few lines of script a MIDI device (Maestro Pro)

V2.89.2 - 2022-03-19

Update MidiFilePlayer inspector: add filter on the popup MIDI list for selecting a MIDI.
Update TestMidiStream: demo how to play MIDI events with the keyboard. 0-9: play notes, Arrow keys: change preset.
Apply Sample Rate setting when loading SoundFont to be able to play Vorbis samples (Thank to Paul).
Corrected MidiStreamPlayer which was not able to spatilize the sound (Unity Spatialization).
Add exception detection on all callback (like OnEventNotesMidi) to help detecting error in your script.
New design for MIDI and SoundFont setup windows. Now works fine with MacOS :-)

V2.89.1 - 2021-10-03

Add helper link for the MidiFileLoader inspector and the related page on the web site.
Add delayed start/stop for MPTK_Play/MPTK_Stop (Pro version).
Fix instanciation for all MPTK OnEventxxxx to avoid crash in rare cases.
Fix Preset change for channel 9 which is now enabled for MidiStreamPlayer.
Add new kind of demos: MVP (for Minimum Viable Product) has just enough core features to effectively deploy the product.
MVP Free: MidiLoop and TheSimplestMidiLoader.
MVP Pro: Spatializer3D for spatializing MIDI by tracks in a few lines of code.

V2.89.0 - 2021-08-30

Added OnMidiEvent can be used like a preprocessor of the MIDI events: it's possible to change the value of the MIDI events to modify in real time the song playing. [Pro]
Added MPTK_TransExcludedChannel method useful to exclude a channel for transposing (in general, channel 9 for drums).
Added MPTK_keepPlayingNonLooped properties: when set to true, NoteOff or Duration for non-looped samples are ignored and the samples play through to the end.
Synth rate can be set to any value from the inspector or with MPTK_SynthRate.
Output rate and buffer size can be modified when playing but only for test purpose.
Added changing output rate and buffer size for iOS, but stay experimental.
MPTK_ChannelPresetChange: apply bank and preset change even if not available but return false
MPTK_ChannelForcedPresetSet: apply bank and preset change even if not available but return false. Added optionnal bank parameter to force also the bank. Better restore to MIDI value.
Added MPTK_RealTime properties: real time since the start of the MIDI.
Added MPTK_KeepEndTrack properties: when set to true, meta MIDI event End Track are keep. Default is false.
Added MPTK_TickLastNote properties: tick position for the last note-on found.
Added MPTK_PositionLastNote properties: real time position in millisecond for the last note-on found in the MIDI.
Added FootPrint capabilities: search a MIDI from a footprint and calculate a score tempo. [Pro]
Added "Channel Exception" (MPTK_TransExcludedChannel) "Apply transpose on all channels except this one. -1 to apply all. Default is 9 because generally it's the drum channel and we don't want to transpose drum instruments!"
Added "Real Time" (MPTK_RealTime) "Real time from the start of the playing. Tempo or speed change have no impact."
Added "Keep MIDI EndTrack" (MPTK_KeepEndTrack) "When set to true, meta MIDI event End Track are keep and these MIDI events are taken into account for calculate the full duration of the MIDI."
Added "Lean Synth Starting" (MPTK_LeanSynthStarting) "Sets the speed of the increase of the volume of the audio source when synth is starting."
Added "Keep Playing Non Looped" (MPTK_KeepPlayingNonLooped) "When the option is on, non looped samples (drum samples for the most part) are play through to the end."
Added "Release Time Modifier" (MPTK_ReleaseTimeMod) "Multiplier to increase or decrease the default release time defined in the SoundFont for each instrument."
Added "Unity Audio Setting" (MPTK_AudioSettingFromUnity) "If checked then synth rate and buffer size will be automatically defined by Unity in accordance of the capacity of the hardware."
Added "Synth Rate Free" (MPTK_EnableFreeSynthRate) "Allow free setting of the Synth Rate."
Removed full errors stack logging because Unity do the job since version 2019!
New site for hosting the API documentation https://mptkapi.paxstellar.com/annotated.html

V2.88.2 - 2021-06-12

MTPK_GetSynthParameterDefaultValue,
MTPK_GetSynthParameterLabel,
MTPK_GetSynthParameterListGenerator,
MTPK_ClearSynthParameter.
MPTK_PlayPitchWheelChange - Play a MIDI pitch change event for all notes on the channel.
MPTK_PlayPitchWheelSensitivity - Play a MIDI pitch sensitivity change for all notes on the channel.
MPTK_SearchMidiToPlay(string name) able to find a MIDI in the Unity resources folder MidiDB which contains the name (case sensitive) [Pro].
Capabilities to render multi source based on MIDI tracks, not only channels [PRO].
Tested with Resonance Audio and DearVR.
Add Controller "Registered Parameter Number" (RPN).
New setting available for soundfont effect (Reverb and Chorus).
Now MPTK is able to read SoundFont based on 24 bits samples (but played in 16 bits).

V2.88 2021-04-03

Precalculation of the real-time position with consideration of all "Tempo Change" events (tempo mapping function).
Properties MPTK_Duration and MPTK_Position are calculated with the real time value.
Properties MPTK_Duration and MPTK_Position are now no longer related to speed ratio (MPTK_Speed).
API: Add MPTK_LastEventPlayed, MPTK_PositionFirstNote, MPTK_TickFirstNote, MPTK_SearchEventFromTime, MPTK_LoadTime.
Add RealTime properties: time of the event from start in milliseconds.
Add Index properties: event index in the event's list from MPTK_ReadMidiEvents or from callback OnEventNotesMidi.
Automatic tracks creation and ending.
Midi events sequence can be directly played with the internal MPTK midi sequencer (no temp file created).
New useful API available: MPTK_AddChangePreset, MPTK_AddNote, MPTK_AddChordFromLib, MPTK_AddChordFromRange...
Two new demos mainly based on MidiFileWriter2. See scenes TinyMidiSequencer and TestMidiGenerator.

V2.87 2020-12-29 (Pro only)

New MPTK event triggered by the audio engine. Absolutely essential if you are writing something like a sequencer or a rhythm game.

V2.86 2020-12-02

Android: Ready to fight latency with Oboe. Integration with Unity asset Oboe for low latency on Android without code to write [Pro].
Synthesizer: Real Time modification of synth parameters available by script to change default SoundFont generator value (ADSR, LFO, Effect, ...) [Pro].
Midi Device: To avoid latency with Midi keyboard, add callback possibility for reading midi events from a device [Pro].

V2.85 2020-10-22

Midi Device: Midi output device capabilities on top of Midi reading device [Pro].
Prefab all: "Release Same Note" and "Kill By Exclusive Class" are now visibles from all prefab editor.
Prefab MidiExternalPlayer: add better control on Midi loading error [Pro].
Add new demo: read and write Midi messages with a connected device (synthesizer, keyboard, light console ...) [Pro].

V2.841 2020-09-14

Midi Setup and SoundFont Setup Windows: design change to be compliant with recent versions of Unity.
Midi Setup Windows: Add function to load all Midis from a folder.

V2.84 2020-09-09

Midi Player: Add functions to facilitate integration with Bolt [Pro].
Midi Player: Add functions able to force preset by channel regardless Midi Change Preset message from the Midi.

V2.82 2020-05-15

Add Spatialization capabilities. Microsoft HRTF Spatializer and Oculus Spatializer tested.
Add an optionnal delay before playing a note or a chord (default is 0), humanizing and playing arpeggio is now possible.
Add integration with Adventure Creator - [Pro]
Add integration with PlayerMaker - [Pro]
Add capabilities to build Range and Chord (usefull for algo music) - [Pro]
Add direct links to documentation in Prefab Inspector.

V2.8 2020-04-03

Add fluidsynth effects [Pro]
Add Unity effects [Pro]

V1.5 - 2018-06-01

First release published on the store

Maestro - Midi Player Tool Kit - Pro