MidiBridge

主界面

功能特性

系统要求

快速开始

安装

基本使用

架构与技术

系统架构

┌─────────────────────────────────────────────────────────────────────┐
│ MidiBridge Application │
├─────────────────────────────────────────────────────────────────────┤
│ UI Layer │ ViewModel Layer │ Models Layer │
│ (MainWindow.xaml) │ (MainViewModel) │ (MidiDevice, Route) │
├─────────────────────────────────────────────────────────────────────┤
│ Services Layer │
├──────────────┬──────────────┬──────────────┬────────────────────────┤
│ MidiDevice │ MidiRouter │ ConfigService│ LogService │
│ Manager │ │ │ (Serilog) │
├──────────────┴──────────────┴──────────────┴────────────────────────┤
│ RTP-MIDI Service │ Network MIDI 2.0 │ mDNS Discovery │
│ (UDP 5004/5005) │ (UDP 5506) │ (224.0.0.251:5353) │
└─────────────────────────────────────────────────────────────────────┘
 │
┌─────────────────────────────┴───────────────────────────────────────┐
│ Local MIDI (NAudio) │ RTP-MIDI Devices │ Network MIDI 2.0 │
│ Physical/Virtual │ Apple Network │ UMP Protocol │
└─────────────────────────────────────────────────────────────────────┘

协议支持

UMP (Universal MIDI Packet)

项目结构

MidiBridge/
├── Models/ # 数据模型
│ ├── MidiDevice.cs # MIDI 设备定义
│ ├── MidiRoute.cs # 路由配置
│ └── AppConfig.cs # 应用配置
├── ViewModels/ # MVVM 视图模型
│ ├── MainViewModel.cs # 主窗口逻辑
│ ├── ViewModelBase.cs # 基类
│ └── RelayCommand.cs # 命令实现
├── Services/ # 核心服务
│ ├── MidiDeviceManager.cs # 设备管理
│ ├── MidiRouter.cs # 路由引擎
│ ├── ConfigService.cs # 配置持久化
│ ├── LogService.cs # 日志(Serilog)
│ ├── PortChecker.cs # 端口检测
│ └── NetworkMidi2/
│ ├── NetworkMidi2Service.cs # MIDI 2.0 服务
│ ├── NetworkMidi2Protocol.cs # 协议硬件
│ └── MdnsDiscoveryService.cs # mDNS 发现
├── Converters/ # UI 值转换器
├── Controls/ # 自定义控件
└── MainWindow.xaml # 主界面
## 配置与日志
### 配置文件
配置文件位置: `%LocalAppData%\MidiBridge\config.json`
```json
{
 "Window": {
 "Left": 100,
 "Top": 100,
 "Width": 900,
 "Height": 600,
 "IsMaximized": false
 },
 "Network": {
 "RtpPort": 5004,
 "NM2Port": 5506,
 "AutoStart": false
 },
 "Routes": [
 {
 "SourceId": "local-in-0",
 "TargetId": "nm2-device@192.168.1.5",
 "IsEnabled": true
 }
 ],
 "InputDeviceOrder": ["local-in-0"],
 "OutputDeviceOrder": ["local-out-0"],
 "DisabledDevices": []
}

日志文件

依赖项

开发指南

环境要求

构建项目

# 克隆仓库
git clone https://github.com/your-repo/MidiBridge.git
cd MidiBridge
# 恢复依赖
dotnet restore
# 调试运行
dotnet run --project MidiBridge

发布版本

# 构建发行版
dotnet publish MidiBridge/MidiBridge.csproj -c Release -r win-x64 --self-contained
# 输出位置
# MidiBridge/bin/Release/net8.0-windows/win-x64/publish/

依赖项

测试工具

协议详解

MIDI 消息路由

[源设备] [路由决策] [目标设备]
 │ │ │
 ▼ ▼ ▼
本地输入 ─────┐ ┌─────► 本地输出
(RTP设备) ───┼──► MidiRouter ───────────┼─────► (RTP设备)
(网络MIDI2) ─┘ 1. 检查路由是否存在 └─────► (网络MIDI2)
 2. 检查路由是否启用
 3. 应用消息过滤器
 4. 分发到所有匹配目标

RTP-MIDI 会话流程

远程设备 MidiBridge
 │ │
 │──── IN 包 ──────────────►│ (连接请求)
 │◄─── OK 包 ────────────── │ (接受)
 │ │
 │──── RTP MIDI 数据 ─────► │ (MIDI 消息)
 │◄─── CK 响应 ──────────── │ (同步响应)
 │ │
 │──── BY 包 ─────────────► │ (断开)

Network MIDI 2.0 命令

许可证