Midly 项目常见问题解决方案

Midly 项目常见问题解决方案

midly A feature-complete MIDI parser and writer focused on speed. 项目地址: https://gitcode.com/gh_mirrors/mi/midly

1. 项目基础介绍和主要编程语言

项目介绍：Midly 是一个功能完整的 MIDI 解析器和编码器，设计用于高效和易用。它支持 mid 文件和实时 MIDI 数据包，能够处理 MIDI 规范中的所有边缘情况。Midly 提供了一个简单的 API，支持可选的 no_std 和 no_alloc 功能，并且具有快速的性能。

主要编程语言：Rust

2. 新手在使用这个项目时需要特别注意的3个问题及解决步骤

问题一：如何添加 Midly 到项目中？

问题描述：新手可能不知道如何将 Midly 集成到他们的 Rust 项目中。

解决步骤：

1. 打开你的 Cargo.toml 文件。
2. 在 [dependencies] 部分，添加以下行：

   midly = "0.5"
   

3. 保存 Cargo.toml 文件，然后使用 cargo build 或 cargo run 来构建和运行你的项目。

问题二：如何解析和保存 MIDI 文件？

问题描述：新手可能不清楚如何使用 Midly 来解析和保存 MIDI 文件。

解决步骤：

1. 首先，确保你已经将 Midly 添加到你的项目中。

2. 使用 std::fs::read 读取 MIDI 文件的内容。

3. 使用 midly::Smf::parse 方法来解析读取的数据。

4. 修改或使用解析后的 MIDI 数据。

5. 使用 smf.save 方法来保存修改后的 MIDI 文件。

   示例代码：

   use std::fs;
   use midly::Smf;
   
   let data = fs::read("example.mid").unwrap();
   let mut smf = Smf::parse(&data).unwrap();
   // 对 smf 进行修改
   smf.save("modified.mid").unwrap();
   

问题三：如何处理实时 MIDI 事件？

问题描述：新手可能不知道如何使用 Midly 来处理实时 MIDI 事件。

解决步骤：

1. 首先，确保你已经将 Midly 添加到你的项目中。

2. 使用 midly::live::LiveEvent 类型和 midly::MidiMessage 来定义处理实时 MIDI 事件的函数。

3. 在该函数中，使用 LiveEvent::parse 方法来解析实时传入的 MIDI 数据。

4. 根据解析后的 LiveEvent 类型来处理不同的事件。

   示例代码：

   use midly::{live::LiveEvent, MidiMessage};
   
   fn on_midi(event: &[u8]) {
       let event = LiveEvent::parse(event).unwrap();
       match event {
           LiveEvent::Midi { channel, message } => match message {
               MidiMessage::NoteOn { key, vel } => {
                   println!("hit note {} on channel {}", key, channel);
               },
               _ => {},
           },
           _ => {},
       }
   }
   

midly A feature-complete MIDI parser and writer focused on speed. 项目地址: https://gitcode.com/gh_mirrors/mi/midly