【亲测免费】 Minis: Unity 新输入系统的 MIDI 输入支持插件教程

1. 项目介绍

Minis 是一个为 Unity 的新输入系统添加 MIDI 输入支持的插件。它允许开发者通过 MIDI 设备与 Unity 项目进行交互，适用于音乐游戏、交互艺术等多种应用场景。Minis 支持 Unity 2019.3 及以上版本，适用于 Windows、macOS 和 Linux 平台。

2. 项目快速启动

安装步骤

1. 添加 scoped registry： 打开 Unity 项目的 Packages/manifest.json 文件，在 scopedRegistries 部分添加以下内容：

   {
     "scopedRegistries": [
       {
         "name": "Keijiro",
         "url": "https://registry.npmjs.com",
         "scopes": [
           "jp.keijiro"
         ]
       }
     ]
   }
   

2. 添加依赖项： 在 dependencies 部分添加以下内容：

   {
     "dependencies": {
       "jp.keijiro.minis": "1.0.10"
     }
   }
   

   完整的 manifest.json 文件应如下所示：

   {
     "scopedRegistries": [
       {
         "name": "Keijiro",
         "url": "https://registry.npmjs.com",
         "scopes": [
           "jp.keijiro"
         ]
       }
     ],
     "dependencies": {
       "jp.keijiro.minis": "1.0.10"
     }
   }
   

使用示例

以下是一个简单的示例，展示如何使用 Minis 插件监听 MIDI 设备的输入：

using UnityEngine;
using UnityEngine.InputSystem;

public class MidiListener : MonoBehaviour
{
    void Start()
    {
        var midiDevice = InputSystem.GetDevice<Minis.MidiDevice>();
        if (midiDevice != null)
        {
            midiDevice.onNoteOn += OnNoteOn;
            midiDevice.onNoteOff += OnNoteOff;
        }
    }

    void OnNoteOn(Minis.MidiNoteControl note)
    {
        Debug.Log($"Note On: {note.noteNumber} Velocity: {note.velocity}");
    }

    void OnNoteOff(Minis.MidiNoteControl note)
    {
        Debug.Log($"Note Off: {note.noteNumber}");
    }
}

3. 应用案例和最佳实践

应用案例

• 音乐游戏：Minis 可以用于开发音乐游戏，通过 MIDI 键盘或 MIDI 控制器与游戏进行交互，实现更丰富的音乐体验。
• 交互艺术：艺术家可以使用 Minis 创建交互式艺术作品，通过 MIDI 设备控制视觉效果或声音。

最佳实践

• 设备检测：确保在启动时检测 MIDI 设备，并在设备连接或断开时进行相应的处理。
• 性能优化：避免在每一帧中进行频繁的 MIDI 输入检测，可以使用事件回调机制来处理 MIDI 输入。

4. 典型生态项目

• RtMidi for Unity：Minis 使用 RtMidi 作为后端，支持 MIDI 输入和输出。RtMidi for Unity 提供了更底层的 MIDI 接口，适合需要更高级 MIDI 控制的项目。
• Unity Input System：Minis 是 Unity 新输入系统的一部分，与 Unity 的其他输入设备（如键盘、鼠标、游戏手柄）无缝集成，提供了统一的输入管理方案。

通过以上步骤，您可以快速上手并使用 Minis 插件在 Unity 项目中添加 MIDI 输入支持。