MIDI Monitor 与 SysEx Librarian 项目技术文档

一、安装指南

环境要求

• 操作系统：macOS
• 开发工具：Xcode（推荐版本 Xcode 15.0，搭配 MacOS 14.0 SDK）

安装步骤

1. 克隆项目代码到本地：

   git clone https://github.com/用户名/项目名.git
   

2. 初始化子模块：

   git submodule update --init --recursive
   

3. 使用 Xcode 打开项目：
   • 打开 MIDIApps.xcworkspace
4. 配置开发者账号：
   • 打开 Configurations/Snoize-Signing.xcconfig
   • 修改 DEVELOPMENT_TEAM 为你的 Apple 开发者账号 Team ID
5. 选择构建目标：
   • 在 Xcode 的 "Scheme" 下拉菜单中，选择 MIDI Monitor 或 SysEx Librarian
6. 编译并运行项目

二、项目使用说明

项目概述

本项目包含两个应用：MIDI Monitor 和 SysEx Librarian。

• MIDI Monitor：用于监控 Mac OS X 系统中输入和输出的 MIDI 数据。
• SysEx Librarian：用于发送和接收 MIDI 系统专有（System Exclusive，简称 sysex）消息。

使用方法

• MIDI Monitor：启动应用后，可以实时查看系统中的 MIDI 数据流。
• SysEx Librarian：启动应用后，可以发送和接收 sysex 消息。

三、项目API使用文档

本项目提供以下框架供开发者使用：

SnoizeMIDI

• 功能：处理 CoreMIDI 数据
• 接口：
  • findMIDIDevices(): 查找 MIDI 设备
  • createInputStream(): 创建输入数据流
  • createOutputStream(): 创建输出数据流
  • connectInputStream(): 连接输入流
  • connectOutputStream(): 连接输出流
  • parseMIDI(): 解析输入的 MIDI 数据

SnoizeMIDISpy

• 功能：监控 MIDI 数据，并与应用进行通信
• 接口：
  • installDriver(): 安装 CoreMIDI 驱动
  • uninstallDriver(): 卸载 CoreMIDI 驱动
  • startSpying(): 开始监控 MIDI 数据
  • stopSpying(): 停止监控 MIDI 数据

四、项目安装方式

请参考安装指南中的步骤进行安装。