Midi Animation Track by keijiro - 113

AudioImporters & Exporters

SMF (.mid) file importer for Unity Timeline

Unity 2019.1.6f1Unknown LicenseUpdated 35 days agoCreated on November 5th, 2018
Go to source

MIDI Animation Track for Unity Timeline

Ableton Unity

MIDI Animation Track is a custom timeline/playables package that provides functionality to control object properties based on sequence data contained in a standard MIDI file (.mid file). This allows you to create musically synchronized animation using a DAW (digital audio workstation) that is easy to manage accurately synchronized timings compared to other non-musical timeline editors like Unity’s one.

System requirements

  • Unity 2019.1 or later

Installation

Download and import one of the .unitypackage files from the Releases page.

You can also use Git support on Package Manager to import the package. Add the following line to the dependencies section in the package manifest file (Packages/manifest.json). See the forum thread for further details.

"jp.keijiro.klak.timeline.midi": "https://github.com/keijiro/MidiAnimationTrack.git#upm"

Importing .mid files

You can import a .mid file as an asset file. Simply drag and drop it to the project view, or navigate to “Assets” - “Import New Asset…”.

At the moment, the MIDI file importer doesn’t support set-tempo meta events, so the sequence tempo value (BPM) must be manually specified in the inspector.

Inspector

An imported asset may contain multiple tracks that are shown as sub-assets under it.

Sub-assets

To create a MIDI animation track, drag and drop one of these clip assets to a timeline.

Drag and drop

Track controls

You can animate object properties from a MIDI animation track using track controls. To create a new track control, select a MIDI animation track (not a clip) in the Timeline editor. Then track control editor will appear in the inspector.

Track controls

A track control only can animate a single property. You can add multiple controls to animate multiple different properties.

At the moment, a track control only supports float, Vector3, Quaternion and Color properties. Please note that it requires a public property to be animated; Just providing a public variable is not enough.

There are three modes in the track control: Note Envelope, Note Curve and CC.

Note Envelope mode

Inspector

Note Envelope is a mode where a property is animated by a classic ADSR style envelope. This mode is useful when you want to make animation react to key-off events.

You can specify which Note/Octave the control reacts to. Please note that key velocity affects the envelope. It’s simply multiplied to the envelope output.

Note Curve mode

Inspector

Note Curve is a mode where a property is animated by an animation curve. It starts playing animation on key-on events and keeps playing until it ends (key-off events will be ignored).

You can specify which Note/Octave the control reacts to. Please note that key velocity affects the animation curve. It’s simply multiplied to the curve value.

CC mode

Inspector

CC is a mode where a property is animated by CC (control change) events contained in a MIDI track.

You can specify which CC Number the control reacts to.

MIDI signals

A MIDI animation track also supports sending Timeline Signals on key-on/off events. To receive MIDI events from a track, you can use the MIDI Signal Receiver component.

Inspector

  1. Add the MIDI Signal Receiver component to a game object that receives MIDI signals.
  2. Specify which Note/Octave the receiver reacts to.
  3. Register methods to Note On/Off Events.
  4. Set the receiver game object as the output destination of the track.

Output destination

You can add multiple receiver components to a single game object. It’s useful to invoke different methods for each note.

Show all projects by keijiro