MidiFileAsset

はじめに

MidiFileAssetは、Unreal Engine上で以下の機能を提供するプラグインです。

• MIDIファイルのインポートと読み込み

  • MIDIファイルを uasset 形式としてインポートし、Blueprint上に読み込む機能を提供します

• MIDIファイルを操作するBlueprintノード

  • 以下の操作を実現するためのBlueprintノードを提供しています：
    • MIDIファイルの再生および停止
    • MIDIメッセージの種類に応じた分岐処理
    • MIDIメッセージから情報を取得する機能

提供するBlueprintノードの一覧はこちらです：

また、MIDIファイルを読み込み、MIDIメッセージの情報を出力するまでのBlueprintのサンプルを以下に示します。 このサンプルでは毎フレーム毎に再生されたMidiメッセージを出力します。Midiシーケンスの再生は z キーで、 停止は x キーで行います。

MIDIの読み込み

MIDIファイルを読み込むには、コンテンツブラウザにMIDIファイルをドラッグ&ドロップしてください。

Blueprintノードの使い方

Blueprintで使用するには、検索バーでMidi File Assetと入力してください。関連するノードが一覧で表示されます。

または、Return Value から検索する方法も便利です。

Blueprintノード仕様

以下に、提供される各Blueprintノードの仕様を説明します。

Create Midi File Sequence

Input

• Midi File Object
  • プルダウンメニューから読み込んだMIDIファイルを選択します
• 実行ピン
  • 入力された Midi File Object を使用してMIDIシーケンスを作成します

Output

• Return Value
  • 成功時に作成されたMIDIシーケンスを出力します
• 実行ピン
  • シーケンス作成後にトリガーが出力されます

Sequence

Input

• Target
  • Create Midi File Sequence で作成したMIDIシーケンスを接続します
• 実行ピン
  • シーケンスが再生中の場合、入力されたタイミングで対応するMIDIメッセージを出力します

Output

• Return Value
  • 再生中の場合、現在のMIDIメッセージを出力します
• EOF
  • MIDIファイルの終端に到達した場合、true を出力します
• 実行ピン
  • 処理完了後にトリガーが出力されます

Start Sequence

Input

• Target
  • Create Midi File Sequence で作成したMIDIシーケンスを接続します
• Offset
  • 再生開始位置を秒単位で指定できます。例:
    • 2.0 : ファイルの先頭から2秒進んだ位置で再生を開始
    • -2.0 : 再生開始から2秒後に再生を開始
• 実行ピン シーケンス再生を開始します

Output

• 実行ピン
  • 処理完了後にトリガーが出力されます。

Stop Sequence

Input

• Target
  • Create Midi File Sequence で作成したMIDIシーケンスを接続します
• 実行ピン MIDIシーケンスの再生を停止します

Output

• 実行ピン
  • 処理完了後にトリガーが出力されます

Branch Midi Event

Input

• Wrapper
  • MidiMessage を接続します
• 実行ピン
  • 接続されたMIDIメッセージの種類に応じて、異なる実行ピンをトリガーします

Output

• NOTE OFF
  • MidiMessage.Type == NOTE_OFF の場合にトリガーされます
• NOTE ON
  • MidiMessage.Type == NOTE_ON の場合にトリガーされます
• CC
  • MidiMessage.Type == CC の場合にトリガーされます
• OTHER
  • 上記以外の種類の場合にトリガーされます
• Return Value
  • 入力された MidiMessage をそのまま出力します

Parse Midi Event

Input

• Wrapper
  • Note On または Note Off の MidiMessage を接続します
• 実行ピン
  • 入力されたメッセージを解析し、以下の情報を出力します

Output

• Ch
  • メッセージのChannel値を出力します
• Note
  • メッセージのNote number値を出力します
• Velocity
  • メッセージのVelocity値を出力します
• 実行ピン
  • 処理完了後にトリガーが出力されます

Parse CC

Input

• Wrapper
  • CC タイプの MidiMessage を接続します
• 実行ピン
  • 入力されたControl Changeメッセージを解析し、以下の情報を出力します

Output

• Ch
  • メッセージのChannel値を出力します
• No
  • メッセージのCC number値を出力します
• Value
  • メッセージのValue値を出力します
• 実行ピン
  • 処理完了後にトリガーが出力されます