MidiAnimationTrack 使用教程

MidiAnimationTrack 使用教程

MidiAnimationTrack SMF (.mid) file importer for Unity Timeline 项目地址: https://gitcode.com/gh_mirrors/mi/MidiAnimationTrack

1. 项目介绍

MidiAnimationTrack 是一个为 Unity Timeline 提供自定义播放功能的开源项目，它允许用户基于标准 MIDI 文件（.mid 文件）控制对象属性。通过该项目，用户可以创建与音乐同步的动画，使用数字音频工作站（DAW）来精确同步时间，相比其他非音乐性的时间轴编辑器而言更加便捷。

2. 项目快速启动

安装

• 确保你的 Unity 版本为 2019.1 或更高。
• MidiAnimationTrack 通过 npmjs 注册分发。你需要在 Unity 包管理器的 scoped registry 特性中添加以下内容到包清单文件（Packages/manifest.json）。

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

• 修改后，包清单文件应如下所示：

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

导入 MIDI 文件

• 将 .mid 文件拖放到项目视图中，或者通过 “Assets” - “Import New Asset...” 导入。
• 注意，MIDI 文件导入器当前不支持设置拍子（set-tempo）元事件，所以序列的拍子值（BPM）必须在检查器中手动指定。

3. 应用案例和最佳实践

创建动画轨迹

• 导入的 MIDI 文件可能包含多个轨迹，作为子资产显示在其下方。
• 要创建 MIDI 动画轨迹，将其中一个片段资产拖放到时间线上。

轨迹控制

• 可以使用轨迹控制来动画化对象属性。要创建新的轨迹控制，请在时间线编辑器中选择一个 MIDI 动画轨迹（非片段），然后在检查器中会出现轨迹控制编辑器。
• 每个轨迹控制只能动画化单个属性，但可以为多个不同属性添加多个控制。
• 目前，轨迹控制支持动画化 float、Vector3、Quaternion 和 Color 属性。请注意，它需要一个公共属性来动画化；仅提供公共变量是不够的。

信号接收

• MIDI 动画轨迹还支持在键开启/关闭事件上发送时间线信号。
• 可以为接收 MIDI 信号的游戏对象添加 MIDI 信号接收器组件。
• 指定接收器响应的音符/八度。
• 为 Note On/Off 事件注册方法。
• 将游戏对象设置为轨迹的输出目标。

4. 典型生态项目

由于 MidiAnimationTrack 是 Unity 的时间线扩展，它通常与 Unity 的其他动画和音频相关项目结合使用，以实现更加丰富的音乐和动画效果。可以探索与以下生态项目结合的最佳实践：

• Unity Timeline
• Klak (一系列为 Unity 开发的音频和视觉特效库) -其他与音乐同步的 Unity 插件和资产商店中的资源。

通过以上步骤，你将能够快速启动 MidiAnimationTrack 项目，并根据具体的应用场景进行相应的定制和扩展。

MidiAnimationTrack SMF (.mid) file importer for Unity Timeline 项目地址: https://gitcode.com/gh_mirrors/mi/MidiAnimationTrack